Data Locker—connecteur de livraison de données

En bref : Data Locker inscrit les données brutes dans un compartiment sur le Cloud en temps quasi réel (décalage de 6 heures environ). Les données peuvent être inscrites soit dans un compartiment AWS AppsFlyer, soit dans votre propre compartiment AWS ou GCS. 

DataLockerBuckets.png

Data Locker

Principales fonctionnalités de Data Locker

  • Apps : prend en charge plusieurs apps. Des apps supplémentaires peuvent être ajoutées automatiquement.
  • Fiabilité : les données sont stockées dans le référentiel (compartiment) sur le cloud de votre choix
  • Fraîcheur des données  :: un décalage d'utilisation de 6 heures ou quotidien selon le type de rapport. Le décalage est le même (6 heures) quel que soit le fuseau horaire de l'application.
  • Propriété des compartiments :
    • Vous récupérez les données dans un compartiment AWS appartenant à AppsFlyer. Rétention des données : 30 jours.
    • Vous récupérez les données dans un référentiel qui vous appartient (AWS, GCS), via un fournisseur de services Cloud. Rétention des données : décidée par vous. 
  • Changement de compartiments : si vous changez de compartiment, les données sont envoyées aux deux compartiments pendant une période de transition de 7 jours. Cela vous permettra d'aligner votre processus de consommation de données.
  • Abonnement : Data Locker est une fonctionnalité premium uniquement accessible avec un abonnement. Cependant, dans le cas des rapports SKAdNetwork, elles sont disponibles pour tous les comptes dont l'abonnement inclut les données brutes dans leur propre compartiment.
  • Données non converties : les données de clics et d'impressions des campagnes UA et de retargeting sont uniquement disponibles via Data Locker. A propos des clics et des impressions

Rapports disponibles dans Data Locker

Principaux rapports d'attribution : UA et retargeting
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  
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
Attribution basée sur les personnes
Rafraîchissement des données : quotidien
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

* 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 séparées dans des dossiers par heure d'arrivée. Il s'agit de l'heure à laquelle l'événement a été déposé dans Data Locker. Certains dossiers Data Locker sont rédigés environ six heures après l'heure effective de l'événement, en ce qui concerne les événements en temps réel.Il y a 24 dossiers pour chaque heure de la journée, de 0 à 23, et un dossier supplémentaire pour les données qui arrivent en retard.Le décalage est le même quel que soit le fuseau horaire de l'application.

Quotidien : les rapports sont inscrits 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 « Lundi H=23 ». Les données seront disponibles après 10:00 UTC le mardi.

Désinstallation quotidienne : ces rapports sont produits chaque jour et sont généralement disponibles entre 10 h et 12 h UTC. Ils sont habituellement classés dans le dossier h=2. En d'autres termes, le dossier h=2 contient les désinstallations signalées le jour précédent. Il peut cependant arriver que les données soient inscrites dans un dossier plus ancien. Votre processus d'importation doit donc parcourir les données générées dans l'ensemble des dossiers h1-h=24 et h=late de la section des désinstallations. Par exemple, le rapport concernant les 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, ce qui signifie que des données générées le lundi seront disponibles dans le dossier H=23 du lundi, et ce après 06:00 UTC le mercredi.

Architecture Data Locker

Dans votre référentiel de données (compartiment), les données sont classées par type de rapport. Les données de chaque rapport sont stockées dans un dossier propre, ce dossier est divisé d'après l'heure d'inscription des données (cf illustration suivante).

DataLockerFileStructure.png

La structure du dossier Data Locker est la suivante : <cloud service repository>/data-locker-hourly/t=<report type>/dt=<date YYYY-MM-DD>/h=<Hour h où :

  • <cloud service repository> (référentiel de service sur le cloud) est le nom de votre <bucket> (compartiment) et <folder> (dossier). 
    • Dans un référentiel AppsFlyer, le compartiment est ext-reports. Le dossier est défini pour chaque compte et est disponible sur la page de configuration. 
    • Dans le cas de votre propre compartiment, le référentiel est af-datalocker-your folder name.
  • <t=report type> Le type de rapport que contient le dossier
  • <dt= folder date> Le jour où les données ont été inscrites au format aaaa-mm-jj.
  • <h=hours> L'heure (heure) où les données ont été inscrites. Il peut y avoir jusqu'à 25 dossiers horaires. Ces dossiers indiquent l'heure d'arrivée de l'événement, et non pas l'heure où l'événement a eu lieu. Les dossiers ont pour nom h=0, h=1, h=2, etc. jusqu'à h=23 et h=late. Par exemple, le dossier h=0 contient les événements qui arrivent entre 00 h UTC et 01 h UTC, tandis que le dossier h=20 contient les événements qui arrivent entre 20 h UTC et 21 h UTC. Pour les rapports qui sont inscrits au quotidien, seul le dossier h=23 existe. 
  • Dans chaque dossier :

    • Les données peuvent être divisées en plusieurs fichiers afin d'éviter les fichiers volumineux. Les fichiers sont nommés : part-00000, part-00001, part-00002, etc. Il peut y avoir jusqu'à 1000 fichiers. Nous sommes susceptibles d'augmenter ce nombre à l'avenir sans préavis.

    • Le dernier fichier écrit est toujours un fichier vide nommé _SUCCESS. Ce fichier est un indicateur montrant qu'aucune autre nouvelle donnée ne sera inscrite dans le dossier. Par conséquent, ne lisez pas les données d'un dossier avant de vérifier que le fichier _SUCCESS existe. Remarque : l'indicateur _SUCCESS est également écrit s'il n'y a aucune autre donnée à écrire dans le dossier.

  • Dossier Late

    • Le dossier «late» contient les événements de la veille qui sont arrivés après minuit (c'est à dire les événements arrivés le jour d'après entre 00 h et 02 h UTC). Par exemple, lorsqu'un utilisateur installe une application le lundi à 08 h, l'événement arrive le mardi à 01 h et est enregistré dans le dossier tardif du lundi.

    • Le dossier contient également l'indicateur _SUCCESS, comme décrit dans la section précédente.

    • Les données du dossier tardif (« late ») ne sont enregistrées dans aucun autre dossier.

    • Les processus automatisés doivent rechercher les données dans ce dossier de la même manière que pour les autres dossiers.

  • Dossier _temporary
    • 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.

Structure et format de fichier

  • Les fichiers Data Locker sont basés sur l'extraction de données brutes V5 (voir : Exportation de données brutes V5 ).
  • Le fichier de données réel est au format CSV mais il n'a pas d'extension de fichier.
  • Les fichiers de rapport sont compressés en .gz .
  • Chaque fichier a une ligne d'en-tête.
  • Les valeurs qui comportent une virgule sont placées entre guillemets, exemple : `"iPhone6,1"`.

Utilisation de rapports comme sources de données

Vous pouvez utiliser les données des rapports et les ajouter à vos propres bases de données. Pour extraire les données et les ajouter à vos bases de données, vous devez connaître le format du rapport. Les rapports Data Locker sont basés sur des rapports de données brutes. Cependant, le format de rapport final dépend des champs que vous choisissez d'y inclure.

Certains champs font apparaitre le message null 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 spécifiques à l'app n'ont aucun effet sur les données dans Data Locker.

  • Fuseau horaire : les rapports Data Locker utilisent le fuseau horaire UTC
  • Devise : le champ event_revenue_usd est en USD. 

Compartiment AppsFlyer et compartiment Client (AWS ou GCS)

 Attention !

Si vous utilisez la solution de compartiment Client :

  • Veillez à respecter les réglementations relatives à la protection des données, telles que la GDPR et les politiques de conservation des données des réseaux publicitaires/SRN.
  • N'utilisez pas la solution de compartiment Client pour envoyer des données à des tiers. 
  • Les données sont inscrites pour le propriétaire de compartiment de votre choix, comme suit :
    • Compartiment AppsFlyer
    • Compartiment Client—AWS ou GCS
  • Vous pouvez modifier la sélection du compartiment à tout moment.
  • Si vous changez le compartiment :
    • Nous commençons à écrire dans le compartiment nouvellement sélectionné dans l'heure qui suit.
    • Nous continuons d'écrire dans le compartiment 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. 
  Compartiment AppsFlyer (AWS) Compartiment Client (AWS) Compartiment Client (GCS)
Nom du compartiment Définir par AppsFlyer

Défini par vous. Doit comporter le préfixe af-datalocker-.

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

Aucune restriction

Propriété des compartiments AppsFlyer Client Client
Plate-forme de stockage prise en charge AWS AWS  GCS
Autorisations d'accès aux données que vous accordez Disponible dans l'interface utilisateur de Data Locker pour l'admin Inconnu par AppsFlyer. Utilise vos identifiants AWS. Inconnu par AppsFlyer. Utilisez vos identifiants GCS.
Conservation des données Les données sont supprimées après 30 jours Votre responsabilité Votre responsabilité
Demandes de suppression de données Responsabilité d'AppsFlyer Votre responsabilité Votre responsabilité
Sécurité AppsFlyer contrôle le compartiment. Le client a un accès en lecture seule. Le client contrôle le compartiment. AppsFlyer nécessite l'autorisation de GetObject, ListBucket, DeleteObject, PutObject pour le compartiment. Le compartiment doit être soumis à l'utilisation exclusive d'AppsFlyer. Ne l'utilisez pas à d'autres fins. Le client contrôle le compartiment. AppsFlyer nécessite certaines autorisations comme indiqué dans l'article de configuration GCS. Le compartiment doit être soumis à l'utilisation exclusive d'AppsFlyer. Ne l'utilisez pas à d'autres fins.
Espace de stockage Géré par AppsFlyer Géré par vous Géré par vous
Contrôle de l'accès à l'aide de points de terminaison VPC avec règles de compartiment Non applicable [Facultatif] Si vous installez la sécurité des points de terminaison VPC au niveau compartiment dans AWS, vous devez autoriser les serveurs AppsFlyer.  S/O
Rapports de SKAdNetwork Uniquement disponible avec un abonnement à Data Locker Disponible si vous avez un abonnement aux données brutes. indépendamment de l'abonnement à Data Locker Disponible si vous avez un abonnement aux données brutes. indépendamment de l'abonnement à Data Locker

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

Vous pouvez avoir l'impression que nous demandons beaucoup d'autorisations, mais considérez ce qui suit :

  • Le compartiment doit être soumis à l'utilisation exclusive d'AppsFlyer. Aucune autre entité ne doit écrire dans le compartiment.
  • Vous pouvez supprimer des données dans le compartiment 25 heures après leur écriture.
  • Les données que nous écrivons dans le compartiment sont une copie des données déjà présentes dans 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, nous devons parfois supprimer les données et les réécrire. C'est la raison pour laquelle nous avons besoin de supprimer et de répertorier les autorisations. Les listes et les suppressions ne constituent pas un risque pour votre sécurité. Dans le cas de la liste, nous sommes la seule entité qui écrit dans le compartiment. Dans le cas de la suppression, nous sommes en mesure de régénérer les données.

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.

Vous pouvez utiliser n'importe lequel des compartiments suivants :

  • Compartiment AWS détenu et fourni par AppsFlyer (effectuer la procédure qui suit). Remarque  : cette option n'est pas disponible si vous obtenez des données brutes de SKAdNetwork sans abonnement à Data Locker.
  • Votre compartiment AWS.
  • Votre compartiment GCS

Condition préalable à la mise en place de votre compartiment :

Si vous configurez Data Locker en utilisant votre compartiment, c'est-à-dire un compartiment qui vous appartient, complétez la procédure AWS ou GCS appropriée avant de continuer.

Lorsque vous migrez d'un compartiment à un autre, nous continuons d'envoyer des données au compartiment existant pendant une période de transition de 7 jours. Important ! Vous devez mettre à jour vos processus de consommation de données avant l'expiration de la période de transition. La période de transition peut être réinitialisée à 7 jours (extension) en rétablissant le type de compartiment, en enregistrant, puis en sélectionnant à nouveau votre compartiment.

 

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 la méthode d'intégration. Sélectionnez l'une des options suivantes
    • Compartiment AWS AppsFlyer. Passez à l'étape 4. 
    • Compartiment AWS client.
      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 indiquant que le chemin du compartiment n'est pas valide.
  4. Sélectionnez une, plusieurs ou l'ensemble des apps. Sélectionnez tout pour inclure automatiquement les apps que vous ajouterez par la suite.
  5. Cliquez sur Appliquer
  6. [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.
  7. Sélectionnez un ou plusieurs types de rapport.
  8. [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.
  9. Cliquez sur Appliquer
  10. (facultatif) Champs (par défaut=Tout): Sélectionnez les champs à inclure dans les rapports. Remarque : nous ajoutons des champs de temps en temps, veuillez en tenir compte dans votre processus d'importation des données.
  11. 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é le compartiment AWS client :
      • Les données commenceront à être écrites dans votre compartiment AWS dans un délai de 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 écrit vos données dans un compartiment S3 qui vous appartient. 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.

Récupération des données

Utilisez votre outil de recherche de données S3 habituel, AWS CLI, ou l'un des outils décrits dans les sections qui suivent.

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 des informations d'identification. Ces informations sont nécessaires pour effectuer cette procédure.

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 volet des identifiants. Vous aurez besoin de ces éléments pour configurer Cyber Duck. 

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 la section 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 informations d'identification dans 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 des informations d'identification. Ces informations sont nécessaires pour effectuer cette procédure.

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. 

Informations supplémentaires

Particularités et limites

Particularités
Particularité Remarques 
Réseaux publicitaires Non utilisé pour les ad networks.
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 de plusieurs apps. Data locker est au niveau du compte

Considérations pour les développeurs

Lors de la préparation de scripts pour le chargement de données dans vos systèmes, tenez compte des points suivants :

  • Dossier temporaire :
    • Dans certains cas, il reste un dossier temporaire. Vous devez ignorer ce dossier. Exemple : /data-locker-hourly/t=inapps/dt=2020-11-13/h=2/_temporarary/0/_temporary/.
    • N'utilisez que les dossiers contenant l'indicateur _SUCCESS
  • Séquence des colonnes dans les rapports : 
    • 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. La liste des champs dans l'interface utilisateur est séquencée en conséquence.

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
Cet article vous a-t-il été utile ?