Custom S3 dans Adapty Attribution
L’intégration d’Adapty Attribution avec un stockage compatible S3 personnalisé vous permet de stocker les données de vos campagnes 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 le tableau de bord Adapty Attribution.
Adapty Attribution envoie vos données toutes les 24h à 4:00 UTC.
Chaque fichier contiendra les données des événements créés pour l’intégralité du jour calendaire précédent en UTC. Par exemple, les données exportées automatiquement à 4:00 UTC le 8 mars contiendront tous les événements créés le 7 mars de 00:00:00 à 23:59:59 UTC.
Configurer l’intégration Custom S3
Pour commencer à recevoir des données, configurez l’intégration dans Adapty Attribution :
- Accédez à Integrations -> Custom S3
- Activez le bouton Export install events to custom S3.
- Renseignez les champs requis 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. Trouvez 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. Trouvez 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 qui permet aux utilisateurs de stocker et de récupérer des objets de données, comme 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 sont essentiellement des noms de dossiers. |
| Custom Endpoint URL | L’URL de point de terminaison de votre service de stockage compatible S3. Elle doit être fournie par votre fournisseur de stockage (par exemple, MinIO, DigitalOcean Spaces, Wasabi, etc.). |
Vous pouvez également spécifier des répertoires imbriqués dans le champ S3 bucket name, 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 manuel de fichiers. Grâce à cette fonctionnalité, vous pouvez sélectionner une date pour les données d’acquisition utilisateur et les exporter manuellement dans votre bucket S3. Cela vous permet de mieux contrôler les données que vous exportez et le moment où vous les exportez.
Structure de la table
Dans l’intégration Custom S3, Adapty Attribution fournit une table pour stocker les données historiques des événements d’installation. La table contient des informations sur le profil utilisateur, les revenus et les gains nets, ainsi que le store d’origine, parmi d’autres points de données.
Notez que cette structure est susceptible d’évoluer au fil du temps — avec de nouvelles données introduites par nos soins ou par les tiers avec lesquels nous travaillons. Assurez-vous que le code qui traite ces données est suffisamment robuste et s’appuie 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 de l’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 | iOS Identifier for Advertisers |
idfv | iOS Identifier for Vendors |
gaid | Google Advertising ID (Android) |
android_id | Identifiant d’appareil Android |
app_set_id | Android App Set ID |
bundle_id | Identifiant de bundle de l’application (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 |