L’intégration d’Adapty Attribution avec Amazon S3 vous permet de stocker les données de vos campagnes d’acquisition utilisateur de façon sécurisée en un seul endroit. Vous pouvez ainsi enregistrer les performances de vos campagnes, les données d’attribution et les événements d’acquisition dans votre bucket Amazon S3 sous forme de fichiers .csv.
Pour configurer cette intégration, il vous suffit de suivre quelques étapes simples dans AWS Console et dans le tableau de bord Adapty Attribution.

Comment configurer l’intégration Amazon S3

Pour commencer à recevoir des données, vous aurez besoin des identifiants suivants :

1. Access key ID
2. Secret access key
3. Nom du bucket S3
4. Nom du dossier dans le bucket S3

Étape 1. Créer les identifiants Amazon S3

Ce guide vous aide à créer les identifiants nécessaires dans votre AWS Console.

1.1. Créer une politique d’accès

1. Accédez au tableau de bord des politiques IAM dans votre AWS Console
2. Sélectionnez l’option Create Policy

3. Dans l’éditeur de politique, collez le JSON suivant et remplacez adapty-s3-integration-test par le nom de votre bucket :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowListObjectsInBucket",
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::adapty-s3-integration-test"
        },
        {
            "Sid": "AllowAllObjectActions",
            "Effect": "Allow",
            "Action": "s3:*Object",
            "Resource": [
                "arn:aws:s3:::adapty-s3-integration-test/*",
                "arn:aws:s3:::adapty-s3-integration-test"
            ]
        },
        {
            "Sid": "AllowBucketLocation",
            "Effect": "Allow",
            "Action": "s3:GetBucketLocation",
            "Resource": "arn:aws:s3:::adapty-s3-integration-test"
        }
    ]
}

4. Une fois la politique configurée, vous pouvez ajouter des tags (facultatif), puis cliquer sur Next pour passer à l’étape finale
5. Dans cette étape, donnez un nom à votre politique et cliquez sur le bouton Create policy pour finaliser la création

1.2. Créer un utilisateur IAM

Pour permettre à Adapty Attribution de charger des rapports de données brutes dans votre bucket, vous devez lui fournir l’Access Key ID et la Secret Access Key d’un utilisateur disposant d’un accès en écriture sur le bucket concerné.

1. Accédez à la console IAM et sélectionnez la section Utilisateurs
2. Cliquez sur le bouton Add users

3. Donnez un nom à l’utilisateur, choisissez Access key – Programmatic access, puis passez aux permissions

4. Pour l’étape suivante, sélectionnez l’option Add user to group, puis cliquez sur le bouton Create group

5. Ensuite, donnez un nom à votre groupe d’utilisateurs et sélectionnez la politique que vous avez créée précédemment
6. Une fois la politique sélectionnée, cliquez sur le bouton Create group pour finaliser le processus

7. Après avoir créé le groupe, sélectionnez-le et passez à l’étape suivante

8. C’est la dernière étape de cette section ; cliquez simplement sur le bouton Create User

9. Enfin, vous pouvez soit télécharger les identifiants au format .csv, soit les copier-coller directement depuis le tableau de bord

Étape 2. Configurer l’intégration dans Adapty Attribution

1. Accédez à Integrations -> Amazon S3
2. Activez le bouton Export install events to Amazon S3.
3. Remplissez les champs suivants pour établir la connexion entre Amazon S3 et les profils Adapty Attribution :

Champ	Description
Access Key ID	Identifiant unique utilisé pour authentifier l’accès d’un utilisateur ou d’une application à un service AWS. Retrouvez cet identifiant dans le fichier csv téléchargé.
Secret Access Key	Clé privée utilisée conjointement avec l’Access Key ID pour authentifier l’accès d’un utilisateur ou d’une application à un service AWS. Retrouvez cette clé dans le fichier csv téléchargé.
S3 Bucket Name	Nom unique au monde identifiant un bucket S3 spécifique dans le cloud AWS. Les buckets S3 sont un service de stockage simple permettant de stocker et de récupérer des objets de données, comme des fichiers et des images, dans le cloud.
Folder Inside the Bucker	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 essentiellement à des noms de dossiers.
Region (Optionnel)	Retrouvez votre région dans AWS Management Console sous votre compte utilisateur IAM.

Export manuel des données

En plus de l’export automatique des données d’événements vers Amazon S3, Adapty Attribution propose également une fonctionnalité d’export manuel de fichiers. Cette fonctionnalité vous permet de sélectionner une date précise pour les données d’acquisition utilisateur et de les exporter manuellement dans votre bucket S3, pour un contrôle total sur les données exportées et le moment de leur export.

Structure de la table

Dans l’intégration AWS S3, Adapty Attribution fournit une table pour stocker l’historique des événements d’installation. Cette table contient des informations sur le profil utilisateur, les revenus et les produits, le store d’origine, entre autres points de données.

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 (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	Identifiant publicitaire Google (Android)
android_id	Identifiant de l’appareil Android
app_set_id	Android App Set ID
channel	Canal d’attribution
campaign_id	Identifiant de la 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 du 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 source UTM
utm_medium	Paramètre medium UTM
utm_campaign	Paramètre campagne UTM
utm_term	Paramètre terme UTM
utm_content	Paramètre contenu UTM