Configuration de l’intégration des Meta Ads

En bref : apprenez à intégrer les Meta ads avec AppsFlyer.

Guide de configuration des Meta Ads

Combien de temps faut-il pour attribuer vos publicités Meta ads pour app mobile avec AppsFlyer ?

Si vous avez déjà intégré le SDK AppsFlyer à votre app, et que vous avez déjà défini votre app sur Meta ads, la réponse est : moins d'une minute 

Vous n'avez pas besoin d'implémenter Facebook Login ou d'intégrer votre app au SDK de Facebook pour l'attribution mobile. Il vous suffit de suivre les instructions de configuration détaillées ci-dessous. Ensuite, consultez les options de configuration avancées pour Meta ads.

ID d'app Facebook

Pour intégrer des Meta Ads dans AppsFlyer, vous devez d'abord créer puis récupérer l'ID d'app Facebook. 

Pour créer l'ID d'app Facebook :

  1. Dans Meta ads, rendez-vous dans le tableau de bord de votre app.
  2. Dans Apps, cliquez sur Créer une nouvelle app.
  3. Indiquez le nom de votre app, et saisissez un espace de noms unique. Veillez à ajouter la bonne plateforme pour votre application, dans le cas contraire les installations risquent de ne pas être attribuées correctement.

Pour récupérer l'ID d'app Facebook :

  1. Dans Meta ads, rendez-vous dans le tableau de bord de votre app.
  2. Cliquez sur l'application concernée.
  3. Cliquez sur l’ID de l’app, qui apparaît en haut à gauche de l’écran, pour le copier.

    FB-app-id-2-blur.png

AppsFlyer attribue les données en fonction des ID d'app. Un même ID d'app Facebook peut être utilisé à la fois pour vos apps Android et iOS. Notez que pour iOS 14 et +, Meta Ads limite le nombre de comptes par application à 9.

Configuration de base de l'attribution Meta ads

Pour commencer l'attribution de campagnes Meta Ads avec AppsFlyer, procédez comme suit :

 
 
  1. Pour activer l'intégration avec les Meta Ads :
    1. Rendez-vous dans vos apps dans Meta pour les développeurs.
    2. Sélectionnez l'application.

      FB-for-devs-app-selecrion-en_us.png

    3. Pour copier votre ID d'app, cliquez dessus (en haut de l'écran).

      FB-for-devs-app-ID-copy-en_us.png

    4. Dans AppsFlyer, allez dans Configuration et ouvrez Marketplace des partenaires
    5. Recherchez Meta Ads et sélectionnez-le.
    6. Cliquez sur Configurer l'intégration. Vous êtes alors dirigé vers la page de configuration de l'intégration.
    7. Dans l'onglet Integration , cochez Activer le partenaire.
      Remarque : La case doit rester cochée (option activée) tant que vous travaillez avec le partenaire.
    8. Sous Paramètres généraux :

      meta_ads_general_settings2.png

      • Collez votre ID d'app dans le champ ID d'app Facebook.
      • Collez la clé de décryptage du référent d'installation à partir de Meta ads
    9. Cliquez sur Enregistrer l'intégration.
  2. [facultatif] Pour configurer les paramètres recommandés :

    meta_ads_install_attribution.png

    • Pour que la fenêtre rétrospective post-clic concorde avec Meta Ads, vous devez la définir sur 7 jours.
      (sachez que dans certains cas la valeur par défaut est différente).
    • Pour que la fenêtre rétrospective post-vue soit accordée aux Meta Ads, définissez-la sur 1 jour.
    • Pour attribuer les utilisateurs qui réinstallent l'app au cours de la fenêtre de réattribution, activez Attribution de réinstallation.
      Il n'est pas nécessaire d'activer l'attribution post vue ou de configurer des fenêtres rétrospectives pour l'attribution de réinstallation, car les valeurs sont extraites des paramètres d'attribution d'installation.

Vous ne voyez toujours pas les résultats sur AppsFlyer ? Veuillez consulter Résolution des problèmes d'intégration des Meta Ads.

Configuration de base de l'attribution Meta ads

Avec l'attribution de base déjà configurée pour Meta ads, il est temps de mettre en place une configuration d'attribution avancée rapide.

 
 

Données de niveau utilisateur

Depuis le 29 octobre 2021, seuls les rapports agrégés sont disponibles pour les annonceurs. Cela signifie que les données d'attribution par vue et par clic apparaissent comme restreintes dans les rapports de données brutes. Tout autre champ en lien avec la source média n'est pas renseigné. Voir : restriction du contenu des données brutes

Cela s'applique à tous les annonceurs, systèmes d'exploitation et MMP. Cela concerne les données au niveau de l'appareil pour tous les utilisateurs d'iOS et d'Android, indépendamment du statut de consentement ATT ou de la personnalisation des annonces.

AppsFlyer continue à recevoir des données au niveau des appareils de la part de Meta ads. Cela signifie que nos capacités d'attribution et de rapports (y compris : attribution multi-touch, LTV, ROI, cohorte, rapports de rétention, protection contre la fraude, Audiences, et autres services) restent inchangées. Voir : outils d'agrégation et de rapport analytique.

Comment obtenir des données de niveau utilisateur pour les installations Android ?

Bien que les données de niveau utilisateur soient restreintes, Meta Ads partage les métadonnées de campagne avec les annonceurs pour les publicités d'app Android qui dirigent vers le Google Play Store. Dans ce cas, les champs d'attribution sont disponibles pour les annonceurs dans l'API de référent d'installation Google qui doit être intégré à votre app. Les champs fournis par le référent sont renseignés dans les rapports de données brutes AppsFlyer, ceux-ci sont accessibles une fois que la clé de déchiffrement est soumise et qu'une installation est attribuée aux Meta Ads. Cela permet à AppsFlyer d'attribuer les utilisateurs qui n'ont pas d'identifiant publicitaire (LAT activé). Notez que le référent d'installation Google Play ne s'applique pas aux campagnes de retargeting.

Champs d'attribution de campagne disponibles via le référent :

  • Identifiant de publicité
  • Nom de la publicité
  • Identifiant de l'ensemble de publicités
  • Nom d'adset
  • Identifiant de la campagne
  • Nom de la campagne
  • ID de compte
  • Canal

 Remarque

  • Le SDK AppsFlyer V5.4.0 et + est nécessaire pour que les données de référence soient transmises correctement. Les données de référence ont la priorité sur les données fournies par l'API, et elles ne sont pas limitées. Cette solution s'applique à l'attribution post clic et non à l'attribution post vue.
  • Le champ Canal est déterminé par la valeur du canal reçue de l'API Google Play Referrer (envoyée à Google Play par Meta). Si une chaîne vide est renvoyée, le champ Canal indique "Aucune". 

Données cryptées provenant de l'API Google Play Referrer 

Les données du référent sont cryptées par Meta puis décryptées à l'aide d'une clé disponible dans votre compte de développeur Meta. Vous devez nous fournir la clé de décryptage telle que décrite dans les actions requises. La clé de décryptage doit être soumise une seule fois par app.

Notez que si la clé n'est pas fournie ou a été supprimée, il y a des cas où les Meta Ads sont toujours attribués pour l'installation provenant d'un référent, et ce même en l'absence des champs d'attribution de la campagne (mentionnés dans la liste ci-dessus). Cela se produit lorsque :

  • Les Meta ads n'ont pas revendiqué l'installation
  • Les données reçues de l'API Google Play Install Referrer n'ont pas été décodées.
  • C'était le dernier clic.

Pour obtenir votre clé de décryptage depuis Meta :

  1. Connectez-vous au portail des développeurs Meta.
  2. Accédez à Mes Apps dans le coin supérieur droit.
  3. Sélectionnez l'app pour laquelle vous souhaitez accéder à votre clé de décryptage.
  4. Accédez à Paramètres > Basique sur la gauche de la page.

  5. Faites défiler l'écran vers le bas jusqu'à la section Android. Vous pourrez accéder à votre clé de décryptage avec le message « Clé de décryptage du référent d'installation », sous le champ Package Name. Remarque : il s'agit de la même section dans laquelle vous avez configuré le nom de votre package et le Google Play Store.

Pour définir la clé de décryptage dans AppsFlyer :

  1. [Obligatoire] Vérifiez que votre app utilise AppsFlyer SDK V5.4 et +. Ne vous fiez pas aux versions antérieures.
  2. Dans AppsFlyer, allez dans Configuration > Intégrations actives.
  3. Sélectionnez Meta ads.
    meta_ads_general_settings2.png
  4. Dans l'onglet Integration, collez la clé dans Clé de décryptage du référent d'installation. Cette opération doit être effectuée une seule fois par app.
  5. Cliquez sur Enregistrer l'intégration.

Coûts, clics et impressions

meta_cost_tab.png

Cette intégration fournit des données agrégées sur les coûts, les clics et les impressions pour vos campagnes, vos ensembles de publicités, vos publicités et vos zones géographiques/pays. Consultez le tableau d'intégration des coûts du réseau publicitaire pour obtenir plus d'infos sur les dimensions, les métriques et les fonctionnalités prises en charge.

Remarque : les données sur les clics et les impressions sont incluses dans l'intégration. Cependant, les données sur les coûts nécessitent un abonnement à ROI360.

Pour activer l'API de coûts :

  1. Assurez-vous que vous êtes connecté au compte utilisateur Meta ads, qui est activé pour gérer les campagnes du compte sur Meta ads. L'utilisateur qui se connecte doit disposer des permissions nécessaires pour exécuter toutes les campagnes dans Meta Business Manager.
  2. Rendez-vous dans l'onglet Coût.
  3. Activez Obtenir les données de coût, de clic et d'impression.
  4. Cliquez sur le bouton f login.
  5. Lorsque vous y êtes invité, autorisez AppsFlyer à accéder aux données de votre campagne Meta ads.
    Remarque : pour la première synchronisation des données après intégration, et pour les synchronisations suivantes, AppsFlyer reçoit les données de coût de Meta ads des 7 derniers jours.

En savoir plus sur la façon dont Meta ads définit les clics et les vues.

Pour supprimer un compte Meta ads connecté : dans la colonne des actions, survolez un compte et cliquez sur Supprimer la connexion.

 Remarques

  • Si vous êtes déjà connecté à Meta ads, lorsque vous cliquez sur le bouton f login, la fenêtre s'ouvre et se referme immédiatement. C'est tout à fait normal.
  • Si vous avez plusieurs utilisateurs disposant d'autorisations sur Meta ads, la meilleure solution consiste à exécuter la fonction login pour chacun d'entre eux, ce qui vous évitera de recevoir des données partielles.

État de synchronisation des données de coût

Permet d'afficher le statut de votre API de coûts et de savoir quand AppsFlyer a pu extraire pour la dernière fois les données de coûts correspondantes. Ces éléments se trouvent dans le tableau de bord du statut d'intégration des coûts (et des revenus publicitaires), ou dans le tableau de bord du réseau publicitaire personnel.

Vous pouvez synchroniser plusieurs comptes pour extraire des données de coûts. Pour chaque compte synchronisé, AppsFlyer indique le statut d'intégration du coût, et la dernière fois où AppsFlyer a pu extraire les données de coûts correspondantes.

En savoir plus sur l'enrichissement de vos données avec les données de coûts, de clics et d'impressions.

Mappage d'événements in-app

In-app_event_postbacks_en-us.png

 

Pour mapper des événements in-app :

  1. Activez Postbacks d'événements in-app.
    Lorsque vous activez la première fois le mappage des événements d'app Meta pour une app, af_app_open est automatiquement mappé à session_start.
  2. Remplissez les paramètres suivants :
    Nom du paramètre Description
    Événement AppsFlyer

    Le nom de l'événement tel que reçu par AppsFlyer, soit depuis le SDK intégré à votre app, soit depuis les événements de serveur à serveur.
    Astuce : vous ne voyez pas s'afficher un événement en particulier ?

    • Assurez-vous d'activer l'évènement sur un appareil avec une installation non-organique et revérifiez.
    • Saisissez-le dans Événement AppsFlyer puis cliquez sur Créer événement personnalisé. En savoir plus sur le mappage d'événements personnalisés.
    mappé à l’événement partenaire

    Le nom ou l'ID unique de chaque événement, tel que défini du côté de Meta ads. Les différentes configurations du mapping sont :

    • Champ de texte : pour obtenir l'ID d'événement correspondant dans Meta ads
    • Liste déroulante : sélectionnez l’événement AppsFlyer prédéfini approprié.
    • Tel quel : envoyez les événements à l'état brut, sans mappage du nom.
    pour les utilisateurs de

    Sélectionnez l'option d'envoi pour l'événement :

    • Ce partenaire uniquement : envoie des postbacks exclusivement lorsque cet événement est attribué à Meta ads.
    • Toutes les sources média, organiques comprises : envoie des postbacks pour les événements attribués à n'importe quel partenaire ou n'importe quel événement organique.
    Y compris
    • Aucune donnée (par défaut) : envoie uniquement l'événement en lui-même mais sans sa valeur.
    • Valeurs et revenus : envoie tous les paramètres de l’événement, y compris la valeur de revenu (si présente dans l’événement).
    • Avec valeurs et sans revenu : envoie tous les paramètres à l'exception de la valeur de revenu.
  3. Pour ajouter à la liste un événement SDK ou de serveur à serveur , cliquez sur Ajouter un événement.

Limitations concernant les noms d'événements: :

  • Limitation de la longueur des noms d'événements : 2 à 40 caractères 
  • Les caractères suivants ne sont pas autorisés :
    • Deux points (:)
    • Point (.)
    • Caractères non latins (anglais) : depuis le 12 janvier 2020, Meta ads rejette les caractères de l'alphabet chinois. AppsFlyer n'a pas encore testé les autres alphabets. Vous ne devez les utiliser qu'après avoir vérifié auprès de Meta ads s'il prend en charge ce type de caractères dans les postbacks. 
  • Les noms d'événements sont sensibles à la casse. Pour éviter les incohérences, assurez-vous d'utiliser le bon nom d'événement pour toutes les sources média et versions d'app.

En savoir plus sur le mappage des événements in-app des Meta ads.

Attribution de retargeting

L'attribution de retargeting AppsFlyer pour les Meta Ads permet aux annonceurs d'attribuer l'engagement d'un utilisateur existant à une Facebook Ad, et de mesurer la qualité post engagement de ce même utilisateur en se basant sur les rapports AppsFlyer. Cette fonctionnalité ne doit être utilisée que si vous exécutez des campagnes ciblant vos propres utilisateurs Facebook.

  1. Activez le retargeting sur la page Paramètres de l'app.
  2. Sur la page Partenaire des Meta Ads, activez l’attribution de réengagement.
  3. Définissez la fenêtre rétrospective de réengagement post clic.
    La fenêtre rétrospective démarre au moment du clic sur la publicité, c'est la période pendant laquelle l'app doit être lancée pour que le clic soit enregistré en tant que réengagement.
    Sélectionnez les unités de mesure de la fenêtre rétrospective (heures ou jours) puis réglez le curseur sur la valeur souhaitée.

    re-engagement_attribution_toggle.png

  4. Activez l'attribution de réengagement post vue.
  5. Définissez le curseur de la fenêtre rétrospective post vue de réengagement sur la valeur souhaitée (24 heures maximum). Il s’agit de la période qui commence au moment de de l'impression publicitaire, et durant laquelle l’application doit être lancée pour que l’impression soit enregistrée comme réengagement.

    re-engagement_view-through_toggle.png

  6. Définissez la fenêtre de réengagement.
    C'est la période durant laquelle les évènements in-app de l'utilisateur sont attribués à la source média de retargeting, en tant que source principale.
    Vous pouvez définir la valeur en jours (1-90), en heures (jusqu'à 23) ou même en valeur vie. La valeur par défaut est 30 jours.

    re-engagement_window.png

En savoir plus sur l'Attribution de retargeting AppsFlyer.

En savoir plus sur les utilisateurs de deep linking issus des SRN tels que Meta ads.

Être conforme avec le California Consumer Privacy Act (CCPA)

Le respect des règles de confidentialité de la CCPA limite les données provenant des utilisateurs Meta ads qui sont basés en Californie, États-Unis.

Pour vous conformer aux règles de la CCPA : rendez vous dans l'onglet Intégration puis activez Limiter l'utilisation par Meta ads des données personnelles des utilisateurs (CCPA).

En savoir plus sur les lois relatives à la protection des données.

Enregistrement des revenus publicitaires

mceclip0.png

Si votre app utilise les revenus publicitaires du réseau Meta Audience pour la monétisation publicitaire, vous pouvez enregistrer dans AppsFlyer vos revenus issus de Meta ads. Cette opération, que ce soit avec ou sans les données de revenus d'achat in-app, vous procure une vue d'ensemble de vos revenus par utilisateur.

Pour enregistrer les revenus publicitaires du réseau Audience Meta :

  1. Dans l'onglet Revenus publicitaires, activez Obtenir les données de revenus publicitaires.
  2. Sélectionnez le type de données des revenus publicitaires agrégés que vous souhaitez recevoir = Revenus attribués et/ou Revenus de monétisation agrégés:
    • Revenus attribués : revenus basés sur la source d'acquisition d'utilisateur.
      Définissez la Source de l'événement, autrement dit l'événement offrant votre meilleur modèle de revenu publicitaire. Par exemple, si vos revenus sont basés sur des impressions, il est recommandé d'envoyer à AppsFlyer un événement ad_viewed. Le meilleur événement peut être configuré séparément pour chaque plateforme de monétisation. Cependant, il est également possible d'utiliser l'événement af_app_opened. Dans ce cas, les revenus publicitaires sont attribués pour chaque ouverture d'application exécutée par l'utilisateur.
    • Revenus de monétisation agrégés : revenus basés sur la source publicitaire.
  3. L'événement revenus publicitaires s'affiche. Ce champ en lecture seule présente le nouvel événement de revenu publicitaire appelé [source event]_monetized (ex : Ad_Watched_Monetized comme affiché ci-dessus). L'événement de revenus publicitaires apparait comme un événement supplémentaire dans le tableau de bord.
  4. Cliquez sur Connecter à Meta ads pour activer la collecte des revenus publicitaires du réseau Meta Audience sur Meta ads. Connectez-vous avec vos identifiants Meta ads pour autoriser les revenus publicitaires du réseau Audience Meta.
  5. Saisissez l'ID d'app du réseau Audience (ID d'app Facebook). Vous pouvez l'obtenir auprès du réseau Meta Audience.
  6. Cliquez sur Enregistrer les revenus publicitaires.

Autorisations

Autorisez les Meta ads à effectuer différentes actions et à accéder à vos données selon les autorisations accordées.

En savoir plus sur les autorisations accordées aux partenaires intégrés.

Dépannage de l'intégration des Meta ads

Si vous avez complété l'intégration de base et que vous ne voyez toujours pas les résultats de Meta ads sur le tableau de bord AppsFlyer, vérifiez si vous avez eu des nouvelles installations de Meta ads depuis l'intégration.

Dans l'affirmative, consultez les raisons principales ci-dessous pour résoudre ce problème :

Aucune collecte IDFA

Comme indiqué dans le Guide d'intégration SDK - iOS, vous devez ajouter AdSupport.framework à votre projet pour que la collection IDFA puisse avoir lieu. Vérifiez le rapport Données brutes d'installation pour voir si la colonne IDFA est effectivement vide ou pas. Nous vous recommandons d'autoriser votre app à collecter l'IDFA dans le cadre des apps iOS, et le GAID dans le cadre des apps Android.
Depuis iOS 14.5 vous devez afficher la fenêtre Apple ATT et obtenir le consentement de l'utilisateur avant de pouvoir collecter l'IDFA.

Remarque : l'attribution SKAdNetwork n'est pas affectée par la disponibilité de l'IDFA. Pensez malgré tout à activer l'option « campagne iOS 14 » dans Facebook lorsque vous configurez les campagnes iOS 14. Pensez malgré tout à activer l'option « campagne iOS 14 » dans les Meta Ads lorsque vous configurez les campagnes iOS 14.

ID d'app Facebook incorrecte

L'ID d'app Facebook a été mal configuré dans AppsFlyer.
Vérifiez que l’ID d’app est correct et qu'il se retrouve dans le tableau de bord des Meta Ads.

Remarque : vous pouvez également utiliser l'API Grap de Facebook pour valider votre ID d'app Facebook.

Statut de l'application sur Meta ads

Pour garantir le bon fonctionnement de l'attribution, l'app doit être définie sur Meta ads comme Live plutôt que En développement .

fb-app-status.png

Mauvais type de campagne Meta ads

Vérifiez que la campagne Meta ads repose sur des publicités d'installation d'app mobile ou sur l'engagement d'app mobile. Si d'autres objectifs de campagne sont définis (ex :Link Click pour les pages d'accueil), pour avoir accès à le mesure des installations mobile l'annonceur doit cocher l'option Enregistrement d'événements d'app lorsqu'il configure la campagne Meta ads.

Installation d'une app Meta ads

Lors de la configuration de la campagne d'installation d'app Meta ads, vous pouvez sélectionner l'app dans une liste déroulante, ou bien coller l'URL complète de la boutique directement dans l'app. Les deux méthodes fonctionnent avec Meta ads, mais la seconde ne permet pas l'attribution AppsFlyer.

Configuration correcte - réussite de l'attribution.

fb-app-install.png

Configuration incorrecte - échec de l'attribution.

fb-app-incorrect_setup.png

Mise à jour des Meta Ads

 Important !

Depuis le 29 octobre 2021, seuls les rapports agrégés des Meta ads sont disponibles pour les annonceurs. Cela inclut les installations et les événements in-app. Cela s'applique à tous les annonceurs, systèmes d'exploitation et MMP. Cela concerne les données au niveau de l'appareil pour tous les utilisateurs d'iOS et d'Android, indépendamment du statut de consentement ATT ou de la personnalisation des publicités.Les données brutes pour les installations et les événements in-app effectués avant le changement (29 octobre 2021) continuent d'être disponibles.
Notez que les données relatives aux utilisateurs peuvent être reçues via le référent Google Install. 
Consultez le bulletin d'informations pour plus de détails.

Mises à jour d'iOS 14 concernant les Meta Ads

AppsFlyer confirme que notre intégration de la MMP avec Meta ads implémente systématiquement le drapeau Suivi d'annonceur activé. Ce qui signifie qu'aucune action n'est requise de votre part au niveau d'AppsFlyer. Ces informations sont fournies conformément à la liste de vérification iOS 14 pour l'app Meta ads publiée en février 2021.

Lectures connexes : L'interopérabilité entre SKAdNetwork et AppsFlyer. Consultez cet article pour ce qui concerne les campagnes sur iOS 14.