Mise en place de l'attribution mutli-stores Android 

En bref : attribuez vos apps dans plusieurs boutiques Android et consultez les données dans un tableau de bord des apps unique, ou dans un tableau de bord des apps par boutique.

Attribution mutli-stores Android 

AppsFlyer attribue les apps, quel que soit l'app store.  C'est-à-dire le store Google Play et les stores Android tiers comme Amazon, Opera, GetJar, Baidu et Huawei. (En d'autres termes les stores hors-marché ou autres app store Android). Les propriétaires d'app qui commercialisent une app via plusieurs stores peuvent choisir entre un tableau de bord unique avec les données de tous les stores, ou bien un tableau de bord pour chaque store.

 Note

DashboardType_us-en-new.jpg

Tableau de bord unique et tableau de bord par store

  • Tableau de bord unique : un tableau de bord qui regroupe les données de tous les stores, y compris le Google Play Store
  • Tableau de bord par store : tableaux de bord multiples (chaque store a son propre tableau de bord). Ce qui veut dire que vous avez autant de tableaux de bord que de stores proposant l'app.
 

Tableau de bord unique
[Recommandé]

 Tableau de bord par store
Nom du package Android Utilisez le même nom de package (identique) quelle que soit l'option choisie. 
Nom du canal Rien à paramétrer
  • Lorsque vous ajoutez l'app dans le tableau de bord AppsFlyer en utilisant l'option APK Android hors-store , vous devez paramétrer le canal.
  • Le canal identifie le store. 
  • La combinaison entre le nom du package Android et le canal permet d'identifier de manière unique chaque tableau de bord AppsFlyer.
  • Exemple : le nom du package Android est com.abc.def et le canal est xyz_device_store. L'identifiant unique du tableau de bord sera com.abc.def-xyz_device_store.
  • Si l'APK a un paramètre de canal mais qu'il n'y a pas d'app avec ce paramètre, le trafic est attribué à l'app par défaut, c'est-à-dire l'app avec un paramètre de canal non rempli, c'est-à-dire Google Play Store.
Remplissage du champ install_app_store
  • Identifie de manière unique le store qui fournit l'app par téléchargement.
  • Dans le cas du Google Play Store, ce champ reste vide. 
  • Le nom du store est défini dans le manifeste / l'APK.

S/O

Template OneLink Cette méthode est recommandée si vous travaillez avec OneLink.  N/A 
Liens de mesures / d'attribution 
  • Les liens sont les mêmes quel que soit le store.
  • Pour rediriger vers le bon store, utilisez &af_r pour définir l'URL de redirection
  • Un lien unique est requis pour chaque store.
  • Vous pouvez les créer sur la page Integrations actives.
  • L'ID d'app résulte de l'assemblage entre le nom du canal et le nom du package Android. Ex : com.abc.def-def_store.
    Les liens d'attribution seront donc différents.
Options de reporting disponibles avec le champ install_app_store

Les rapports de cohortes et de données brutes comprennent ce champ. Contactez votre CSM pour lui demander d'ajouter le flag de fonctionnalité SFDC requis. 

N/A 

Attention

  • Exactitude des attributions : les réinstallations de différents stores ne gonflent pas le nombre d'installations.
  • Les installations organiques afficheront l'ensemble des installations organiques des APK de tous les stores sur un même tableau de bord.
  • Les options de reporting, ventilées par store, sont actuellement limitées à la cohorte et aux données brutes.
  • Exactitude des attributions : les réinstallations sont comptées, ce qui entraîne une attribution moins précise.
  • Consultez les installations organiques et non organiques ainsi que les données d'évènements in-app pour chaque store (canal) sur les différents tableaux de bord d'app dans AppsFlyer.
  • Utilisez le cohorte pour afficher les rapports combinés de tous les stores
  • Vérifiez que les partenaires avec qui vous travaillez sont actifs (l'option Activer le partenaire est enclenchée) dans tous les tableaux de bord. cela vous permettra d'éviter les différences de résultat (plus fréquentes lors de la comparaison des données avec les SRN).

Opérations de mise en place

La procédure suivante indique les activités requises pour mettre en place l'option souhaitée. Les opérations sont réparties entre le marketeur et le développeur. 

Pour l'option Tableau de bord par store, répétez les opérations pour chaque store. 

Avant de commencer :

  • Convenez d'un type de dénomination pour le canal et les paramètres install_app_store.
  • Utilisez le tableau de dénomination suivant pour unifier les canaux et les stores.
  • Le tableau permet au développeur de préparer les APK. 
Paramètre

Instruction

Tableau de bord unique
[Recommandé]

Tableau de bord par store
Nom du package Android Le nom de package identique pour toutes les options du tableau de bord Si l'app se trouve déjà dans le Google Play Store, utilisez le nom du package existant. Exemple : comb.abc.def
Nom du canal Une valeur unique pour chaque store.

Non défini. Ne pas remplir. 

Unique pour chaque store. Définissez la valeur dans l'APK unique préparé pour le store et lors de l'ajout de l'app dans AppsFlyer. 

Ne définissez pas de canal pour l'APK du Google Play Store. 

App store d'installation AF_STORE Une valeur unique qui identifie le store

Unique pour chaque store. Défini dans l'APK via le manifeste. Chaque store a son propre APK. 

 Non défini

Opérations à effectuer

Étape

Responsable

Tableau de bord unique

Tableau de bord par store
1 Développeur Préparation de l'APK Préparation de l'APK

Marketeur

Aucune action requise. On part du principe que l'app est déjà active dans AppsFlyer.

Ajout de l'app dans AppsFlyer. 
3 Marketeur

Préparation des liens d'attribution 

 

Préparation des liens d'attribution en ajoutant l'ID de l'app au nom du canal. À effectuer sur la page des Intégrations actives en suivant la procédure habituelle.

4 Développeur et marketeur

Test

Test

Procédures

Tableau de bord unique — préparation de l'APK

Le nom du package Android détermine quel tableau de bord contiendra les données d'attribution. Dans la méthode du tableau de bord unique, tous les stores ont le même nom de package Android. Le principe de paramètre de canal ne s'applique pas dans ce cas.

L'identification du store de téléchargement se fait grâce au jeu de paramètres AF_STORE défini dans le SDK, comme expliqué dans ce chapitre.  Le paramètre AF_STORE n'est pas sensible à la casse. Par exemple : ABC, abc, Abc.  

Pour préparer l'APK :

  1. Créez une copie de la version de votre app. Remarque : ne changez pas le nom du package Android. 
  2. Pour identifier le store individuel, utilisez l'une des méthodes suivantes :
    • Méthode via manifeste : ajoutez ce qui suit dans la balise <application> du fichier AndroidManifest.xml pour identifier le store. Réglez le paramètre AF_STORE sur le nom de l'app store.
      <application>
      <meta-data android:name="AF_STORE" android:value="enter_store_name_here">
      </application>
      --OU BIEN--
    • Méthode API : préparer un APK séparé pour chaque app store alternatif. Appelez l'API setOutOfStore pour définir la valeur AF_STORE. Définissez une valeur unique par store.
      AppsFlyerLib.getInstance().setOutOfStore("enter_store_name_here")

La valeur définie ici apparaît dans le champ install_app_store des données brutes d'AppsFlyer. Ce champ est disponible dans :

  • Vue d'ensemble du tableau de bord
  • Tableau de bord des cohortes
  • Les rapports de données brutes (les rapports de données brutes sont une fonctionnalité premium AppsFlyer)

Tableau de bord unique — liens d'attribution

  1. Allez dans Configuration > Integrations actives, et choisissez le réseau publicitaire.
  2. Dans l'onglet Lien d'attribution, réglez le paramètre URL hors store. Cette action renseigne la macro af_r du lien d'attribution pour rediriger les utilisateurs vers la page d'app store qui convient. Par exemple, &af_r=http://www.destinationurl.com L'URL par défaut est définie dans la page Paramètres de l'app. Si l'option n'est pas disponible sur la page Paramètres de l'app, demandez à votre CSM de l'activer pour vous. 
  3. Remplissez la macro af_r avec l'URL de la page d'accueil du magasin.
  4. Définissez les paramètres de lien d'attribution supplémentaires.
  5. Les sources média hors store utilisent la correspondance d'ID pour l'attribution, et la modélisation probabiliste AppsFlyer est utilisée en solution de secours.
  6. Ajoutez un ou plusieurs paramètres d'identifiant utilisateur à l'URL du lien :
    • android_id
    • advertising_id
    • OAID
  7. Copiez le lien d'attribution et transmettez-le au partenaire du ad network.

Tableau de bord par store — Préparation APK

Le nom du package Android combiné à l'ensemble des paramètres du canal définis dans le manifeste détermine quel tableau de bord de store contiendra les données d'attribution. 

Pour préparer un APK/manifeste propre à chaque store :

  • Ajoutez ce qui suit dans la balise <application> du fichier AndroidManifest.xml pour identifier le store. Réglez le paramètre CHANNEL sur le nom de l'app store. 
    <application>
         ...
         <meta-data android:name="CHANNEL" android:value="enter_store_name_here"/>
         ...
    </application>
    Remarque :les paramètres sont sensibles à la casse.

Tableau de bord par store — ajout de l'app

Ajout d'un tableau de bord (app) qui sera identifié par l'assemblage du nom du package Android et du canal définis dans l'APK/le manifeste. Exemple : le nom du package Android est com.monapp et le nom du canal est abcstore. L'identifiant unique du tableau de bord sera com.monapp—abcstore. 

Pour ajouter un tableau de bord par store dans AppsFlyer :

  1. Ouvrez Mes apps, puis cliquez sur Ajouter une app.
  2. Dans store tierce, sélectionnez Android.
  3. Complétez les éléments suivants :
    • Nom du package Android : le nom du package tel qu'il apparaît dans le package de l'app. 
    • Nom du canal : identifiant unique (nom du store) pour différencier les tableaux de bord qui ont le même nom de package. Veillez à utiliser la même valeur dans l'APK préparé pour le store.Remarque : Pour le nom du canal, vous devez utiliser uniquement des lettres majuscules ou minuscules (a-z ou A-Z). Aucun autre caractère, de type trait d'union (-) ou tiret du bas (_), n'est autorisé.
    • URL de l'app :
      • URL de l'app : contient l'adresse URL de téléchargement par défaut qui renseigne la macro af_r dans les liens d'attribution. Saisissez l'URL où l'APK est hébergé, ou l'URL de sa page d'accueil. 
      • Vous pouvez modifier ce paramètre pour chaque lien d'attribution lorsque vous les créez. 
      • Si vous laissez ce champ vide, vous ne pourrez plus jamais définir de page par défaut.
  4. Cliquez sur Suivant.
  5. Suivez les instructions de l'interface pour finir d'ajouter l'application. 

Tests — les deux options du tableau de bord

installations non organiques

Pour tester les installations non organiques :

  1. Utilisez un appareil Android sur lequel votre application n'est pas installée ou bien enregistrez l'appareil.
  2. Générez un lien d'attribution de test à l'aide d'un lien OneLink. Utilisez test comme nom de source média ("&pid=test").
  3. Ajoutez un identifiant publicitaire à l'URL de clic, soit GAID, OAID ou Android ID.
    http://app.appsflyer.com/com.greatapp?pid=test
    &af_r=http://www.destinationurl.com&advertising_id=b5a3-78d9b5-0f12345-xxxx
    Envoyez-vous le lien d'attribution via email et cliquez dessus. Une fois redirigé, n'installez pas l'application depuis le store. Au lieu de cela, installez la version bêta mise à jour de l'application avec le SDK d'attribution d'AppsFlyer intégré et lancez-la.

Tableau de bord unique 

Tableau de bord par store
  1. Vérifiez le rapport des données brutes d'installation de votre app sur la page Données d'exportation.
  2. Vous devriez voir s'afficher une conversion d'installation avec la source média test. Sous la colonne intitulée Installer l'app store, vous devriez voir le nom du store tel qu'il apparaît dans le fichier manifest.xml.
  3. Vous pouvez également voir le paramètre "af_installstore": "STORE_NAME" dans les journaux de l'installation. 
  1. Rendez-vous sur le tableau de bord par app store concerné.
  2. Vérifiez le rapport de données brutes des installations de l'app dans l'onglet Données d'exportation ou bien consultez la page de présentation de l'app.
  3. Vous devriez voir une conversion d'installation avec la source média « test ».

Installations organiques

Pour tester les installations organiques :

  1. Utilisez un appareil Android sur lequel votre application n'est pas installée, ou bien un appareil enregistré.
  2. Installez la dernière version bêta de l'app avec le SDK d'attribution d'AppsFlyer intégré, puis lancez-la.
  3. Vérifiez les résultats :

Résultats attendus

Tableau de bord unique 

Tableau de bord par store
Consultez la page de présentation pour vérifier la présence d'une nouvelle installation organique (sous la source média « organique »). Actuellement, avec la méthode d'app unique, il n'existe aucune indication sur l'origine des installations organiques.
  1. Accédez au dashboard et à l'overview de l'application qui est spécifique au store testé
  2. Vous devriez voir une conversion d'installation sous la source média « organique ».

Fonctionnalités supplémentaires

Migration du tableau de bord par store vers un tableau de bord unique

Pour passer d'un tableau de bord multiple à un tableau de bord unique :
    Préparez de nouveaux APK pour les stores en suivant les instructions pour tableau de bord unique détaillées dans cet article.

Diriger les utilisateurs Facebook vers l'app store Amazon

  1. Configurez un lien URL vers l'app dans les paramètres Meta de votre app, au niveau de la section Android.
  2. Connectez-vous à Meta en tant qu'admin de l'application, allez sur https://developers.facebook.com/apps/, et choisissez l'application.
  3. Allez dans les Paramètres et trouvez vos paramètres Android ou, si vous n'avez pas encore configuré Android, ajoutez la plate-forme.
  4. Remplissez les informations requises, y compris l'URL Amazon App Store spécifique de votre application.

    outofstore_1.png
  5. Dans le tableau de bord AppsFlyer, dans Intégrations actives, sélectionnez Meta ads puis entrez le même identifiant d'app Facebook que celui que vous utilisez pour enregistrer les Meta ads d'installations mobile in-store dans AppsFlyer.

Obtenir les données - Autres méthodes de reporting AppsFlyer

En plus du tableau du bord général, vous pouvez utiliser les méthodes de reporting suivantes dans AppsFlyer.

  • Cohorte :
    • Combinez plusieurs tableaux de bord (apps) en un seul rapport
    • Observez les performances de chaque tableau de bord en les regroupant par install_app_store
  • Pull API (pour app unique) : l'API les données brutes d'installation ne contiennent pas l'app store d'installation par défaut. Pour inclure la colonne, ajoutez ce qui suit à l'appel d'API Pull : &additional_fields=install_app_store
  • Tableau de bord personnalisé (pour apps multiples) : si vous utilisez la méthode des tableaux de bord multiple, servez-vous du tableau de bord personnalisé pour rassembler les données de performance de différentes apps au même endroit.

Implémentation du référent—app stores Android tierces

  • L'attribution des référents est prise en charge en fonction de Google Play et des stores tierces répertoriées ici. 
  • Pour la plupart des app stores tiers, aucun autre paramètre ni configuration n'est nécessaire. Pour Xiaomi, une dépendance supplémentaire doit être configurée. En savoir plus
  • L'attribution par référent de store tierce est signalée dans les rapports de données brutes comme suit :
    • Type de correspondance : le nom de l'app store tierce attribuée. Exemple : huawei_referrer.
    • Contributeur : si l'utilisateur s'est engagé auprès de plusieurs app stores avant d'installer l'app, AppsFlyer considère ces engagements comme des contributeurs. L'installation est accordée à l'engagement du dernier clic. Exemple :
      • Un utilisateur clique sur une annonce diffusée par Google et est redirigé vers le Play Store. L'utilisateur ne télécharge pas l'app.
      • L'utilisateur clique sur une autre publicité et est redirigé vers le Samsung Galaxy Store. L'utilisateur télécharge et installe l'app.
      • L'attribution est attribuée au réseau publicitaire qui a redirigé l'utilisateur vers la boutique Samsung Galaxy ; Google est reconnu comme contributeur. 

Stores Android tiers ayant des intégrations d'attribution par référent avec AppsFlyer

App store tierce À compter de Version du SDK
App store Huawei Juillet 2020 5.4.6 et +, 6.1.1 et +
Store Samsung Galaxy Décembre 2020 6.1.1 et +
Xiaomi GetApps Store Septembre 2022 6.9.0 +

Dépannage

Installations attribuées à l'app par défaut

Si vous créez un APK d'app avec un paramètre de canal mais que vous ne créez pas de tableau de bord pour celui-ci dans le compte AppsFlyer : les installations seront attribuées à l'app par défaut, généralement l'app Google Play Store de votre compte. S'il n'existe pas d'app par défaut, aucune donnée n'est enregistrée pour l'app. 

Particularités et limites

Particularité Remarques
Redirection OneLink vers plusieurs app stores

Plusieurs app stores peuvent être définis dans le template OneLink à la condition que le nom du package d'app soit le même pour tous les app stores.

App store d'installation

Ce paramètre n'est pas disponible pour les agences ou les réseaux publicitaires.