Synchronisation de l’audience avec Facebook
Grâce à la synchronisation d’audience de Braze avec Facebook, vous pouvez choisir d’ajouter les données de vos propres utilisateurs issues de votre intégration Braze aux audiences personnalisées de Facebook. Vous pouvez ainsi diffuser des publicités basées sur des déclencheurs comportementaux, la segmentation et bien plus encore.
Tous les critères que vous utilisez habituellement pour déclencher un message (notification push, e-mail, SMS ou webhook) dans un Canvas de Braze à partir de vos données utilisateur peuvent désormais servir à déclencher une publicité auprès de cet utilisateur sur Facebook grâce aux audiences personnalisées. Par exemple, lorsque vous configurez une synchronisation d’audience avec Facebook, vous pouvez utiliser une grande variété de champs first-party, comme l’e-mail, le téléphone, le prénom et le nom de famille.
Les cas d’usage courants de la synchronisation des audiences personnalisées sont les suivants :
- Cibler les utilisateurs à forte valeur sur plusieurs canaux pour favoriser les achats ou l’engagement.
- Recibler les utilisateurs qui réagissent moins aux autres canaux marketing.
- Créer des audiences d’exclusion pour éviter que des utilisateurs déjà fidèles à votre marque ne reçoivent des publicités.
- Créer des audiences similaires (lookalike) pour acquérir de nouveaux utilisateurs plus efficacement.
Cette fonctionnalité permet aux marques de contrôler quelles données first-party spécifiques sont partagées avec Facebook. Chez Braze, nous accordons la plus grande attention aux intégrations avec lesquelles vous pouvez ou non partager vos données first-party. Pour plus d’informations, consultez notre politique de confidentialité.
Synchronisation des utilisateurs et considérations relatives à la limite de débit
Lorsque les utilisateurs atteignent l’étape Audience Sync, Braze les met en file d’attente pour les regrouper en lots avant de les envoyer à Facebook. Consultez la section Traitement par lots et latence pour découvrir comment Braze distribue les lots.
Braze envoie jusqu’à 2 000 utilisateurs par requête à Facebook. La limite de débit de l’API Marketing de Facebook autorise au maximum ~190 000 requêtes API par compte publicitaire sur une période d’une heure. Si un client atteint cette limite, Braze relance la synchronisation pendant ~13 heures maximum. Si la synchronisation reste impossible, Braze répertorie ces utilisateurs sous l’indicateur Utilisateurs en erreur.
Conditions préalables
Avant de configurer votre étape Audience Facebook dans Canvas, vérifiez que vous avez bien créé et finalisé les éléments suivants.
| Condition | Origine | Description |
|---|---|---|
| Facebook Business Manager | Un outil centralisé pour gérer les ressources Facebook de votre marque (par exemple, comptes publicitaires, pages et applications). | |
| Compte publicitaire Facebook | Un compte publicitaire Facebook actif lié au Business Manager de votre marque. Assurez-vous que l’administrateur de votre Facebook Business Manager vous a accordé les autorisations « Gérer les campagnes » ou « Gérer les comptes publicitaires » pour les comptes publicitaires Facebook que vous prévoyez d’utiliser avec Braze. Assurez-vous également d’avoir accepté les conditions générales de votre compte publicitaire. |
|
| Conditions des audiences personnalisées de Facebook | Acceptez les conditions des audiences personnalisées de Facebook pour les comptes publicitaires Facebook que vous prévoyez d’utiliser avec Braze. |
Intégration
Étape 1 : Se connecter à Facebook
Vous devez disposer de l’autorisation « Admin » pour connecter Facebook à votre compte Braze.
Dans le tableau de bord de Braze, allez dans Intégrations partenaires > Partenaires technologiques et sélectionnez Facebook. Sous Facebook Audience Export, sélectionnez Connecter Facebook.
Une fenêtre de dialogue oAuth de Facebook s’affiche pour autoriser Braze à créer des audiences personnalisées dans vos comptes publicitaires Facebook.
Après avoir associé Braze à votre compte Facebook, sélectionnez les comptes publicitaires que vous souhaitez synchroniser dans votre espace de travail Braze. Une fois la connexion établie, vous serez redirigé vers la page partenaire, où vous pourrez voir quels comptes sont connectés et déconnecter les comptes existants.
Votre connexion Facebook s’applique au niveau de l’espace de travail Braze. Si votre administrateur Facebook vous retire de votre Facebook Business Manager ou de l’accès aux comptes Facebook connectés, Braze détectera un jeton non valide. Par conséquent, vos Canvas actifs utilisant des composants Facebook Audience afficheront des erreurs, et Braze ne pourra pas synchroniser les utilisateurs.
Pour les clients ayant déjà suivi le processus d’examen des applications Facebook pour Ads Management et Ads Management Standard Access, votre jeton d’utilisateur système restera valide pour le composant Facebook Audience. Vous ne pourrez pas modifier ni révoquer le jeton d’utilisateur système Facebook depuis la page partenaire Facebook. Vous pouvez en revanche connecter votre compte Facebook pour remplacer votre jeton d’utilisateur système Facebook dans votre espace de travail Braze.
La configuration oAuth de Facebook s’appliquera également aux exportations Facebook utilisant des Segments.
Étape 2 : Accepter les conditions d’utilisation des audiences personnalisées
Avant de créer votre Canvas, vous devez accepter les conditions d’utilisation Facebook suivantes, accessibles via ces liens :
- Conditions des audiences personnalisées à partir d’une liste de clients pour votre compte personnel :
https://www.facebook.com/ads/manage/customaudiences/tos.php?act=<ACCOUNT_ID>. - Conditions des outils professionnels Facebook pour votre compte professionnel :
https://business.facebook.com/customaudiences/value_based/tos.php?act=<ACCOUNT_ID>&business_id=<BUSINESS_ID>.
Consultez la section FAQ pour en savoir plus sur l’audit de votre compte Facebook lors de l’intégration.
Étape 3 : Ajouter un composant Facebook Audience dans Canvas
Ajoutez un composant dans votre Canvas et sélectionnez Facebook Audience.
Étape 4 : Configuration de la synchronisation
Sélectionnez le bouton Audience personnalisée pour ouvrir l’éditeur du composant. Sélectionnez ensuite Facebook comme partenaire Audience Sync.
Sélectionnez le compte publicitaire Facebook souhaité. Dans la liste déroulante Choisir une audience nouvelle ou existante, saisissez le nom d’une audience nouvelle ou existante.
- Saisissez un nom pour la nouvelle audience personnalisée.
- Sélectionnez Ajouter des utilisateurs à l’audience, puis choisissez les champs que vous souhaitez synchroniser avec Facebook.
- Sélectionnez ensuite Créer une audience pour enregistrer votre audience.
Une notification s’affiche en haut de l’éditeur d’étapes pour indiquer si l’audience a bien été créée ou si une erreur s’est produite au cours du processus. Vous pouvez également faire référence à cette audience pour retirer des utilisateurs plus loin dans le parcours Canvas, car l’audience a été créée en mode brouillon.
Lorsque vous lancez un Canvas avec une nouvelle audience, Braze crée la nouvelle audience personnalisée au lancement du Canvas, puis synchronise les utilisateurs quasiment en temps réel à mesure qu’ils entrent dans l’étape Audience Sync.
Chaque étape Audience Sync correspond à l’audience Facebook configurée pour cette étape. Lorsque le Canvas s’exécute à nouveau (par exemple, selon une planification récurrente), Braze synchronise les utilisateurs éligibles avec cette même audience : il ne crée pas de nouvelle audience Facebook à chaque exécution du Canvas.
Braze vous permet d’ajouter des utilisateurs à des audiences personnalisées Facebook existantes ou de les en retirer, afin de garantir que ces audiences restent à jour. Pour synchroniser avec une audience existante, procédez comme suit :
- Saisissez le nom de l’audience existante dans la liste déroulante.
- Choisissez Ajouter à l’audience ou Retirer de l’audience.
- Braze ajoutera ou retirera les utilisateurs quasiment en temps réel à mesure qu’ils entrent dans l’étape Facebook Audience.
Facebook interdit de retirer des utilisateurs d’audiences personnalisées dont la taille est trop faible (généralement moins de 1 000 utilisateurs). Par conséquent, Braze ne peut pas synchroniser les utilisateurs à retirer depuis l’étape Audience Sync tant que l’audience n’a pas atteint la taille requise.
Étape 5 : Lancer le Canvas
Après avoir configuré votre composant Facebook Audience, il ne vous reste plus qu’à lancer le Canvas ! La nouvelle audience personnalisée est créée, et les utilisateurs qui passent par l’étape Facebook Audience sont transmis à cette audience personnalisée sur Facebook. Si votre Canvas contient des étapes suivantes, vos utilisateurs passeront ensuite à l’étape suivante de leur parcours.
L’onglet Historique de l’audience personnalisée dans le Gestionnaire d’audiences Facebook reflète le nombre d’utilisateurs envoyés à l’audience depuis Braze. Si un utilisateur entre à nouveau dans l’étape, il est de nouveau envoyé à Facebook.
Comprendre l’analyse
Le tableau suivant présente les indicateurs et leurs descriptions pour vous aider à mieux comprendre l’analyse de votre composant Audience Sync.
| Indicateur | Description |
|---|---|
| Entrés | Nombre d’utilisateurs qui sont entrés dans ce composant pour être synchronisés avec Facebook. |
| Passés à l’étape suivante | Nombre d’utilisateurs qui ont avancé vers le composant suivant, s’il y en a un. Tous les utilisateurs avancent automatiquement s’il s’agit de la dernière étape de la branche du Canvas. |
| Utilisateurs synchronisés | Nombre d’utilisateurs qui ont été synchronisés avec succès avec Facebook. |
| Utilisateurs non synchronisés | Nombre d’utilisateurs qui n’ont pas été synchronisés en raison de champs de correspondance manquants. Les champs sont mis en correspondance à l’aide d’un opérateur « OR » : tant qu’un utilisateur possède l’un des champs dans Facebook, Facebook établit la correspondance même si aucun des autres champs ne correspond. |
| Utilisateurs en attente | Nombre d’utilisateurs en cours de traitement par Braze pour être synchronisés avec Facebook. |
| Utilisateurs en erreur | Nombre d’utilisateurs qui n’ont pas été synchronisés avec Facebook en raison d’une erreur d’API après environ 13 heures de nouvelles tentatives. Les erreurs peuvent notamment être dues à un jeton Facebook non valide ou à la suppression de l’audience personnalisée sur Facebook. |
| Sortis du Canvas | Nombre d’utilisateurs qui sont sortis du Canvas. Cela se produit lorsque la dernière étape d’un Canvas est une étape Facebook. |
Les indicateurs d’utilisateurs synchronisés et d’utilisateurs en erreur sont communiqués avec un certain délai en raison du traitement interne.
Questions fréquentes
Combien de temps faut-il pour que mes audiences apparaissent dans le tableau de bord de mon partenaire Audience Sync ?
Le délai nécessaire pour alimenter une audience dépend du partenaire. Tous les réseaux traitent les requêtes de Braze et tentent de faire correspondre les utilisateurs. La mise à jour des audiences personnalisées peut prendre jusqu’à 24 heures.
Que dois-je faire si je reçois une erreur de jeton non valide ?
Il vous suffit de déconnecter puis de reconnecter votre compte Facebook sur la page partenaire Facebook. Vérifiez auprès de l’administrateur de votre Facebook Business Manager que vous disposez des autorisations nécessaires pour le compte publicitaire que vous souhaitez synchroniser.
Pourquoi mon Canvas ne peut-il pas être lancé ?
- Assurez-vous que votre jeton d’utilisateur système est authentifié et qu’il a accès aux comptes publicitaires souhaités dans Facebook Business Manager.
- Assurez-vous d’avoir sélectionné un compte publicitaire, saisi un nom pour la nouvelle audience personnalisée et sélectionné les champs à faire correspondre.
- Vous avez peut-être atteint la limite de 500 audiences personnalisées sur Facebook. Rendez-vous dans le Facebook Audience Manager pour supprimer celles dont vous n’avez plus besoin avant de créer de nouvelles audiences personnalisées avec Canvas.
Comment savoir si des utilisateurs ont été mis en correspondance après leur transmission à Facebook ?
Facebook ne fournit pas cette information pour des raisons de confidentialité.
Braze prend-il en charge les audiences personnalisées basées sur la valeur ?
Pour l’instant, Braze ne prend pas en charge les audiences personnalisées basées sur la valeur. Si value-based custom audience sync vous intéresse, envoyez un retour produit.
Braze hache-t-il les données avant de les envoyer aux partenaires Audience Sync ?
Une fois les données d’e-mail normalisées, Braze les hache avec SHA256.
IDFA/AAID/téléphone : Braze les hache avec SHA256. Les types d’audience vers lesquels nous synchronisons sont toujours l’un des suivants :
- IDFA_SHA256
- AAID_SHA256
- EMAIL_SHA256
- PHONE_SHA256.
En matière de fréquence, Braze ne hache les données d’identification personnelle (PII) des utilisateurs qu’au moment où ils entrent dans l’étape Audience Sync du parcours utilisateur, afin de préparer la synchronisation.
Comment résoudre un problème de synchronisation d’une audience similaire personnalisée basée sur la valeur ?
Pour l’instant, Braze ne prend pas en charge les audiences similaires personnalisées basées sur la valeur. Si vous tentez de synchroniser cette audience, cela peut provoquer des erreurs dans votre étape Audience Sync. Pour résoudre ce problème, procédez comme suit :
- Accédez à votre tableau de bord Facebook Ad Manager et sélectionnez Audiences.
- Sélectionnez Create audience > Custom audience.
- Sélectionnez Customer list.
- Téléversez votre fichier CSV ou votre liste sans la colonne Value. Sélectionnez No, continue with a customer list that doesn’t include customer value.
- Terminez la création de votre audience personnalisée.
- Dans Braze, mettez à jour l’étape Audience Sync de Facebook avec l’audience personnalisée que vous avez créée.
J’ai reçu un e-mail concernant les conditions d’utilisation des audiences personnalisées de Facebook. Que dois-je faire ?
Pour utiliser Audience Sync avec Facebook, vous devez accepter ces conditions d’utilisation.
- Si votre compte publicitaire est directement associé à votre compte Facebook personnel, vous pouvez accepter les conditions d’utilisation depuis votre compte personnel ici :
https://www.facebook.com/ads/manage/customaudiences/tos.php?act=<ACCOUNT_ID>. - Si votre compte publicitaire est lié au compte Business Manager de votre entreprise, vous devez accepter les conditions d’utilisation dans votre compte Facebook Business Manager ici :
https://business.facebook.com/customaudiences/value_based/tos.php?act=<ACCOUNT_ID>&business_id=<BUSINESS_ID>.
Après avoir accepté les conditions d’utilisation des audiences personnalisées de Facebook, procédez comme suit :
- Actualisez votre jeton d’accès Facebook avec Braze en déconnectant puis en reconnectant votre compte Facebook.
- Réactivez votre étape Audience Sync de Facebook en modifiant puis en mettant à jour votre Canvas.
Braze pourra alors synchroniser les utilisateurs dès qu’ils atteindront l’étape Audience Sync de Facebook.
Que sont devenus les filtres Connected Facebook et Number of Facebook Friends Using App ?
Les filtres de segmentation Braze Number of Facebook Friends Using App et Connected Facebook sont obsolètes. Facebook et les SDK de Braze ne collectent plus les données sur lesquelles reposaient ces filtres.
Remplacez ces filtres obsolètes par des attributs personnalisés, des événements personnalisés ou des Segments basés sur l’engagement. Par exemple, utilisez la connexion Facebook ou l’association de comptes sociaux à la place de Connected Facebook, ou les recommandations, invitations et partages à la place de Number of Facebook Friends Using App.
Pour le reciblage avec Canvas, faites correspondre les utilisateurs à l’aide de l’e-mail, du numéro de téléphone, du prénom et du nom, comme indiqué à l’étape 4 : Configuration de la synchronisation. Pour élargir votre portée, synchronisez un Segment à forte valeur avec Facebook et créez une audience similaire dans Meta Ads Manager.
Résolution des problèmes
| Erreur | Description | Étapes de résolution |
|---|---|---|
| Jeton non valide | Cette erreur survient généralement lorsque l’utilisateur qui a connecté l’intégration change son mot de passe, lorsque les identifiants expirent, etc. | Allez dans Intégrations partenaires > Facebook, puis déconnectez et reconnectez votre compte. Consultez cette section de résolution des problèmes pour découvrir d’autres étapes permettant d’auditer votre compte Facebook. |
| Taille d’audience trop faible | Cette erreur peut survenir si vous avez créé une étape Audience Sync qui retire des utilisateurs de vos audiences. Si la taille de votre audience approche de zéro, le réseau peut signaler qu’elle est trop petite pour être diffusée. | Adoptez une stratégie Audience Sync qui ajoute et retire régulièrement des utilisateurs, sans épuiser complètement la taille de l’audience. |
| L’audience n’existe pas | L’étape Audience Sync utilise une audience qui n’existe pas ou qui a été supprimée. Cette erreur peut également se déclencher si vous n’avez plus l’autorisation nécessaire pour accéder à l’audience. | Demandez à un administrateur de vérifier sur la plateforme partenaire si l’audience existe toujours. Si elle existe, vérifiez que l’utilisateur qui a connecté l’intégration dispose d’une autorisation sur cette audience. Si ce n’est pas le cas, cet utilisateur doit obtenir l’accès à l’audience. Si l’audience a été supprimée volontairement, ajoutez une audience active et créez une nouvelle audience dans l’étape. |
| Tentative d’accès au compte publicitaire | Vous ne disposez pas des autorisations nécessaires pour le compte publicitaire ou l’audience sélectionnés. | Contactez les administrateurs de votre compte publicitaire pour obtenir les accès et autorisations appropriés. |
| Conditions d’utilisation non acceptées | Pour certaines destinations Audience Sync, comme Facebook, le réseau publicitaire exige l’acceptation de conditions d’utilisation spécifiques pour utiliser la fonctionnalité Audience Sync. Cette erreur se déclenche si vous n’avez pas accepté les conditions appropriées. Vous avez peut-être également reçu un e-mail de Braze avec l’objet suivant : « Your authorization credentials for Facebook are invalid. » | Vérifiez que vous avez bien accepté les conditions requises par Facebook. |
| Erreur pour tous les utilisateurs | Si tous les utilisateurs sont en erreur dans une étape alors que vous avez confirmé qu’ils disposent de valeurs pour les champs sélectionnés dans l’étape, cela peut indiquer un problème avec votre compte Facebook. | Suivez les étapes de cette section de résolution des problèmes pour vérifier que votre compte ne présente aucun problème. |
| Échec de la création de l’audience | Sur la page de partenaire technologique Facebook, le statut indique « Connecté », mais une erreur apparaît dans l’étape Facebook Audience Sync lors de la synchronisation d’une audience : « Failed to create audience 'audience name' ». L’autorisation de votre compte Facebook a échoué. Rendez-vous sur la page Partenaires technologiques pour reconnecter votre compte. | Suivez les étapes de cette section de résolution des problèmes pour vérifier que votre compte ne présente aucun problème. |
| Compte publicitaire absent de la liste déroulante | Lorsque vous configurez l’étape Facebook Audience, un compte publicitaire attendu n’apparaît pas dans le sélecteur de comptes publicitaires. | Vérifiez que votre application Facebook a terminé l’examen de l’application (App Review) pour ads_management avec le niveau d’accès exigé par Facebook pour l’utilisation de la Marketing API. Dans Facebook Business Manager, vérifiez que le jeton de l’utilisateur système dispose des bonnes autorisations, qu’il est associé aux comptes publicitaires que vous utilisez dans Braze et que les conditions des comptes publicitaires ont été acceptées. Si la liste déroulante fonctionne dans un nouveau Canvas mais pas dans un Canvas que vous avez déjà modifié, essayez d’actualiser complètement votre navigateur (ou de vider votre cache) et vérifiez que vous êtes connecté avec un utilisateur qui a toujours accès à ces comptes publicitaires. |
| Erreur de validation du jeton d’accès | Une erreur concernant la validation du jeton d’accès Facebook s’affiche lorsque vous connectez Braze à Facebook ou lors de la synchronisation des audiences. | Déconnectez-vous de Facebook dans votre navigateur. Dans Braze, allez dans Intégrations partenaires > Facebook, supprimez les identifiants Facebook enregistrés, puis reconnectez Facebook. Sur la page Partenaires technologiques de Facebook pour Braze, déconnectez et reconnectez l’intégration si cette option est disponible. Si les problèmes persistent, suivez la section Auditer votre compte Facebook. |
| Erreurs d’autorisation lors de l’exportation ou de la synchronisation d’audience | L’exportation ou la synchronisation d’une audience Facebook échoue avec des erreurs liées à l’autorisation, aux droits d’administrateur ou au compte publicitaire. | Dans Meta for Developers, ouvrez votre application et vérifiez que votre utilisateur dispose du rôle Admin dans App roles. Sous App settings > Advanced, vérifiez que Advertising accounts inclut les comptes que vous utilisez avec Braze. Dans les paramètres de l’entreprise, vérifiez que l’utilisateur ou l’utilisateur système qui établit la connexion a accès au bon compte publicitaire. |
Auditer votre compte Facebook
Si vous rencontrez d’autres problèmes avec votre intégration, consultez les sections et étapes suivantes pour auditer votre compte Facebook.
Vérifier les autorisations du compte
- Consultez la documentation de Facebook pour savoir comment gérer ces autorisations sur leur plateforme. Dans Facebook Business Manager, vous devez disposer au minimum d’un rôle Business Manager Admin ou Employee avec un accès aux comptes publicitaires nécessaires.
- En tant qu’Employee, vérifiez que l’administrateur vous accorde les autorisations complètes Manage Ad Account pour chaque compte publicitaire afin de pouvoir créer une audience ou synchroniser des utilisateurs avec celle-ci.
- Une fois ces autorisations accordées, vous devez déconnecter puis reconnecter votre compte.
Accepter les conditions d’utilisation
Acceptez toutes les conditions d’utilisation (TOS) de Facebook en attente. Facebook vous demande régulièrement (à vous, l’utilisateur, ainsi qu’au gestionnaire d’entreprise) d’approuver à nouveau ses conditions d’utilisation.
- L’utilisateur connecté doit accepter toutes les conditions d’utilisation pour chacun de ses comptes publicitaires :
- Conditions d’utilisation des audiences personnalisées (Custom Audience TOS) pour votre compte Facebook personnel :
https://business.facebook.com/ads/manage/customaudiences/tos/?act=<AD_ACCOUNT_ID>
- Conditions d’utilisation des audiences personnalisées (Custom Audience TOS) pour votre compte Facebook personnel :
Pour trouver l’ID de votre compte et l’ID de votre entreprise, procédez comme suit :
- Accédez à votre compte Facebook Ads Manager.
- Vérifiez dans le menu déroulant que vous utilisez le bon compte publicitaire.
- Dans l’URL, repérez l’ID du compte après
act=et l’ID de l’entreprise aprèsbusiness_id=
- Lisez les conditions relatives aux audiences personnalisées, puis sélectionnez Accept. Nous vous recommandons de vérifier pour quel compte les conditions d’utilisation sont signées à l’aide du menu déroulant situé en haut des conditions.
- Vous devez sélectionner Accept pour les conditions d’utilisation. Le message suivant s’affiche ensuite : « You have accepted these terms of service on behalf of Braze ».
- Actualisez votre jeton d’accès Facebook auprès de Braze en déconnectant puis en reconnectant votre compte Facebook.
- Réactivez votre étape Facebook Audience Sync en modifiant puis en mettant à jour votre Canvas. Braze pourra alors synchroniser les utilisateurs dès qu’ils atteignent l’étape d’audience Facebook.
- Si le problème persiste, essayez de faire accepter manuellement les conditions via Ads Manager par un autre utilisateur disposant d’autorisations d’administrateur.
Effectuer les tâches en attente
Vérifiez si des tâches en attente sur Facebook vous empêchent d’utiliser les services Facebook Ads :
- Connectez-vous à Facebook Ads Manager.
- Sélectionnez le compte publicitaire qui pose problème.
- Dans la navigation, sélectionnez Account Overview.
- Vérifiez si des alertes doivent être traitées.
- Vérifiez si des tâches de configuration doivent être effectuées.
Se connecter avec un autre utilisateur
Comme étape supplémentaire de résolution des problèmes, nous vous recommandons de demander à un autre utilisateur administrateur de connecter son compte en procédant comme suit :
- Déconnectez l’intégration actuelle.
- Un autre utilisateur disposant d’autorisations d’administrateur connecte son compte utilisateur Facebook.