Verrouillage des données — flux de données pour les annonceurs

En bref : Data Locker diffuse les données de vos rapports vers un stockage Cloud pour les charger dans les systèmes BI des annonceurs. Différentes options de stockage vous permettent de choisir entre un compartiment appartenant à AppsFlyer sur AWS ou un compartiment appartenant à l'annonceur sur AWS ou GCS. Data Locker est une solution multi-apps. 

DataLockerBuckets.png

Lecture connexe : sélection de l'outil de livraison de données brutes adapté à vos besoins

Data Locker

Data Locker envoie vos données AppsFlyer vers le stockage Cloud. Vous sélectionnez les apps, les sources média, les événements et les rapports à inclure dans le flux. Chargez les données diffusées par programme dans vos systèmes BI. 

Caractéristiques

Contient Description
Options de stockage (Cloud)

Plusieurs options de stockage sont proposées. Vous pouvez passer d'une option à l'autre à tout moment. Les différences options sont basées sur le fournisseur de services cloud et sur le propriétaire du compartiment. Options disponibles :

  • Stockage appartenant à AppsFlyer : AWS
  • Stockage dont vous êtes propriétaire :
    • AWS 
    • GCS
Multi-app

Diffusez les données de l'une, de plusieurs ou de l'ensemble des apps de votre compte. Lorsque vous ajoutez des apps au compte, elles peuvent être incluses automatiquement.

Segmentation des données

 

Options possibles de segmentation des données

  • [Par défaut] Unifié : les données cumulées de toutes les apps. Le champ ID d'app au niveau des lignes permet d'identifier l'app dans les fichiers de données.
  • Segmenté par app : les données de chaque app sont classées dans un dossier séparé. Le nom du dossier est constitué par l'ID de l'app.
Actualisation des données

L'actualisation dépend du type de rapport

  • Chaque heure : données générées en continu, exemple : les installations et les données d'événements in-app sont diffusées dans les heures qui suivent l'arrivée de l'événement sur AppsFlyer.
  • Chaque jour : certains rapports, comme les désinstallations, sont générés quotidiennement et sont prêts le jour suivant.
Rapports spécifiques à Data Locker
  • Données non converties : données sur les clics et les impressions des campagnes UA et de retargeting. A propos des clics et des impressions
  • Les données brutes SKAdNetwork sont disponibles dans le stockage dont vous êtes propriétaire, et ce sans avoir besoin de passer par un abonnement Data Locker.
Exemples de fichiers de données

Clics, Installations, Événements in-app 

Rapports disponibles dans Data Locker

Rapports de mesure principaux
Catégorie Type de rapport (sujet) Fraîcheur des données* Organique / Non-Organique Propre à Data Locker
Acquisition des utilisateurs Clics  Décalage de 6 heures S/O
Retargeting Clics Décalage de 6 heures S/O
Acquisition des utilisateurs Impressions Décalage de 6 heures S/O
Retargeting Impressions Décalage de 6 heures S/O
Acquisition des utilisateurs d'installations Décalage de 6 heures Les deux  
Acquisition des utilisateurs Évènements in-app  Décalage de 6 heures Les deux  
Acquisition des utilisateurs Revenus publicitaires attribués Quotidiennement+2 Non organique  
Acquisition des utilisateurs Revenus publicitaires organiques Quotidiennement+2 Trafic  
Retargeting Revenus publicitaires de retargeting Quotidiennement+2 Non organique  
Retargeting Conversions Décalage de 6 heures Non organique  
Retargeting Évènement in-app Décalage de 6 heures Non organique  
Retargeting Sessions Décalage de 6 heures Les deux
Acquisition des utilisateurs Sessions Décalage de 6 heures Les deux
Acquisition des utilisateurs Désinstallations Désinstallation quotidienne Non organique  
Acquisition des utilisateurs Désinstallations organiques Désinstallation quotidienne Trafic  
Réinstallations Réinstallations Décalage de 6 heures Non organique  
Réinstallations Réinstallations organiques Décalage de 6 heures Trafic  
Rapports Protect360
Type de rapport (sujet) Fraîcheur des données*
Installations bloquées Décalage de 6 heures
Événements in-app bloqués  Décalage de 6 heures
Clics bloqués Décalage de 6 heures
[AG*] Installations post-attribution Quotidien
SKAdNetwork [Vous n'avez pas besoin d'un abonnement Data Locker si vous les envoyez à votre propre compartiment]
Actualité des données : quotidienne 
Type de rapport (sujet)
[FF*] Postbacks
[FF*] Installations
[FF*] Re-téléchargements
[FF*] Événements in-app
Actualisation des données pour les rapports d'attribution basée sur les utilisateurs : chaque jour
Type de rapport (sujet)
[FF*] Visites de site web
[FF*] Évènements de site web
[FF*] Installations assistées par site web
[FF*] Chemins de conversion
* Clé des abréviations

[FF] Les champs de rapport sont définis par AppsFlyer. Ils ne sont pas liés aux champs sélectionnés à inclure dans les rapports.

[AG]La transparence de l'agence n'est pas prise en charge.

Décalage de 6 heures :

  • Les données sont classées dans des dossiers selon l'heure d'arrivée.
  • Il s'agit de l'heure à laquelle l'événement a été transmis à Data Locker pour diffusion.
  • Le décalage est toujours le même, quel que soit le fuseau horaire spécifique à l'app.

Chaque jour :

  • Les rapports sont diffusés dans le dossier h=23.
  • Ces rapports sont généralement disponibles entre 10:00 et 12:00 UTC dans le dossier h=23 du jour qui précède.
  • Par exemple, le rapport pour les données générées le lundi se trouve dans le dossier « Monday h=23 ». Les données sont disponibles le mardi après 10:00 UTC.

Désinstallation par jour

  • Les données de désinstallation sont préparées chaque jour.
  • Généralement disponible entre 10:00 et 12:00 UTC.
  • Le plus souvent diffusé dans le dossier h=2. En d'autres termes, le dossier h=2 contient les désinstallations signalées le jour précédent. Les données peuvent cependant être diffusées vers un dossier créé après, votre processus d'importation doit donc lire les données contenues dans chaque dossier du dossier des désinstallations. Ce qui signifie h=1-24 et h=late Par exemple, le rapport concernant des données générées le lundi se trouve dans le dossier « Mardi h=2 ». Les données sont disponibles le mardi après 10:00 UTC.

Quotidien+2 : les données de revenus publicitaires sont disponibles après 2 jours. Les données générées le lundi seront donc disponibles dans le dossier H=23 du lundi après 06:00 UTC le mercredi.

Architecture de stockage des données

Présentation

Les données sont diffusées vers l'option de stockage que vous avez choisie. Soit le stockage appartient à AppsFlyer sur AWS, soit vous en êtes propriétaire sur AWS ou GCS. Vous pouvez passer d'une option de stockage à l'autre à tout moment. Le changement prend effet en quelques heures.

Les données stockées sont rangées dans une structure de dossiers hiérarchisée d'après le type de rapport, la date et l'heure. La figure suivante vous donne un exemple de cette structure :

DLFolderOVerview.png

Les données d'un certain rapport sont contenues dans les dossiers «heure» (h) associés à ce rapport :

  • Le nombre de dossiers «heure» dépend de l'actualisation des données du rapport (chaque heure ou chaque jour).
  • Les fichiers de données se composent de fichiers GZ compressés contenant des fichiers CSV.
  • Les fichiers CSV sont constitués de colonnes.
  • La structure des colonnes des rapports de mesure principaux est la même. Vous pouvez ainsi avoir les mêmes procédures de chargement de données pour différents types de rapports. Les champs (colonnes) qui apparaissent dans les rapports sont choisis par vous.
  • Les rapports qui sont marqués «FF» ont leur propre structure de colonnes.

Structure de dossier

Dossier Description 
data-locker-hourly

DLHourly.png

  • Le dossier racine du compartiment dépend du propriétaire et du fournisseur de stockage.
  • Le dossier data-locker-hourly contient les sujets du rapport. Les dossiers supérieurs à ce niveau dépendent de la propriété du compartiment et du fournisseur de services Cloud.

 Exemples de structure de dossiers en fonction du propriétaire du compartiment et du fournisseur de Cloud

  • Compartiment AppsFlyer : <af-ext-reports>/<unique_identifier>/<data-locker-hourly>
  • Votre compartiment AWS : <af-datalocker-your folder name>/<data-locker-hourly>
  • Votre compartiment GCS : < data-locker-hourly>
t (topic, sujet) Le type de rapport est lié au sujet du rapport. 
dt (date)

Il s'agit de la date des données associées. Dans la plupart des cas, cela correspond à la date à laquelle l'événement s'est produit. 

h (heure)

Les dossiers h correspondent à l'heure à laquelle AppsFlyer reçoit les données AppsFlyer. Par exemple, les événements d'installation reçus entre 14:00 et 15:00 UTC sont diffusés dans le fichier h=14. Important ! Il y a un décalage d'environ 6 heures entre l'heure à laquelle les données arrivent dans AppsFlyer et l'heure à laquelle le dossier h est diffusé dans Data Locker. Par exemple, le dossier h=14 est diffusé six heures plus tard, à 23h00 UTC.

Caractéristiques du dossier :

  • Il y a 24 dossiers h numérotés de 0 à 23. Par exemple : h=0, h=1, etc
  • Un dossier «h=late», contient les événements du jour précédent mais qui sont arrivés après minuit. C'est à dire les événements qui arrivent entre 00:00 et 02:00 UTC le lendemain. Par exemple, si un utilisateur installe une application le lundi à 08:00 UTC, et que l'événement arrive le mardi à 01:00 UTC, l'événement est diffusé vers le dossier «late» du lundi.
  • Les données qui arrivent après 02:00 UTC sont diffusées vers le dossier correspondant au jour et au moment où l'événement est arrivé.
  • Vérifiez que les données du dossier h=late sont bien consommées. Elles ne sont pas contenues dans un autre dossier.
  • _temporary folder : dans certains cas, un dossier temporaire est généré au sein d'un dossier h. Vous devez ignorer le dossier temporaire ainsi que ses sous-dossiers. Exemple : /t=impressions/dt=2021-04-11/h=18/_temporary.

Segmentation des apps

Les données sont fournies dans des fichiers de données unifiés contenant les données de toutes les apps sélectionnées ou séparées en dossiers par app. La segmentation se trouve dans le dossier h, comme décrit dans le tableau suivant.
Type de segmentation Description 
[Défaut] Unifié

Les données de toutes les apps sont fournies dans des fichiers de données unifiés. Lorsque vous consommez les données, utilisez le champ app_id au niveau des lignes pour faire la distinction entre les applications.

Des exemples de fichiers de données sont disponibles dans le dossier h=2

UnifiedByApp.png

La convention d'appellation des fichiers de données est : part-nnnnn.gz où : 

  • nnnnn est un numéro de partie compris entre 0000 et 99999. Exemple : part-00000, part-00001, part-00002... (partie 0000, partie 0001...)
  • Les numéros des parties ne sont pas nécessairement consécutifs.
  • Dans votre processus de consommation des données, assurez-vous que :
    • Les données ne sont consommées qu'après l'activation de l'indicateur _SUCCESS.
    • Tous les fichiers avec l'extension.gz contenus dans le dossiersont consommés.
Segmenté par application

Le dossier contient des sous-dossiers pour chaque application. Les fichiers de données correspondant à chaque app sont contenus dans le dossier de l'app. Dans la figure qui suit, le dossier h=19 contient des dossiers d'app. Chaque dossier d'app contient les fichiers de données associés.

DLSegregateByApp.png

Dans chaque dossier d'app, la convention d'affectation de noms est : part-nnnn-string.csv.gz : 

  • nnnnn est un numéro de partie compris entre 0000 et 99999. Exemple : part-00000, part-00001, part-00002... (partie 0000, partie 0001...)
  • Les numéros des parties ne sont pas nécessairement consécutifs.
  • Dans votre processus de consommation des données, assurez-vous que :
    • Les données ne sont consommées qu'après l'activation de l'indicateur _SUCCESS. Important ! L'indicateur est défini au niveau h et non au niveau app_id. 
    • Vous utilisez tous les fichiers du dossier ayant une extension .gz.

Limitation : cette option n'est pas disponible pour les rapports d'attribution basés sur les personnes.

Fichiers de données

Contenu Unifié  Segmenté par app 
Indicateur d'achèvement

L'indicateur du dernier fichier (achèvement) est activé lorsque toutes les données d'un dossier h donné ont été diffusées.

  • Ne lisez pas les données d'un dossier avant de vérifier que l'indicateur _SUCCESS existe.

  • L'indicateur _SUCCESS est défini même dans les cas où il n'y a aucune données à diffuser vers le dossier en question, et que celui-ci est vide.

  • Important ! Dans l'option de segmentation par app, l'indicateur est défini dans le dossier h et non dans les dossiers individuels de l'application. Cf illustrations dans la section précédente.
 

Les fichiers partiels sont compressés en GZ. Après décompression :

  • Les fichiers n'ont pas d'extension.
  • Chaque fichier possède une ligne d'en-tête contenant les noms des colonnes (champs). 

Les fichiers partiels sont compressés en GZ. Après décompression :

  • Avoir une extension CSV.
  • Chaque fichier possède une ligne d'en-tête contenant les noms des colonnes (champs).
Séquence de colonnes

La séquence des champs dans les rapports est toujours la même. Lorsque nous ajoutons de nouveaux champs, ceux-ci sont ajoutés à droite des champs existants.

À cet égard : 

  • La structure des colonnes est la même pour les rapports UA et les rapports de retargeting. Vous pouvez ainsi avoir les mêmes procédures de chargement de données pour différents types de rapports. Vous sélectionnez les champs à diffuser.
  • Les rapports ayant une indication de FF dans la section Disponibilité des rapports ne respectent pas la structure de colonne commune. 
  • La signification du champ est détaillée dans le dictionnaire de données brutes
Considérations relatives au remplissage des champs

Champs vides : certains champs font apparaitre le messagenull ou restent vides. Cela signifie que dans le cadre d'un rapport donné, il n'y a aucune donnée à signaler. En général, null indique que le champ n'est pas renseigné pour ce rapport et ce type d'application donnés. Un espace vide « » indique que le champ relève bien du cadre, mais qu'aucune donnée n'a été trouvée pour pouvoir le renseigner.

Fuseau horaire et devise

Les paramètres de fuseau horaire et de devise propres à l'application n'ont aucun effet sur les données diffusées vers Data Locker. Les conditions suivantes s'appliquent :

  • Fuseau horaire : les données de la date et de l'heure sont en UTC.
  • Devise : le champ event_revenue_usd est en USD. 

Valeurs avec virgules : les valeurs qui comportent une virgule sont placées entre guillemets, exemple, `"iPhone6,1"`.

Les fichiers de données dépendent du type de segmentation

Options de stockage

 Attention !

Si vous utilisez l'option de stockage appartenant à l'annonceur : 

  • Vérifiez que vous respectez les réglementations sur la confidentialité des données telles que le RGPD et les politiques de conservation des données du réseau publicitaire/SRN.
  • N'utilisez pas la solution de stockage appartenant à l'annonceur pour envoyer des données à des tiers.
  • Les données sont inscrites pour le propriétaire de compartiment de votre choix, comme suit :
    • Stockage appsFlyer
    • Stockage client — SAP ou GCS
  • Vous pouvez modifier la sélection du stockage à tout moment.
  • Si vous modifiez l'espace de stockage, voici ce qui se passe :
    • Nous commençons à écrire dans le stockage nouvellement sélectionné dans l'heure qui suit.
    • Nous continuons d'écrire dans le stockage existant pendant une période de transition de 7 jours. Le délai d'expiration de la période de transition s'affiche dans l'interface utilisateur. Utilisez la période de transition pour mettre à jour vos processus de chargement des données. 
    • Changement de système de stockage : si vous changez de stockage, les données sont envoyées vers les deux systèmes de stockage pendant une période de transition de 7 jours. Cela vous permettra d'aligner votre processus de consommation de données. 
  Stockage appartenant à AppsFlyer (AWS)  Stockage appartenant à l'annonceur (AWS)
Nom du compartiment Définir par AppsFlyer
  • GCS : aucune restriction
  • AWS  : défini par vous. Doit comporter le préfixe af-datalocker-.

Exemple : af-datalocker-votre-nom-de-compartiment

Propriété du stockage AppsFlyer Annonceur
Plate-forme de stockage AWS AWS ou GCS
Autorisations d'accès aux données que vous accordez Disponible dans l'interface utilisateur de Data Locker pour l'admin Inconnu d'AppsFlyer. Utilisez les informations d'identification fournies par le fournisseur de stockage.
Conservation des données Les données sont supprimées après 30 jours Responsabilité de l'annonceur
Demandes de suppression de données Responsabilité d'AppsFlyer Responsabilité de l'annonceur
Sécurité AppsFlyer contrôle le stockage. Le client a un accès en lecture seule.

L'annonceur contrôle le stockage.

  • AWS : AppsFlyer demande l'autorisation pour GetObject, ListBucket, DeleteObject, PutObject au compartiment. Le compartiment doit être soumis à l'utilisation exclusive d'AppsFlyer. Ne l'utilisez pas à d'autres fins.
  • GCS : voir article sur la configuration GCS.
Capacité de stockage Géré par AppsFlyer Géré par l'annonceur
Contrôle de l'accès à l'aide de points de terminaison VPC avec règles de compartiment Non applicable [Facultatif] Dans AWS, si vous installez la sécurité des points de terminaison VPC au niveau compartiment, vous devez autoriser les serveurs AppsFlyer. 
Rapports de SKAdNetwork Abonnement à Data Locker nécessaire Disponible si vous avez un abonnement aux données brutes. Autrement dit, inutile de souscrire à un abonnement Data Locker.

Avis aux agents de sécurité dans le cas de stockage contrôlé par le client

Vous pouvez avoir l'impression que nous demandons beaucoup d'autorisations, mais n'oubliez pas ce qui suit :

  • Le compartiment doit être soumis à l'utilisation exclusive d'AppsFlyer. Aucune autre entité ne doit inscrire (diffuser) quoi que ce soit dans le compartiment.
  • Vous pouvez supprimer des données dans le compartiment 25 heures après leur écriture.
  • Les données diffusées vers le compartiment sont une copie des données déjà présentes sur nos serveurs. Les données continuent d'être stockées sur nos serveurs, conformément à notre politique de rétention des données. 
  • Pour des raisons techniques, il nous arrive de supprimer puis restaurer des données. C'est la raison pour laquelle nous avons besoin d'obtenir les autorisations pour suprimer et repertorier les données.Aucune des autorisations ne compromet votre sécurité. Lorsque nous répertorions, nous sommes les seuls à diffuser vers le compartiment. Lorsque nous supprimons, nous sommes en mesure de régénérer les données.
  • Pour toute information complémentaire, vous pouvez joindre notre équipe dédiée à la sécurité surhello@appsflyer.com, ou contacter votre responsable réussite client.

Procédures

Configurer Data Locker

Utilisez cette procédure pour mettre en place Data Locker. Les modifications apportées aux paramètres Data Locker et les changements qui en découlent mettent jusqu'à 3 heures pour prendre effet. 

Condition préalable à la mise en place d'un stockage appartenant à l'annonceur :

Si vous configurez Data Locker en utilisant un stockage appartenant à l'annonceur, c'est-à-dire un compartiment que vous possédez, effectuez l'une des procédures de stockage appartenant à l'annonceur suivantes :

  • Votre compartiment AWS
  • Votre compartiment GCS

Important ! Si vous n'avez pas d'abonnement à Data Locker et que vous avez uniquement accès aux données de SKAdNetwork, vous devez suivre une procédure de stockage propre à l'annonceur.

AppsFlyerAdmin_us-en.png Pour configurer Data Locker :

  1. L'administrateur doit effectuer la configuration. 
  2. Dans Appsflyer, allez dans Integration > Data Locker. 
  3. Choisissez une méthode d'intégration. Effectuez l'une des opérations suivantes :
    • Sélectionnez Compartiment AWS AppsFlyer. Passez à l'étape 4. 
    • Sélectionnez votre compartiment AWS.
      1. Saisissez le nom de votre compartiment AWS. Ne saisissez pas le préfixe af-datalocker-
      2. Cliquez sur Tester.
      3. Vérifiez qu'aucun message d'erreur ne s'affiche pour indiquer que le chemin du compartiment est invalide.
    • Sélectionnez Votre compartiment GCS, saisissez le nom de votre compartiment GCS, puis cliquez sur Test.
  4. Sélectionnez la structure de dossier (segmentation des données) :
    • [Défaut] Unifié.
    • Segmentation par app.
  5. Sélectionnez les apps requises. Sélectionnez toutes pour inclure automatiquement les apps ajoutées que vous ajouterez par la suite.
  6. Cliquez sur Appliquer
  7. [facultatif] Sources médias : sélectionnez une ou plusieurs Sources média à inclure dans les rapports.
    • Par défaut : toutes Signifie que les sources média ajoutées à l'avenir seront ajoutées automatiquement.
  8. Sélectionnez les types de rapports requis. Vous devez en sélectionner au moins 1.
  9. [facultatif] Événements in-app: sélectionnez les événements in-app à inclure. Si vous avez plus de 100 types d'événements in-app, vous ne pouvez pas lancer de recherche pour les trouver. Saisissez leur nom exact pour les sélectionner. 
    • Par défaut : tous Signifie que les événements in-app ajoutés à l'avenir seront ajoutés automatiquement.
  10. Cliquez sur Appliquer
  11. [Facultatif] Champs : sélectionnez les champs à inclure dans les rapports. Remarque : nous pouvons être amenés à proposer des champs supplémentaires. Veuillez en tenir compte pour votre processus d'importation des données.
  12. Cliquez sur Enregistrer la configuration. L'un des événements suivants se produit :
    • Si vous avez choisi le compartiment AWS AppsFLyer :
      • Un compartiment AWS dédié est créé. Les informations d'identification du compartiment s'affichent.
      • Le compartiment est accessible uniquement à l'aide des informations d'identification. Les informations d'identification vous permettent d'accéder en lecture seule au compartiment.
    • Si vous avez sélectionné Compartiment client : les données seront diffusées vers votre compartiment dans les 3 heures.

Configuration Data Locker—Votre compartiment AWS S3

La procédure décrite dans cette section doit être effectuée par votre administrateur AWS.

Vous pouvez supprimer n'importe quel fichier de Data Locker 25 heures après qu'il a été inscrit. Ne supprimer rien avant ce délai.

Informations générales pour l'administrateur AWS : 

AppsFlyer diffusent vos données vers un compartiment AWS appartenant à un annonceur. Pour ce faire, les éléments suivants sont requis :

  • Créez un compartiment portant le nom af-datalocker-moncompartiment. Le préfixe af-datalocker- est obligatoire. Le suffixe est libre.
  • Nous vous suggérons af-datalocker-aaaa-mm-jj-hh-mm-texte-libre. aaaa-mm-jj-hh-mm correspond à la date et à l'heure actuelles, et vous ajoutez tout autre texte tel qu'indiqué dans la figure suivante.

Interface utilisateur dans la console AWS

MyBucket.jpg

Après avoir créé le compartiment, accordez les autorisations AppsFlyer en suivant la procédure ci-dessous. 

Pour créer un compartiment et accorder des autorisations à AppsFlyer : 

  1. Connectez-vous à la console AWS.
  2. Accédez au service S3.
  3. Pour créer le compartiment:
    1. Cliquez sur Créer un compartiment.
    2. Complétez le nom du compartiment comme suit : commencez par af-datalocker-, puis ajoutez tout autre texte tel que décrit précédemment.
    3. Cliquez sur Créer un compartiment.
  4. Pour accorder les autorisations AppsFlyer :
    1. Sélectionnez le compartiment.
    2. Allez dans l'onglet Permissions
    3. Dans la section Politique relative aux compartiments, cliquez sur Modifier. 
      La fenêtre de la politique du compartiment s'ouvre.
    4. Collez l'extrait suivant dans la fenêtre.
      {
        "Version": "2012-10-17",
        "Statement": [
          {
            "Sid": "AF_DataLocker_Direct",
            "Effect": "Allow",
            "Principal": {
              "AWS": "arn:aws:iam::195229424603:user/product=datalocker__envtype=prod__ns=default"
            },
            "Action": [
              "s3:GetObject",
              "s3:ListBucket",
              "s3:DeleteObject",
              "s3:PutObject"
            ],
            "Resource": [
              "arn:aws:s3:::af-datalocker-my-bucket",
              "arn:aws:s3:::af-datalocker-my-bucket/*"
            ]
          }
        ]
      }
      
  5. Dans l'extrait de code, remplacez af-data-locker-my-bucket par le nom du compartiment que vous avez créé.

  6. Cliquez sur Enregistrer les modifications.

  7. Effectuez la procédure d'installation du Data Locker.

Réinitialiser les identifiants

L'admin peut réinitialiser les identifiants du compartiment AppsFlyer à tout moment. Important ! Si vous réinitialisez les identifiants, vous devez mettre à jour vos scripts d'importation des données avec les nouveaux identifiants.

AppsFlyerAdmin_us-en.png Pour réinitialiser les identifiants :

  1. Dans Appsflyer, allez dans Integration > Data Locker. 
  2. Dans la section Identifiants, cliquez sur Réinitialiser les identifiants.
    Une fenêtre de confirmation apparait.
  3. Cliquez sur Réinitialiser.
  4. Attendez que le message Les identifiants ont bien été réinitialisés s'affiche (environ 20 secondes).
    Les nouveaux identifiants sont alors disponibles.

Informations supplémentaires

Particularités et limites

Particularités
Particularité Remarques 
Réseaux publicitaires Ne doit pas être utilisé les réseaux publicitaires
Agences Non utilisé pour les agences.
Fuseau horaire spécifique à l'app Ne s'applique pas. Les dossiers Data Locker sont divisés en heures en se basant sur l'UTC. Les événements réels contiennent les heures en UTC. Vous pouvez convertir les heures dans un autre fuseau horaire si nécessaire. Quel que soit le fuseau horaire de votre app, le délai entre l'apparition de l'événement et son enregistrement dans Data Locker reste le même, à savoir 6 heures. 
Devise spécifique à l'app  Non pris en charge
Limitations de taille Ne s'applique pas
Actualisation des données Les fichiers sont mis à jour toutes les heures avec un décalage de six heures par rapport à l'heure de l'événement.
Données historiques Non pris en charge. Les données d'événement sont envoyées après la configuration de Data Locker. Si vous avez besoin de données historiques, utilisez l'API Pull. 
Accès des membres de l'équipe Les membres de l'équipe ne peuvent pas configurer Data Locker. 
Application unique/applications multiples Prise en charge multi-applications. Data locker est au niveau du compte

Dépannage

  • Symptôme : impossible de récupérer des données via AWS CLI
  • Message d'erreur : une erreur s'est produite (accès refusé) lors de l'appel de l'opération ListObjectsV2 : accès refusé
  • Cause : les informations d'identification AWS utilisées ne sont pas les informations d'identification correctes pour le compartiment AppsFlyer. Cela peut être dû au fait que vos informations d'identification sont multiples ou non valides sur votre ordinateur. 
  • Solution :
    1. Utilisez une autre méthode que la CLI (par exemple Cyber Duck) pour accéder au compartiment. Effectuez cette opération pour vérifier que les informations d'identification que vous utilisez fonctionnent. Si vous parvenez à vous connecter à l'aide de Cyber Duck, c'est le signe qu'un problème existe au niveau du cache des identifiants.
    2. Actualisez le cache des identifiants AWS.
      Capture d'écran de AWSmceclip0.png

Récupération des données

Utilisez votre outil de recherche de données AWS habituel, AWS CLI, ou l'un des outils décrits dans les sections qui suivent. Important ! Les instructions exactes conviennent aux compartiments appartenant à AppsFlyer. Si vous vous connectez à votre compartiment, ajustez les instructions si besoin. 

AWS CLI

Avant de commencer :

  • Installez AWS CLI sur votre ordinateur.
  • Dans AppsFlyer, accédez à Data Locker et récupérez les informations contenues dans le panneau d'informations d'identification.

Pour utiliser AWS CLI :

  1. Ouvrez le terminal. Dans Windows, <Windows>+<R>, cliquez sur OK.
    La fenêtre de ligne de commande s'ouvre.
  2. Saisissez aws configure.
  3. Saisissez la clé d'accès AWS telle qu'elle apparaît dans le panneau des informations d'identification.
  4. Saisissez votre clé secrète AWS telle qu'elle apparaît dans le panneau des informations d'identification.
  5. Saisissez eu-west-1.
  6. Appuyez sur Entrée (aucun).

Utilisez les commandes CLI qui suivent au besoin.

Dans les commandes suivantes, la valeur de {home-folder} peut être trouvée

Pour répertorier les dossiers de votre compartiment :


aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/

Liste des fichiers et des dossiers

Il existe trois types de dossiers dans votre compartiment Data Locker :

  • Type de rapport t=
  • Date dt=
  • Heure h=

Pour répertorier tous les rapports d'un type de rapport spécifique :

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/

Pour répertorier tous les rapports d'un type de rapport spécifique pour un jour spécifique :

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17

Pour répertorier tous les rapports d'un rapport spécifique, à une heure spécifique d'un jour spécifique :

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17/h=23

Pour télécharger les fichiers correspondant à une date spécifique :


aws s3 cp s3://af-ext-reports/<home-folder>/data-locker-hourly/t=installs/dt=2020-08-01/h=9/part-00000.gz ~/Downloads/

Cyberduck

Avant de commencer :

  • Installez le client Cyberduck.
  • Dans AppsFlyer, accédez à Data Locker et récupérez les informations contenues dans le panneau d'informations d'identification.

Pour configurer Cyberduck :

  1. Dans Cyberduck, cliquez sur Action.
  2. Sélectionnez Nouveau signet. La fenêtre s'ouvre.
  3. Dans le premier champ, (marqué [1] dans la capture d'écran qui suit), sélectionnez Amazon S3.

    DataDuckSmall2.png

  4. Remplissez les champs comme suit :
    • Pseudo : texte libre
    • Serveur : s3.amazonaws.com
    • ID de clé d'accès : copiez la clé d'accès AWS telle qu'elle apparaît dans le panneau des identifiants sur AppsFlyer
    • Clé d'accès secrète : copiez la clé secrète de compartiment telle qu'elle apparaît dans le panneau des identifiants sur AppsFlyer.
    • Chemin : {Bucket Name}/{Home Folder} Par exemple : af-ext-reports/1234-abc-ffffffff
  5. Fermez la fenêtre. Pour ce faire, cliquez sur la croix dans le coin supérieur droit de la fenêtre.
  6. Sélectionnez la connexion.
    Les répertoires de données s'affichent.

Navigateur Amazon S3

Avant de commencer :

  • Installez le navigateur Amazon S3.
  • Dans AppsFlyer, accédez à Data Locker et récupérez les informations contenues dans le panneau d'informations d'identification.

Pour configurer le navigateur Amazon S3 :

  1. Dans le navigateur S3, cliquez sur Comptes > Ajouter Nouveau compte.
    La fenêtre Ajouter un nouveau compte s'ouvre.

    mceclip0.png

  2. Remplissez les champs comme suit :
    • Nom de compte : texte libre. 
    • ID de clé d'accès :copiez la clé d'accès AWS telle qu'elle apparaît dans le panneau des informations d'identification. 
    • Clé d'accès secrète :copiez la clé secrète de compartiment telle qu'elle apparaît dans le panneau des informations d'identification.
    • Sélectionnez Crypter les clés d'accès avec un mot de passe puis saisissez un mot de passe. Notez ce mot de passe quelque part.
    • Sélectionnez Utiliser le transfert sécurisé. 
  3.  Cliquez sur Enregistrer les modifications.
  4. Cliquez sur Compartiments > Ajouter compartiment externe.
    La fenêtre Ajouter un compartiment externe s'ouvre.

    mceclip2.png

  5. Saisissez le nom du compartiment.Le nom de compartiment est au format suivant : {Bucket Name}/{Home Folder}. Les valeurs nécessaires pour le nom du compartiment et le dossier racine s'affichent dans la fenêtre des informations d'identification. 
  6. Cliquez sur Ajouter un compartiment externe.
    Le compartiment est créé et s'affiche dans le panneau gauche de la fenêtre.
    Vous pouvez maintenant accéder aux fichiers Data Locker. 
Cet article vous a-t-il été utile ?