Configuration de l'intégration des Publicités Facebook

En bref : apprenez à intégrer les Facebook Ads avec AppsFlyer.

Guide de configuration Publicités Facebook

Combien de temps faut-il pour attribuer vos publicités Facebook 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 Facebook, 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 Facebook.

ID d'app Facebook

Pour intégrer des publicités Facebook 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 Facebook, ouvrez votre Tableau de bord d'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 Facebook, ouvrez votre Tableau de bord d'app.
  2. Cliquez sur l'application concernée.
  3. Pour copier l'ID d'app Facebook, cliquez dessus (en haut de l'écran).

    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 +, Facebook Ads limite le nombre de comptes à neuf par application.

Configuration de base d'attribution de Facebook

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

 
 
  1. Pour activer l'intégration avec les Facebook Ads :
    1. Rendez-vous dans vos apps dans Facebook 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, ouvrez Configuration > Partenaires intégrés.
    5. Sélectionnez les Facebook Ads dans la liste des partenaires.
    6. Dans l'onglet Intégration, cochezActiver le partenaire.

      Activating-integration-with-FB-en_us.png

      En savoir plus sur l'activation d'un partenaire.
    7. Collez votre ID d'app dans le champ ID d'app Facebook.
    8. Cliquez sur Enregistrer l'intégration.
  2. [facultatif] Pour configurer les paramètres recommandés :

    FB-recommanded-settings-en_us.png


    1. Pour que la fenêtre rétrospective post-clic concorde avec les Facebook Ads, vous devez la définir sur 7 jours
      (sachez que dans certains cas précis la valeur par défaut est différente).
    2. Pour que la fenêtre rétrospective post-vue soit accordée aux Facebook Ads, définissez-la sur 1 jour.
    3. 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.
    4. Pour enregistrer la configuration, cliquez sur Sauvegarder l'intégration.

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

Configuration avancée d'attribution de Facebook

Avec l'attribution de base déjà configurée pour Facebook, 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 Facebook. 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, Facebook 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 le référent d'installation Google qui doit être intégré à votre app. Les champs fournis par le référent peuplent les rapports de données brutes AppsFlyer, auxquelles vous pouvez accéder une fois que la clé de déchiffrement est soumise et qu'une installation est attribuée aux publicités Facebook. Cela permet à AppsFlyer d'attribuer les utilisateurs qui n'ont pas d'identifiant publicitaire (activé LAT).

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 ne sont pas limitées. Cette solution s'applique à l'attribution post clic et non à l'attribution post vue. 

Les données du référent sont cryptées par Facebook puis décryptées à l'aide d'une clé disponible dans votre compte de développeur Facebook. 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ù Facebook Ads est toujours attribué pour l'installation provenant d'un référent - même sans les champs d'attribution de la campagne (mentionnés dans la liste ci-dessus). Cela se produit lorsque :

  • Facebook Ads n'a pas revendiqué l'installation
  • Le référent d'installation Facebook a bien été reçu mais il n'a pas été décodé
  • C'était de plus le dernier clic.

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

  1. Connectez-vous au portail des développeurs Facebook.
  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, rendez-vous dans Configuration > Partenaires intégrés.
  3. Sélectionnez Facebook.

    FB-for-install-referrer-decryption-key2.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.

Données sur le coût, les clics et les impressions

fb-cost-tab.png

L'activation de la fonction Coût Facebook vous permet d'obtenir les données de coût pour vos campagnes, ad sets, publicités Facebook, et pour vos niveaux de canaux.  Elle vous permet également d'obtenir les données agrégées sur les clics et les impressions qui y sont liées. Consultez le tableau d'intégration des coûts du réseau publicitaire pour en savoir plus sur les dimensions, les métriques et les fonctionnalités prises en charge. Remarque : les données de coût nécessitent un abonnement Xpend.

Pour activer l'API de coûts :

  1. Assurez-vous que vous êtes connecté au compte utilisateur Facebook, qui est activé pour gérer les campagnes du compte sur Facebook. L'utilisateur qui se connecte doit disposer des permissions nécessaires pour exécuter toutes les campagnes dans Facebook 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 de connexion à Facebook.
  5. Lorsque vous y êtes invité, autorisez AppsFlyer à accéder aux données de votre campagne Facebook.
    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 Facebook des 7 derniers jours.

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

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

 Remarques

  • Si vous êtes déjà connecté à Facebook, lorsque vous cliquez sur le bouton de connexion à Facebook, la fenêtre Facebook s'ouvre et se ferme immédiatement. C'est tout à fait normal.
  • Si vous avez plusieurs utilisateurs disposant d'autorisations sur Facebook, la meilleure solution consiste à exécuter la fonction Login de Facebook pour chacun d'entre eux, afin de ne pas recevoir de données partielles.

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

Affichez le statut de votre API de coûts et la dernière fois qu'AppsFlyer a réussi à extraire des données de coûts correspondantes, soit dans le tableau de bord du statut d'intégration des coûts (et des revenus publicitaires), soit dans le tableau de bord du réseau publicitaire individuel.

Facebook vous permet de synchroniser plusieurs comptes pour extraire les données de coût. Pour chaque compte synchronisé, AppsFlyer indique l'état de l'intégration de coût ainsi que la dernière fois où AppsFlyer est parvenu à extraire les données de coût correspondantes.

En savoir plus sur la manière d'enrichir vos informations Facebook à l'aide de données de coût, de clic et d'impression.

Mappage d'événements in-app

FB-in-app-events-setup-full-screen-en_us.png

Pour mapper des événements in-app :

  1. Activez les postbacks d'événements d'app.
    Lorsque vous activez le mappage des événements d'app Facebook pour une app pour la première fois, af_app_open est automatiquement mappé à session_start.
  2. Remplissez les paramètres suivants :
    Nom du paramètre Description
    Nom de l'événement SDK

    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 l'événement que vous cherchez dans la liste ? Assurez-vous d'activer l'évènement sur un appareil avec une installation non-organique et revérifiez. Vous pouvez également saisir le nom de l'événement, cliquer sur Créer un événement personnalisé, et procéder manuellement au mappage. En savoir plus sur le mappage d'événements personnalisés.

    ID d'événement partenaire Sélectionnez l'événement prédéfini le plus approprié pour votre balise d'événement Facebook. Vous pouvez également envoyer des événements PERSONNALISÉS Facebook.
    Option d'envoi

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

    • Ce partenaire uniquement pour les événements provenant exclusivement d'utilisateurs attribués aux publicités Facebook.
    • Toutes les sources média, y compris organiques pour que l'ensemble de votre base d'utilisateurs soit disponible dans le cadre des rapports des Publicités Facebook.
    Envoyer les revenus
    • Sans valeur et sans revenu : AppsFlyer envoie uniquement l'évènement, sans sa valeur.
    • Avec valeurs et sans revenu : envoie tous les paramètres à l'exception de la valeur de revenu.
    • Avec valeurs et revenus : envoie tous les paramètres, y compris la valeur de revenu (si présente dans l'événement).
  3. Pour ajouter un événement SDK à la liste, 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, Facebook rejette les caractères chinois. AppsFlyer n'a pas encore testé d'autres jeux de caractères. Vous ne devez les utiliser qu'après avoir vérifié auprès de Facebook s'ils prennent en charge ces jeux de caractères dans les publications.
  • 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 Facebook Ads.

Attribution de retargeting

L'attribution de retargeting d'AppsFlyer pour Facebook permet aux annonceurs d'attribuer un engagement supplémentaire d'un utilisateur avec une annonce sur Facebook, et de mesurer la qualité de l'utilisateur, après l'engagement, en utilisant les rapports AppsFlyer.

Cette fonctionnalité doit uniquement être utilisée si vous exécutez activement des campagnes ciblant vos propres utilisateurs sur Facebook.

  1. Activez le retargeting sur la page Paramètres de l'app.
  2. Sur la page des partenaires Facebook Ads, activez Attribution de réengagement.
  3. Définir la fenêtre rétrospective de réengagement post clic.
    La fenêtre rétrospective de réengagement est la période qui démarre au moment du clic sur la publicité, pendant laquelle l'app doit être lancée pour que le clic soit enregistré en tant que réengagement.
    Sélectionnez une fenêtre rétrospective en heures ou en jours et réglez le curseur sur la valeur souhaitée.
  4. 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.

    facebook_reengagement_attribution.png

En savoir plus sur l'Attribution de retargeting AppsFlyer.

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

Ê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 Facebook 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 Facebook des données personnelles des utilisateurs (CCPA).

Pour en savoir plus sur laConformité avec la CCPA.

Enregistrement des revenus publicitaires

mceclip0.png

Si votre application utilise les revenus publicitaires de l'Audience Network Facebook pour la monétisation publicitaire, vous pouvez enregistrer les revenus provenant de Facebook sur AppsFlyer. Cette opération, avec ou sans données sur les revenus d'achat in-app, vous donne une image complète de vos revenus par utilisateur.

Pour commencer à enregistrer les revenus publicitaires de l'Audience Network Facebook :

  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 à Facebook pour activer la collecte des revenus publicitaires du Facebook Audience Network sur Facebook. Connectez-vous avec vos identifiants Facebook pour autoriser les revenus publicitaires de l'Audience Network Facebook.
  5. Saisissez l'ID d'app du réseau d'audience (ID d'app Facebook). Vos pouvez l'obtenir auprès du Facebook Audience Network (FAN).
  6. Cliquez sur Enregistrer les revenus publicitaires.

 Remarque

Si vous utilisez MoPub pour médiatiser Facebook, et que vous disposez d'une intégration SDK MoPub, ainsi que d'une intégration directe avec Facebook, AppsFlyer filtre les données relatives aux revenus publicitaires de Facebook provenant de Mopub et utilise les données provenant de Facebook.

Autorisations

Autorisez Facebook 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 Publicités Facebook

Si vous avez complété l'intégration de base et que vous ne voyez toujours pas les résultats de Facebook sur le tableau de bord AppsFlyer, vérifiez si vous avez eu des nouvelles installations de Facebook 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.

ID d'app Facebook incorrecte

L’ID d’app Facebook généré par Facebook n’a pas été configuré correctement dans AppsFlyer.
Vérifiez que l’ID d’app est correct et correspond à la valeur du tableau de bord Facebook Ads.

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

Statut de l'application sur Facebook

L'app doit être définie sur Facebook comme Live plutôt que En développement pour garantir le bon fonctionnement de l'attribution.

Make_Test_App_Public.png

Type de campagne Facebook incorrect

Vérifiez que la campagne Facebook 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 pouvoir mesurer les installations mobile l'annonceur doit cocher l'option Enregistrement d'événements d'app lorsqu'il configure la campagne Facebook.

Installation d'app Facebook

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

Configuration correcte - réussite de l'attribution.

how_to_set_campaign_FB.png

Configuration incorrecte - échec de l'attribution.

how_not_to_set_a_campaign_on_Facebook.png

 

Mises à jour des Publicités Facebook

 Important !

Depuis le 29 octobre 2021, seuls les rapports agrégés des Publicités Facebook 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 annonces.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 relatives à Facebook

AppsFlyer confirme que notre intégration de la MMP avec Facebook implémente systématiquement le drapeau Suivi d'annonceur activé . Cela signifie qu'aucune action n'est requise de votre part dans AppsFlyer. Ces informations sont fournies conformément à la liste de vérification iOS 14 pour l'app Facebook 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.

Cet article vous a-t-il été utile ?