Comment envoyer des conversions à Facebook/Meta via l’API de conversion (CAPI)

Cet article explique comment envoyer un déclencheur de conversion dans Facebook via leur API de conversion – communément appelée “CAPI” chaque fois qu’un utilisateur soumet un formulaire Growform.

Les navigateurs bloquant de plus en plus les cookies et les restrictions en matière de protection de la vie privée se renforçant, le fidèle pixel de Facebook n’est plus aussi fiable qu’il l’était autrefois. Entrez dans CAPI : la solution serveur à serveur de Facebook qui vous permet de suivre les conversions même lorsque les méthodes de suivi traditionnelles ne suffisent pas.

En envoyant en toute sécurité des informations de serveur à serveur à Facebook – comme des adresses électroniques et des adresses IP hachées – leur plateforme peut faire correspondre les soumissions de formulaires à des utilisateurs individuels sans avoir recours à des cookies.

Ce guide ne nécessite pas d’expérience en codage, grâce à notre partenaire d’intégration, Zapier – qui propose un plan gratuit généreux et des plans abordables pour quelques milliers de tâches par mois.

1. Capturez l’adresse IP et l’agent utilisateur dans Growform

Tout d’abord, vous devrez activer la collecte de l’adresse IP et du user-agent dans Growform. Le “user-agent” est une description standardisée du navigateur de l’utilisateur (par exemple : Mozilla/5.0 (Windows NT 10.0 ; Win64 ; x64) AppleWebKit/537.36), tandis que l’adresse IP est l’équivalent Internet du numéro de téléphone de l’utilisateur.

Bien qu’il soit possible d’activer le suivi CAPI sans cela, il fournira une meilleure correspondance et est l’un des meilleurs signaux disponibles. Voici comment :

• Naviguez vers votre formulaire dans Growform
• Cliquez sur “Modifier les paramètres du formulaire”
• Choisissez “Capturer les détails du système”
• Cliquez sur “Enregistrer les paramètres du formulaire”

Veuillez noter que dans certaines juridictions, vous devrez peut-être demander l’autorisation de vos utilisateurs avant de capturer des informations identifiables telles que l’adresse IP.

Si ce paramètre est activé, Growform capturera l’adresse IP et l’agent utilisateur – qui seront disponibles avec les autres champs dans les étapes suivantes.

2. Effectuez un test de soumission

Une fois que vous avez activé la collecte des adresses IP et des user-agents, il est important d’exécuter une soumission de test, car cela permettra à Zapier de “voir” les nouvelles données que nous capturons à l’étape suivante.

Testez votre formulaire en cliquant sur “Afficher le formulaire” (ou en visitant son emplacement) et en le remplissant.

Une fois que vous avez soumis une piste, vous devriez voir l’agent utilisateur et l’adresse IP avec les autres informations du formulaire sur la page “Voir les pistes” :

Désormais, ces champs seront également sélectionnables dans Zapier, au même titre que tous les autres champs.

3. Créez un zap

Maintenant, connectez-vous à Zapier (en créant un compte si nécessaire) et cliquez sur “Créer” pour créer un nouveau Zap. Si vous ne connaissez pas Zapier, vous trouverez ici un guide générique sur l’utilisation de la plateforme.

Configurez le déclencheur Growform comme suit :

• Définissez votre déclencheur comme étant Growform
• Définissez l’événement déclencheur comme étant la soumission d’un nouveau formulaire
• Sélectionnez votre compte Growform et connectez Growform à Zapier si nécessaire.
• Réglez l’ ID du formulaire sur le formulaire concerné et cliquez sur “Test trigger” pour voir la dernière soumission dans Zapier.

Mise en place de la conversion Facebook / CAPI

Maintenant que nous disposons des données de Growform, il est temps d’envoyer un événement de conversion à Facebook/Meta. Voici comment :

• Cliquez sur “Action” et recherchez “conversions Facebook”. Choisissez“Conversions Facebook pour les administrateurs d’entreprise“, en supposant que vous disposiez d’un compte d’administrateur d’entreprise. Si ce n’est pas le cas, choisissez “conversions Facebook”.
  
• Pour l’événement d’action, choisissez Envoyer un autre événement dans la plupart des cas d’utilisation (par exemple, “CompleteRegistration”, “AddToCart” ou un événement personnalisé). Si vous devez déclencher un événement “Achat” ou “Lead”, choisissez l’option correspondante – mais notez que ce guide se poursuivra avec l’option Envoyer un autre événement.

Cliquez sur “Continuer”, et vous verrez une liste de champs que vous pouvez envoyer à Facebook. Voici les champs importants :

• Source de l’action : Doit être réglé sur “Site web”.
  
• Nom de l’événement : doit correspondre à l’événement que vous souhaitez envoyer (par exemple, AddToCart ou CompleteRegistration). Ne choisissez PAS “Purchase” ou “Lead” si vous avez choisi “Send other event” à l’étape précédente, car cela ne fonctionnera pas – vous devez revenir en arrière et modifier votre sélection pour l’événement approprié.
  
• Heure de l’événement : Si votre zap s’exécute toutes les 2 minutes, vous pouvez simplement laisser cette valeur vide, car Zapier utilisera l’heure du zap, qui sera très proche de l’heure de l’événement. Si vous utilisez une fréquence d’interrogation de 15 minutes, ou si vous n’êtes pas sûr, vous devez envoyer l’heure de la soumission du formulaire au format UNIX (voir ci-dessous).

• URL de la source de l’événement: Dans la mesure du possible, ce champ doit correspondre au site web sur lequel vous avez intégré le formulaire. Ce champ est obligatoire si vous avez choisi “Site web” comme source d’action.
  
• Informations sur le client: Il s’agit des informations sur les clients qui seront utilisées pour l’appariement. Vous devez simplement mapper autant d’informations client que vous avez à disposition (par exemple, l’adresse e-mail, le numéro de téléphone, le nom). Il n’est pas nécessaire de les “hacher” – Zapier s’en chargera automatiquement.

Nous vous recommandons d’en envoyer au moins un :

• Courriel
• Adresse IP du client
• User-Agent

Si vous avez suivi correctement les étapes 1 et 2, vous pourrez sélectionner l’adresse IP et le user-agent avec toutes les autres données du formulaire :

C’est tout ! Allez-y et cliquez sur “Continuer”, puis sur “Tester l’étape”. Vous devriez obtenir une réponse semblable à la suivante, sans message d’erreur :

C’est tout ! Notre événement a été envoyé avec succès à Meta. Ensuite, nous allons vérifier qu’il est bien arrivé dans l’interface du Facebook Business Manager. Si vous avez constaté une erreur à ce stade, ne vous inquiétez pas – reportez-vous à la section “Dépannage” ci-dessous.

4. Consultez votre événement sur Facebook

Si, dans le “Gestionnaire d’événements” de Facebook, vous voyez un avertissement vous demandant d’autoriser ou de bloquer tout événement provenant de Growform ou d’un domaine que vous reconnaissez, vous devez cliquer sur “Autoriser” pour que les événements soient reçus avec succès.

Facebook a un délai de 30 minutes pour le suivi des événements – donc si vous avez envoyé avec succès votre événement à l’étape précédente mais que vous ne le voyez pas encore, revenez dans une demi-heure. D’après notre expérience, les événements mettent 15 à 20 minutes à apparaître !

• Rendez-vous sur business.facebook.com, puis sur “Gestionnaire d’événements”. Au moment de la rédaction du présent document, vous pouvez y accéder en cliquant sur “Tous les outils”, puis sur “Gestionnaire d’événements”.

• Assurez-vous que vous êtes sur le bon compte auquel vous avez envoyé les données – il vous faudra parfois basculer d’un compte à l’autre dans le coin supérieur droit, et même cliquer sur “Voir plus de comptes publicitaires”.
  
• Sous “Sources de données”, choisissez votre pixel et recherchez le nom de l’événement que vous avez envoyé précédemment. Si le nom de l’événement est correct, vous devriez voir “Multiple” ou “Conversions API” dans la colonne “Intégration”, ce qui signifie que l’événement a été reçu avec succès via l’API.

Voici l’événement du backend, affiché dans notre propre compte :

Facultatif : Envoi de l’heure de soumission du formulaire au format UNIX

Si vous souhaitez envoyer l’heure de la soumission du formulaire à Zapier, vous devrez également la convertir en “X” ou “Unix”, qui est le format dans lequel Facebook s’attend à ce que les données soient présentées.

Le format UNIX est un nombre long, qui est en fait le nombre de secondes écoulées depuis 1970 !

Voici comment :

• Ajoutez une étape au-dessus de l’étape de conversion de Facebook
• Choisissez “Formateur”
• Comme événement d’action, choisissez Date/Heure
• Dans “Transformer”, choisissez Format
• En tant qu’entrée, choisissez la date soumise par Growform.
• Dans “Pour formater”, choisissez X (la dernière option au moment de la rédaction), puis cliquez sur “Continuer”.
• Cliquez sur continuer, et vous devriez voir le résultat de cette étape dans quelques secondes
• De retour dans “l’heure de l’événement” sous l’étape des conversions Facebook, vous pouvez insérer la valeur que vous venez de rendre disponible !

Dépannage

Avertissement“Paramètre invalide” dans Zapier

Il s’agit d’une erreur très fréquente au début de la configuration, qui signifie simplement que l’un des champs attendus par Facebook n’est pas tout à fait correct. Malheureusement, Facebook ne nous indique pas quel champ est incorrect, alors vérifiez les points suivants :

• Votre “Source d’action” est définie sur Site web
• Le nom de votre événement n’est PAS défini sur “Purchase” ou “Lead” si vous utilisez le zap “Send other event” (envoyer un autre événement) comme décrit dans ce tutoriel. Si vous souhaitez les utiliser, vous devez sélectionner l'”événement d’action” approprié au début de la configuration de la conversion Facebook.
• L’URL de la source de l’événement est définie comme une URL valide (par exemple, https://www.example.com) et n’est pas laissée vide.
• Dans la rubrique “informations sur le client”, l’adresse électronique est indiquée – il s’agit d’un champ obligatoire pour Facebook.
• Dans la rubrique “informations sur le client”, l’agent utilisateur du client est défini – c’est une exigence de Facebook.

Événement non vu dans Facebook

• Attendez 30 minutes pour que l’événement soit pris en compte – Facebook vous avertit que le traitement des événements en arrière-plan peut prendre 30 minutes.
• Assurez-vous que Facebook ne bloque pas les événements : vérifiez dans le gestionnaire d’événements de votre tableau de bord Facebook qu’aucune bannière ne propose d’autoriser ou de bloquer les événements, et choisissez d’autoriser si vous en avez la possibilité.