S3 personnalisé dans Adapty Attribution
L’intégration d’Adapty Attribution avec un stockage compatible S3 personnalisé vous permet de stocker les données de campagne d’acquisition utilisateur en toute sécurité dans votre propre solution de stockage compatible S3. Vous pourrez enregistrer vos données de performance de campagne, vos données d’attribution et vos événements d’acquisition utilisateur dans votre bucket S3 personnalisé sous forme de fichiers .csv. Pour configurer cette intégration, vous devrez suivre quelques étapes simples dans la console de votre stockage compatible S3 et dans l’Adapty Attribution dashboard.
Adapty Attribution exporte un ensemble de fichiers par jour calendaire. Le planificateur d’export s’exécute trois fois par jour — à 02:00, 04:00 et 06:00 UTC. Chaque exécution crée le job d’export du jour précédent s’il n’existe pas encore, ou le relance en cas d’échec d’une exécution antérieure. Vos données sont donc généralement disponibles après l’exécution de 02:00 ; les exécutions suivantes servent à récupérer d’éventuelles erreurs plutôt qu’à ajouter des données.
Chaque fichier contiendra les données des événements créés pour l’ensemble de la journée civile précédente en UTC. Par exemple, les données exportées le 8 mars contiendront tous les événements créés le 7 mars de 00:00:00 à 23:59:59 en UTC.
L’export planifié ne s’exécute que pour les entreprises disposant d’un plan payant ou en période d’essai. Si votre entreprise n’est dans aucun de ces cas, le planificateur l’ignore et n’écrit aucun fichier, même si l’intégration reste activée dans le tableau de bord. Si votre bucket est vide et que la configuration semble correcte, vérifiez d’abord le statut de votre plan.
Configurer l’intégration Custom S3
Pour commencer à recevoir des données, configurez l’intégration dans Adapty Attribution :
- Allez dans Integrations -> Custom S3
- Activez le bouton Export install events to custom S3.
- Renseignez les champs obligatoires pour établir une connexion entre votre stockage S3 personnalisé et les profils Adapty Attribution.
| Champ | Description |
|---|---|
| Access Key ID | Un identifiant unique utilisé pour authentifier l’accès d’un utilisateur ou d’une application à votre service de stockage compatible S3. Vous trouverez cet identifiant dans la console de votre fournisseur de stockage. |
| Secret Access Key | Une clé privée utilisée conjointement avec l’Access Key ID pour authentifier l’accès d’un utilisateur ou d’une application à votre service de stockage compatible S3. Vous trouverez cette clé dans la console de votre fournisseur de stockage. |
| S3 Bucket Name | Un nom globalement unique qui identifie un bucket S3 spécifique dans votre environnement de stockage. Les buckets S3 sont un service de stockage simple permettant aux utilisateurs de stocker et de récupérer des objets de données, tels que des fichiers et des images, dans le cloud. |
| Region (Optionnel) | Obtenez votre région depuis la Management Console. |
| Folder Inside the Bucket (Optionnel) | Le nom du dossier que vous souhaitez créer dans le bucket S3 sélectionné. Notez que S3 simule les dossiers à l’aide de préfixes de clés d’objet, qui correspondent en réalité à des noms de dossiers. |
| Custom Endpoint URL | L’URL du point de terminaison de votre service de stockage compatible S3. Elle doit être fournie par votre fournisseur de stockage (par ex., MinIO, DigitalOcean Spaces, Wasabi, etc.). |
Vous pouvez également spécifier des répertoires imbriqués dans le champ du nom du bucket S3, par exemple adapty-ua-events/com.sample-app
Export manuel des données
En plus de l’export automatique des données d’événements vers votre stockage S3 personnalisé, Adapty Attribution propose également une fonctionnalité d’export de fichiers manuel. Grâce à cette fonctionnalité, vous pouvez sélectionner une date pour les données d’acquisition utilisateur et les exporter manuellement vers votre bucket S3. Vous gardez ainsi un meilleur contrôle sur les données que vous exportez et sur le moment où vous les exportez.
Structure de la table
Dans l’intégration S3 personnalisée, Adapty Attribution fournit une table pour stocker les données historiques des événements d’installation. Elle contient des informations sur le profil utilisateur, les revenus et recettes, le store d’origine, entre autres points de données.
Notez que cette structure peut évoluer au fil du temps — de nouvelles données peuvent être introduites par nous ou par les tiers avec lesquels nous travaillons. Assurez-vous que le code qui traite ces données est suffisamment robuste et repose sur des champs spécifiques, et non sur la structure dans son ensemble.
Voici la structure de la table pour les événements :
| Colonne | Description |
|---|---|
adapty_profile_id | Identifiant unique du profil Adapty |
install_id | Identifiant unique d’installation |
created_at | Horodatage de création de l’enregistrement (ISO 8601) |
installed_at | Horodatage d’installation de l’application (ISO 8601) |
store | Store applicatif (ios, android) |
country | Code pays de l’utilisateur (ISO 3166-1 alpha-2) |
ip_address | Adresse IP du client |
idfa | Identifiant iOS pour les annonceurs |
idfv | Identifiant iOS pour les éditeurs |
gaid | Identifiant publicitaire Google (Android) |
android_id | Identifiant d’appareil Android |
app_set_id | Android App Set ID |
bundle_id | Identifiant du bundle applicatif (ex. com.example.app) |
device_brand | Marque de l’appareil (ex. Apple, Samsung) |
device_model | Modèle de l’appareil (ex. iPhone15,2) |
os_version | Version majeure du système d’exploitation |
app_version | Version de l’application reportée par le SDK Adapty |
sdk_version | Version du SDK Adapty |
channel | Canal d’attribution |
campaign_id | Identifiant de campagne |
campaign_name | Nom de la campagne |
adset_id | Identifiant du groupe d’annonces |
adset_name | Nom du groupe d’annonces |
ad_id | Identifiant de l’annonce |
ad_name | Nom de l’annonce |
keyword_id | Identifiant du mot-clé |
keyword_name | Nom du mot-clé |
asa_org_id | Identifiant d’organisation Apple Search Ads |
asa_keyword_match_type | Type de correspondance de mot-clé ASA (Exact, Broad) |
asa_attribution | Données d’attribution ASA (chaîne JSON) |
asa_conversion_type | Type de conversion ASA |
asa_country_or_region | Pays ou région ASA |
asa_creative_set_name | Nom du jeu de créatifs ASA |
fbclid | Facebook Click ID |
ttclid | TikTok Click ID |
utm_source | Paramètre UTM source |
utm_medium | Paramètre UTM medium |
utm_campaign | Paramètre UTM campaign |
utm_term | Paramètre UTM term |
utm_content | Paramètre UTM content |
click_time | Horodatage du clic attribué, en secondes Unix. Vide si aucun clic n’est attribué à l’installation. |