API Conversions pour CRM : intégration en tant que plateforme

Les partenaires peuvent envisager de proposer en tant que service l’API Conversions pour les évènements CRM. Votre clientèle peut ainsi importer des évènements de prospect générés via ses publicités à formulaire Facebook/Instagram (formulaires instantanés) à partir de ses systèmes CRM respectifs, et utiliser l’objectif d’optimisation des prospects de conversion dans les publicités qui peuvent produire des prospects de meilleure qualité et davantage susceptibles d’être convertis.

Conditions requises

Pour planifier votre projet, vous pouvez utiliser le calendrier approximatif comme guide. Note :

1. La phase d’intégration, ou le développement réel côté partenaire, peut prendre environ 3 à 7 semaines. Après l’intégration, le délai entre l’intégration d’un·e annonceur·se et le lancement de ses campagnes de publicités à formulaire entièrement optimisées pour les conversions peut prendre entre 1,5 et 2 mois.
2. Le calendrier ci-dessous est basé sur des données historiques. Le calendrier réel peut varier en fonction des ressources disponibles, de la vitesse de résolution des problèmes, etc.

*Les annonceur·ses peuvent exécuter des campagnes de publicités à formulaire pour les conversions pendant la période d’apprentissage, mais elles ou ils ne bénéficieront de performances optimales qu’après achèvement.

Guide d’intégration

Étape 1 : Prérequis

Si vous n’avez pas encore proposé l’API Conversions sous forme de service pour les évènements Web, d’application, hors ligne ou de messagerie professionnelle, veuillez vous assurer d’avoir configuré les éléments ci-dessous :

• Business Manager
• Une application Meta. Veuillez noter que votre application doit être validée via le Contrôle app. Pendant ce processus, vous devez obtenir l’accès Avancé pour ads_management, pages_read_engagement, ads_read, pages_show_list, business_management et l’accès Standard au Gestionnaire de publicités. Veuillez trouver ci-dessous des instructions supplémentaires pour procéder.
• Ensemble de données CRM Meta (précédemment appelé pixel). Un ensemble de données CRM est requis pour l’intégration de l’API Conversions pour CRM. L’ensemble de données CRM informera le système de l’importation d’évènements CRM et ajoutera un workflow Optimisation des prospects de conversion à l’ensemble de données pour optimiser la qualité des prospects.

Étape 2 : Authentification

Les partenaires disposent des deux options d’authentification suivantes pour les ensembles de données qui ne sont pas gérés par vous :

Option 1 : extension Meta Business (MBE, à privilégier)

MBE fournit un point de terminaison pour récupérer les tokens d’accès d’utilisateur·ice système créés dans le Business Manager de l’annonceur·se. Exécutez tous les prérequis pour implémenter MBE.

Assurez-vous de suivre les étapes ci-dessous :

• Obtenez manage_business_extension pour votre application : il s’agit d’une autorisation privée qui requiert l’ajout de votre application à la liste d’éléments autorisés par votre représentant·e Meta.
• Définissez la valeur du canal dans l’objet de configuration sur CONVERSIONS_API.
• Vérifiez que vous êtes en mesure de recevoir la réponse du webhook à la fin de l’intégration.
• Utilisez le token d’accès renvoyé par MBE et convertissez-le en un token d’accès utilisateur·ice système en effectuant un appel d’API supplémentaire.
• Enregistrez une copie des identifiants external_business_id (à savoir, l’identifiant de l’ensemble de données), pixel_id et business_id, ainsi que du token d’accès utilisateur·ice dans votre système.
• Obtenez l’approbation de votre intégration MBE.

Option 2 : token d’accès utilisateur·ice système de l’annonceur·se

Pour appliquer cette option, les partenaires doivent demander aux annonceur·ses de réaliser les actions suivantes :

• Créer manuellement un token d’accès utilisateur·ice système via l’API Conversions dans les Paramètres du Gestionnaire d’évènements Meta (EM)
• Partager avec les partenaires les identifiants pixel_id (à savoir, l’identifiant de l’ensemble de données) et business_id, ainsi que le token d’accès utilisateur·ice système, et en enregistrer une copie

Étape 3 : intégration de l’API

Ensuite, les partenaires appellent le point de terminaison de l’API Conversions pour envoyer la charge utile de l’événement. Étapes clés à prendre en compte :

Rechercher l’ID du prospect

lead_id est un ID prédéfini associé aux prospects générés à partir de campagnes de publicités à formulaire diffusées sur Facebook ou Instagram. Plusieurs méthodes permettent de trouver l’ID du prospect à partir de Meta. Il est recommandé aux partenaires d’utiliser la récupération groupée à partir d’un webhook ou de l’API Graph pour trouver l’ID du prospect.

Ajouter une chaîne partner_agent pour l’attribution

Envoyez une chaîne partner_agent unique avec la charge utile. Le cas échéant, contactez votre représentant·e Meta pour savoir quelle chaîne d’agent utiliser. Utilisez la même chaîne d’agent si vous en envoyez déjà une via l’API Conversions pour les évènements Web, hors ligne, d’application ou de messagerie professionnelle.

Exemple

Si votre identifiant de plateforme est datapartner, voici à quoi ressemblera la charge utile d’un évènement envoyé au nom de votre client·e :

{
    "event_name": "my lead stage",
    "event_time": 1617693833,
    "user_data": {
        "lead_id": 1234567890123456
    },
    "action_source": "system_generated",
    "custom_data": {
        "lead_event_source": "Salesforce",
        "event_source": "crm"
    },
   "partner_agent": "datapartner"
}

Utiliser la charge utile d’évènement correcte

Pour l’intégration de l’API Conversions pour CRM, les partenaires doivent utiliser la structure ci-dessus pour la charge utile d’évènement afin de s’assurer de la bonne réception des événements. Notez que cette méthode est différente de celle de l’API Conversions pour les événements Web, hors ligne, d’application ou de messagerie professionnelle.

Veillez à utiliser la valeur appropriée pour le paramètre action_source des évènements de l’API Conversions pour CRM, à savoir, action_source = system_generated.

Envoyer toutes les étapes de prospect, y compris l’étape initiale

Veillez à envoyer toutes les étapes des prospects à mesure de leur mise à jour. Cela signifie que plusieurs évènements auront le même lead_id lorsque le prospect passera à l’étape de funnel de prospects.

Vérifiez que vous envoyez la première étape de prospect (à savoir, l’événement de prospect brut) pour permettre au système de savoir que le prospect a été reçu et traité.

Vous devez envoyer au moins deux étapes pour les évènements à partir du funnel de ventes, y compris l’événement de prospect brut. Il est recommandé d’envoyer trois étapes ou plus si possible.

Mappage aux étapes de prospect CRM

Si vos annonceur·ses utilisent différents systèmes CRM, assurez-vous de pouvoir mapper les paramètres de différentes sources de données avec lead_id, event_name et event_time.

Une solution possible est d’incorporer une fonctionnalité UI/UX dans votre portail dédié aux annonceurs pour permettre à ces derniers de mapper eux-mêmes les paramètres de différents systèmes CRM à lead_id, event_name et event_time.

D’autres recommandations incluent :

1. Importez les données au moins une fois par jour. Dans l’idéal, importez les données en temps réel, mais vous pouvez intégrer les données par lot toutes les heures ou tous les jours si une intégration en temps réel n’est pas possible.
2. Chaque lot peut inclure jusqu’à 1 000 évènements. En cas d’erreur au niveau d’un lot, le lot complet sera supprimé. C’est pourquoi il est vivement recommandé d’utiliser des petits lots et d’ajouter une logique pour réitérer les tentatives.
3. Le remplissage des données peut remonter jusqu’à 7 jours, entre le moment où l’évènement se produit (event_time) et où il est importé (upload_time). Remplir certaines données permet d’accélérer le processus d’entraînement.
4. Assurez-vous que les valeurs event_time sont postérieures à la date de génération des évènements, sinon ceux-ci pourraient être supprimés.
5. Consignez les messages d’erreur provenant de l’appel de l’API Conversions et créez des alertes si des problèmes se produisent. Nous conseillons également de gérer les exceptions pour ces erreurs.
6. Stockez lead_id dans votre système avec d’autres informations comme les détails des prospects, l’étape de prospect, etc.

Après l’intégration

Une fois l’API intégrée, nous vous recommandons de sélectionner certains annonceur·ses pour effectuer des tests avant de proposer votre solution à toutes et tous.

Sélectionner des annonceur·ses approprié·es

Il est important de sélectionner des annonceur·ses approprié·es pour utiliser l’API Conversions pour CRM. Voici quelques conseils de sélection :

• Utilisation de publicités à formulaire Facebook/Instagram (formulaires instantanés)
• Génération d’au moins 200 prospects par mois
• L’étape de prospect que l’annonceur·se souhaite optimiser

  • a lieu dans les 28 jours suivant la génération des prospects
  • a un taux de conversion compris entre 1 % et 40 %
• Attention portée à la qualité des prospects

Règles pour vos annonceur·ses

Afin de pouvoir bien intégrer vos annonceur·ses à l’API Conversions pour CRM et les accompagner après l’intégration, nous recommandons vivement de bien connaître le parcours de l’annonceur·se :

Étape 1. Créer un ensemble de données CRM : pour vérifier si l’ensemble de données CRM est correctement configuré, accédez à Gestionnaire d’évènements > Source de données > Paramètres. Une section Prospects de conversion s’affiche s’il s’agit d’un ensemble de données CRM.

Étape 2. Envoyer un évènement CRM : autorisez votre annonceur·se à se connecter à votre système et à commencer à envoyer des évènements CRM. Si l’intégration est bloquée à l’étape « Envoyer un évènement CRM », cela signifie que l’annonceur·se ou votre système n’a pas encore réussi à envoyer d’évènement.

Étape 3. Attendre les évènements CRM pendant 7 jours : pour réussir les contrôles de validation des données, l’ensemble de données doit satisfaire à toutes les exigences avant de passer à l’étape suivante. Pour confirmer la validation de cette étape, vérifiez dans le Gestionnaire d’évènements si le statut passe à « Configurer le funnel de ventes ».

Si un·e annonceur·se est bloqué·e à cette étape :

• Vérifiez les erreurs dans l’onglet Diagnostic du Gestionnaire d’évènements pour l’ensemble de données.

• Continuez à envoyer au moins sept jours de données. Il n’est pas nécessaire d’envoyer sept jours de données d’affilée car l’annonceur·se peut ne pas générer de prospects certains jours, comme les week-ends.

• Vérifiez qu’un nombre suffisant d’évènements sont importés par rapport au nombre de prospects générés sur Facebook. Par exemple, si l’annonceur·se génère 100 prospects en une journée, les évènements correspondant à ces 100 prospects doivent être importés.

• Vérifiez s’il y a au minimum deux étapes pour les évènements depuis le funnel de ventes de l’annonceur·se, y compris la première étape (c’est-à-dire l’événement de prospect brut). Cependant, nous recommandons au moins trois étapes si possible. Par exemple, l’envoi seul de l’évènement « Promotion » ne sera pas suffisant ; assurez-vous que l’annonceur·se envoie également les étapes précédentes.

• Vérifiez que les données incluent tous les paramètres requis dans le format approprié présenté dans ce guide. L’envoi de données dans d’autres formats déclenchera une erreur.

Étape 4. Configurer le funnel de ventes

Étape 5. Analyse du funnel et phase d’apprentissage : pour quitter le statut « Analyse du funnel », une intégration devra répondre aux critères suivants :

• Une étape d’optimisation avec un taux de conversion compris entre 1 et 40 %

• Une fenêtre de conversion de la journée d’optimisation de 28 jours maximum

Une fois l’intégration terminée, une phase d’apprentissage d’un à deux mois est nécessaire afin de permettre au modèle d’utiliser les données qui sont renvoyées pour son optimisation. Pour savoir si une intégration a terminé la phase d’apprentissage, vérifiez que le statut dans le Gestionnaire d’évènements est « Phase d’apprentissage terminée ».

Étape 6. Diffusez les campagnes de publicités à formulaire entièrement optimisées pour les conversions via le Gestionnaire de publicités en utilisant l’ensemble de données CRM ci-dessus.

Note : rappelez à l’annonceur·se de ne pas modifier les ensembles de données une fois l’intégration terminée. Toute modification des ensembles de données commencera une nouvelle intégration et relancera le processus d’apprentissage.