Google Cloud Storage dans Adapty Attribution
L’intégration d’Adapty Attribution avec Google Cloud Storage vous permet de stocker en toute sécurité les données de vos campagnes d’acquisition utilisateur en un seul endroit centralisé. 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 Google Cloud Storage sous forme de fichiers .csv.
Pour configurer cette intégration, vous devrez suivre quelques étapes simples dans la Google Cloud Console et dans le tableau de bord Adapty Attribution.
Planification
Adapty Attribution envoie vos données vers Google Cloud Storage toutes les 24h à 4h00 UTC.
Chaque fichier contiendra les données des événements créés pour l’ensemble de la veille en UTC. Par exemple, les données exportées automatiquement à 4h00 UTC le 8 mars contiendront tous les événements créés le 7 mars de 00:00:00 à 23:59:59 UTC.
Comment configurer l’intégration Google Cloud Storage
Étape 1. Créer les identifiants Google Cloud Storage
Ce guide vous aidera à créer les identifiants nécessaires dans votre Google Cloud Platform Console.
Pour qu’Adapty Attribution puisse envoyer des rapports de données brutes dans votre bucket désigné, la clé du compte de service est requise, ainsi qu’un accès en écriture au bucket correspondant. En fournissant la clé du compte de service et en accordant l’accès en écriture au bucket, vous permettez à Adapty Attribution de transférer en toute sécurité les rapports de données brutes vers votre environnement de stockage.
Veuillez noter que nous prenons uniquement en charge l’autorisation par clé HMAC de compte de service. Il est donc indispensable que votre clé HMAC de compte de service dispose des rôles « Storage Object Viewer », « Storage Legacy Bucket Writer » et « Storage Object Creator » pour activer l’accès approprié à Google Cloud Storage.
2.1. Créer un compte de service
- Accédez à la section IAM de votre compte Google Cloud et choisissez le projet concerné ou créez-en un nouveau
- Ensuite, créez un nouveau compte de service pour Adapty Attribution en cliquant sur le bouton « + CREATE SERVICE ACCOUNT »
- Remplissez les champs de la première étape ; l’accès sera accordé ultérieurement. Pour plus de détails sur cette page, consultez la documentation ici
- Pour créer et télécharger une clé JSON privée, accédez à la section KEYS et cliquez sur le bouton « ADD KEY »
- Dans la section DETAILS, repérez la valeur Email associée au compte de service récemment créé et copiez-la. Ces informations seront nécessaires pour les étapes suivantes afin d’autoriser le compte et lui permettre d’écrire dans le bucket
2.2. Configurer les permissions du bucket
- Accédez à la page Buckets de Google Cloud Storage et sélectionnez un bucket existant ou créez-en un nouveau pour stocker les rapports de données d’acquisition utilisateur d’Adapty Attribution
- Accédez à la section PERMISSIONS et sélectionnez l’option GRANT ACCESS
- Dans la section PERMISSIONS, saisissez l’Email du compte de service obtenu à la cinquième étape, puis choisissez le rôle Storage Object Creator
- Enfin, cliquez sur SAVE pour appliquer les modifications
-
Notez le nom du bucket pour référence ultérieure
-
Une fois ces étapes terminées, vous avez effectué avec succès la configuration nécessaire dans la Google Cloud Console ! La dernière étape consiste à saisir le nom du bucket et à télécharger le fichier JSON à utiliser dans Adapty Attribution
Étape 2. Configurer l’intégration dans Adapty Attribution
- Accédez à Integrations -> Google Cloud Storage
- Activez le bouton Export install events to Google Cloud Storage
- Remplissez les champs requis pour établir la connexion entre Google Cloud Storage et Adapty Attribution :
| Champ | Description |
|---|---|
| Google Cloud service account key file | Le fichier de clé JSON privé téléchargé. |
| Google Cloud bucket name | Le nom du bucket dans Google Cloud Storage où vous souhaitez stocker vos données. Il doit être unique dans l’environnement Google Cloud Storage et ne doit pas contenir d’espaces. |
| Folder inside the bucket | Le nom du dossier à l’intérieur du bucket où vous souhaitez stocker vos données. Il doit être unique au sein du bucket et peut servir à organiser vos données. Ce champ est facultatif. |
Export manuel des données
En plus de l’export automatique des données d’événements vers Google Cloud Storage, Adapty Attribution propose également une fonctionnalité d’export manuel de fichiers. Grâce à cette fonction, vous pouvez sélectionner une date précise pour les données d’acquisition utilisateur et les exporter manuellement dans votre bucket GCS. Cela vous donne un contrôle accru sur les données que vous exportez et sur le moment où vous les exportez.
Structure de la table
Dans l’intégration Google Cloud Storage, 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, ainsi que sur le store d’origine, entre autres données.
Notez que cette structure peut évoluer au fil du temps — de nouvelles données pouvant être introduites par nous-mêmes ou par les tiers avec lesquels nous travaillons. Assurez-vous que votre code qui la traite 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 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 d’application (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 vendeurs |
gaid | Google Advertising ID (Android) |
android_id | Identifiant d’appareil Android |
app_set_id | Android App Set ID |
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 créatif 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 |