Ajouter une application à AppsFlyer

En bref : découvrez comment ajouter votre application à AppsFlyer pour obtenir des données d'attribution des installations et événements in-app, pour analyser ensuite les données à l'aide des différents outils AppsFlyer.

Présentation

Si vous n'avez pas encore ajouté d'app à votre tableau de bord, la page onboarding de l'app s'affichera lorsque vous vous connecterez à AppsFlyer. L'onboarding de l'app vous guidera étape par étape pour ajouter votre application et la préparer à l'attribution. 

Accéder à l'assistant pour ajouter une application

Vous pouvez accéder à l'assistant d'ajout d'applications depuis la plateforme, ou vous pouvez ajouter votre app via la page d'onboarding de l'app (pour les apps Android et iOS uniquement).

Pour accéder à l'assistant depuis la page d'onboarding de l'app :

  • Dans l'étape Ajouter votre application, cliquez sur Ajouter une app et suivez les instructions.

 Remarque

Si la page d'onboarding n'est pas encore ouverte, cliquez sur Onboarding de l'app dans le menu supérieur > liste déroulante > adresse e-mail

onboarding page.png

Pour accéder à l'assistant depuis la plateforme :

  • Dans le menu supérieur > Mes apps, cliquez sur + Ajouter une app.
  • Sur la page d'accueil d'AppsFlyer, cliquez sur + Ajouter une app 
  • Dans le menu supérieur > adresse e-mail, menu déroulant > Onboarding de l'app, cliquez sur + Onboarding d'une nouvelle app

add an app (1).png

Ajouter une application

Une fois que vous avez ouvert l'assistant Ajouter une app , procédez comme suit :

  1. Saisissez les éléments de l'app.
  2. Saisissez les infos supplémentaires.
  3. Cliquez sur Ajouter mon app.
  4. Copiez la clé Dev à utiliser pour l’intégration du SDK (vous pourrez la récupérer à partir de la page Paramètres de l’app).
  5. Cliquez sur Terminé ou sur + Ajouter une autre app pour ajouter de nouvelles apps.

 Note

  • Seuls les admins et les utilisateurs du compte disposant des autorisations nécessaires peuvent ajouter des applications.
  • Lorsque vous suivez les étapes d'ajout d'une application (ci-dessous), les options disponibles varient en fonction des options précédemment sélectionnées.

Après avoir enregistré l'app, celle-ci apparaîtra dans le tableau de bord. Pour que les installations et les événements in-app soient enregistrés et attribués aux bonnes sources média, vous devez :

  • Intégrer le SDK
  • Connecter l'app aux partenaires dans le Marketplace des partenaires

Voir toutes les étapes du processus d'intégration.

Saisir les infos de l'app

Sélectionnez la plateforme de l'app et entrez les informations requises, comme indiqué ci-dessous :

Android, AndroidTV, Fire

Utilisez cette option pour les plateformes suivantes :

  • Android (mobile)
  • AndroidTV
  • Amazon Fire
  • Amazon Fire TV
  • Kindle
Statut Google Play Quand l'utiliser ? Infos requises

Dans le store

Votre application est actuellement disponible dans le Google Play store

URL de Google Play (copiée depuis Google Play)

  • Exemple : https://play.google.com/store/apps/details?id=com.appsflyer.adNetworkTest& hl=en&gl=GB
  • Important !
    • Si votre app n'est pas listée dans Google Play store États-Unis :
      • L'URL doit inclure le code pays de tout store dans lequel l'app est répertoriée, comme indiqué dans l'exemple ci-dessus : & gl={country_code}. Si vous n'indiquez pas le code du pays, vous recevrez un message d'erreur lorsque vous tenterez d'ajouter l'application.
      • Le code de la langue est facultatif : & hl={language_code}
    • Si votre store est listé dans Google Play États-Unis, les codes de pays et de langue sont facultatifs.

Approbation en attente / non publiée

Votre application n'est pas encore publiée ou attend d'être approuvée par Google Play

Nom du package Android

  • Exemple : com.appsflyer.adNetworkTest
  • Remarque : le nom du package est sensible à la casse
  • Format :
    • Deux segments minimum (un ou plusieurs points)
    • Chaque segment doit commencer par une lettre
    • Tous les caractères sont des chiffres, des lettres, ou des tirets du bas (a-z, A-Z, 0-9 ou _).
    • Longueur maximale du paramètre : 100 caractères.

Pour plus d'informations, consultez la documentation à l'usage des développeurs Android

Store tiers et hors-store

Votre application se trouve dans un app store Android autre que Google Play, et/ou elle peut être téléchargée ailleurs que depuis un app store.

Nom du package Android

Pour connaître les infos détaillées, cf ligne précédente (approbation en attente/non publiée)

Nom du canal : nom unique que vous avez défini pour chaque store tiers/location dans l'APK individuelle préparée pour le store ou la location

  • Exemple : Amazon
  • Format : lettres majuscules ou minuscules uniquement (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 (copiée depuis l'app store tiers ou quelque part hors-store)

 Important !

Si votre application est disponible via plus d'une source (soit tout ensemble de Google Play, d'app stores tiers ou d'emplacements hors store), nous vous recommandons vivement d'étudier les options pour mettre en place une attribution multi-stores Android. Si l'implémentation est la bonne dès le départ, vous pourrez accéder aux données que vous cherchez, et dans le format souhaité.

ioS, tvOS, MacOS

Utilisez cette option pour les plateformes suivantes :

  • iOS
  • tvOS
  • MacOS
Statut de l'app store Quand l'utiliser ? Infos requises

Dans le store

Votre application est actuellement disponible dans l'app store

URL de l'app store (copiée depuis l'app store)

  • Exemple : https://apps.apple.com/us/app/partner-integrations/id1543229303
  • Remarque :
    • vérifiez que l'URL comporte bien le code pays de l'app store à 2 lettres (par exemple, us dans l'URL ci-dessus)
    • Une app qui a été ajoutée à l'app store avant le 14 juin 2019 peut contenir itunes.apple.com dans son URL (à la place de apps.apple.com).
Approbation en attente / non publiée

Votre application n'est pas encore publiée ou attend d'être approuvée par l'app store

 

Pays de l'app store à qui l'app a été soumise

 

ID d'app attribué par l'app store, sans le préfixe id

  • Exemple : 1543229303
  • Format : 9 ou 10 chiffres (0-9)

Windows

Utilisez cette option pour les plateformes suivantes :

  • Windows Phone
  • Windows (ordinateur)
Statut du Microsoft Store Quand l'utiliser ? Infos requises

Dans le store

Votre application est actuellement disponible dans le Microsoft Store

URL Microsoft Store (copiée depuis le Microsoft Store)

  • Exemple: https://www.microsoft.com/en-us/p/wordament/9wzdncrfhwfg
  • Remarque : L'URL ci-dessus est un exemple pour une application Windows Phone. Le format de l'URL varie pour les applications de bureau Windows.
Approbation en attente / non publiée

Votre app n'a pas encore été publiée ou attend d'être approuvée par le store

 

ID d'app attribué par le Microsoft Store

  • Exemple : 9wzdncrfhwfg
  • Remarque : l'ID d'app est sensible à la casse.

web (PBA)

 Note

Une application web permet de définir un site web à inclure dans un bundle de marques pour notre fonctionnalité People-Based Attribution (PBA).

  • Cette option n'est disponible que pour les clients qui ont souscrit à la fonctionnalité PBA.
  • En savoir plus sur l'option PBA et l'attribution des visites web, des événements web et des installations assistées par site web pour obtenir une vue globale des parcours des clients à travers les canaux, plateformes et appareils.

 

URL complète : URL complète du site web dont vous souhaitez mesurer le trafic. Il s'agit du site web sur lequel vous avez ou allez implémenter le SDK web PBA.

URL_diagram

Inclure

  • schéma
  • sous-domaine [facultatif]
  • Nom du domaine
  • domaine de premier niveau
  • chemin [facultatif] l'adresse d'un répertoire ou d'une page de votre site web

Nom de l'app : nom que vous avez choisi pour votre application 

  • Longueur maxi du paramètre : 100 caractères
  • Les balises XSS ne sont pas autorisées

 Important !

Une fois que vous avez créé une application web, vous ne pouvez pas modifier ses propriétés (URL et nom de l'app) sans la supprimer et la recréer. Cela signifie que vous devez également supprimer le bundle de marques dont elle fait partie.

Étapes suivantes :

  • Ajoutez votre nouvelle application web à un bundle de marques PBA pour la voir dans le tableau de bord PBA.
    • Assurez-vous que toutes les apps mobile que vous souhaitez inclure dans le bundle de marques ont été ajoutées à votre compte avant de créer le bundle.
  • Intégrez le SDK web PBA au site web spécifié dans l'app web pour permettre la transmission des données de mesure.

Roku

Nom de l'app : nom du canal copié à partir du tableau de bord de développeur Roku.

  • Exemple : mon canal Roku
  • Format :
    • Longueur maximale du paramètre : 100 caractères.
    • Les balises XSS ne sont pas autorisées

ID de canal : ID numérique attribué au canal par Roku

  • Exemple : 1234567
  • Format :
    • Caractères numériques, 0-9
    • Longueur maxi du paramètre : 50 caractères.
  • Comment le trouver ?
    • À partir du tableau de bord de développeur Roku, cliquez sur le nom du canal que vous ajoutez à AppsFlyer. Cela ouvre la page Aperçu et Publication Roku pour le canal.
    • Le numéro qui apparaît à la fin de l'URL de la page dans votre navigateur est l'ID du canal :

      find_channel_id.png

Vizio SmartCast

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID de l'application telle qu'elle est reconnue par Vizio (commence généralement par les lettres vz). Si vous avez besoin de confirmer l'ID de l'app, contactez votre représentant Vizio.

Samsung Tizen

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID de bundle attribué à votre application par Samsung. Vous le trouverez à la fin de l'URL de l'app store de votre application :

samsung_tizen_url_app_id.png

LG webOS

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID de l'application LG webOS

PlayStation

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID du concept PlayStation, un identifiant unique attribué à un jeu ou à un autre concept de contenu. Il apparaît sous la forme d'un numéro de 5 à 9 chiffres dans l'URL du PlayStation Store :

playstation_app_id_url.png

Vidaa

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID d'application Vidaa

Steam

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID d'app Steam. Il s'agit du numéro de 5-8 chiffres qui apparaît dans l'URL de la boutique Steam :

steam_store_app_url.png

Meta Quest (Oculus)

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID de l'app Meta Quest (tel qu'il apparaît dans le store où l'app a été téléchargée).

  • Exemple : 1903584373052986

Nintendo Switch

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID de l'app Nintendo Switch (tel qu'il apparaît dans le store où l'app a été téléchargée).

Xbox

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID de l'app Xbox (tel qu'il apparaît dans le store où l'app a été téléchargée).

  • Exemple : 9wzdncrfhwfg
  • Remarque : l'ID d'app est sensible à la casse.

Epic Games

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID de l'app Epic Games (tel qu'il apparaît dans le store où l'app a été téléchargée).

Native PC

Nom de l'app : nom que vous avez choisi pour votre application

ID d'app : l'ID de l'application Native PC (caractères possibles : A-Z a-z 0-9 . _ -)

#2 – Saisir les infos supplémentaires (ne concerne pas les apps web) :

  1. Sélectionner une devise

    Sélectionnez la devise qui sera utilisée pour afficher les données de cette application dans le tableau de bord. Les événements de revenus et de dépenses seront convertis dans cette devise en se basant sur le taux de change en vigueur au moment de l'événement. En savoir plus sur le paramétrage de la devise d'une app, et ses effets.

     Important !

    Choisissez avec soin la devise que vous voulez utiliser pour cette app. Vous ne pourrez plus la modifier une fois que les coûts et les revenus auront été enregistrés.

  2. Sélectionner un fuseau horaire

    Synchronisez le fuseau horaire que vous choisissez ici avec celui que vous avez défini avec les autres partenaires d'attribution (comme Meta ads et Google Ads). Vous aurez ainsi la garantie que les données rapportées dans le tableau de bord AppsFlyer et les données que vous recevez de ces mêmes partenaires seront parfaitement accordées. En savoir plus sur le paramétrage de fuseau horaire d'une app, et ses effets.

  3. Paramétrer les indications d'une application destinée aux enfants

    Sélectionnez Oui ou Non pour indiquer si votre application est destinée aux enfants ou au tout public (enfants et adultes).
    Si vous avez sélectionné Oui :

    1. Ouvrez et lisez le guide sur la conformité des applications destinées aux enfants. 
    2. Cochez la case pour confirmer que vous avez lu le guide et que vous mettrez en place les systèmes de vérifications qui y sont détaillés.

       Remarque

      Deux semaines après avoir ajouté l'application, vous recevrez une notification vous demandant de confirmer que vous avez mis en place des contrôles de confidentialité des applications destinées aux enfants. Une fois fait, vous recevrez un message de confirmation. Vous pouvez accéder au message de confirmation à partir du centre de notification, ou consulter les détails de la confirmation dans le journal d'audit.

À propos des applications en attente

Travailler avec une application en attente peut être utile lorsque vous corriger des bugs pour tester le SDK d'AppsFlyer.

Lorsqu'une app a le statut en attente dans le tableau de bord, cela n'affecte ni la collecte ni la mesure des données. Si l'app est en ligne ou en attente sur un app store et que des utilisateurs l'installent et interagissent avec elle, les données des événements d'installation et des événements in-app seront toujours enregistrées dans le tableau de bord.

Une fois que votre app n'est plus en attente et passe en ligne, AppsFlyer détecte et met automatiquement à jour son statut, vous n'avez donc pas à l'ajouter une nouvelle fois. En savoir plus sur les apps en attente et sur l'opération facultative visant à actualiser manuellement leur statut.

Dépannage

Résoudre les problèmes les plus courants :

L'app n'a pas été ajoutée

Si cette erreur se produit, contactez votre CSM ou envoyez un e-mail à hello@appsflyer.com.

L'app n'est pas présente dans le store

Vérifiez que vous avez correctement copié l'URL du store, et que vous avez utilisé le bon nom / ID d'app.

Accès au marché impossible

Ce problème peut survenir si vous ajoutez une app Android depuis un store situé hors des États-Unis. Pour le résoudre, veuillez suivre les étapes suivantes :

  1. Ajoutez l'app avec le statut En attente d'approbation/non publiée, comme décrit ci-dessus.
  2. Allez sur la page AppsFlyer des Paramètres de l'app.
  3. Modifiez le pays de l'app store en choisissant celui qui convient (ex : Japon).

un problème est survenu... Merci de bien vouloir réessayer.

Cette erreur peut s'expliquer par la tentative d'ajout d'une app Android sans code pays (pour les apps non listées dans Google Play Store États-Unis). Voir ci-dessus la marche à suivre pour résoudre ce problème.