Attribution des publicités « Click-to-WhatsApp » #

Si vous diffusez des publicités Meta (Facebook/Instagram) « Click to WhatsApp », Your AI Connector peut vous indiquer de quelle publicité provient chaque prospect WhatsApp — et vous fournir l’identifiant de clic Meta dont vous avez besoin pour signaler les conversions réelles à Meta. Cela permet à vos campagnes publicitaires de s’optimiser en fonction des ventes et des réservations réelles, et non simplement des « personnes ayant entamé une discussion ».

Vous diffusez des publicités vers une page de votre propre site web avec un bouton WhatsApp ? Consultez Attribution des clics publicitaires pour WhatsApp.

Ce qui est capturé #

Lorsqu’une personne appuie sur une publicité Click-to-WhatsApp et envoie un message à votre entreprise, Meta joint des informations de référence cachées à ce premier message. Your AI Connector les lit automatiquement et les enregistre sur le contact. Aucune configuration ni paramétrage n’est nécessaire — cela se fait tout seul.

Les informations capturées sont enregistrées sur le contact sous ad_referral et contiennent :

Vous pouvez le voir sans aucune configuration : la page du contact affiche une étiquette Provenant d’une publicité sous son nom (survolez-la pour voir les détails de la publicité), le panneau de contact à côté du chat l’affiche également, et l’activité du contact commence par le clic sur la publicité. Vous pouvez aussi le lire via des webhooks et l’API (voir ci-dessous). Il ne s’agit pas d’une colonne dans le tableau des contacts.

Une chose que la charge utile ne vous indique pas : sur lequel de vos numéros la conversation est arrivée. Il n’y a pas d’identifiant de page ou d’identifiant de compte WhatsApp Business dedans. Avec un seul numéro, cela n’a pas d’importance ; si vous gérez plusieurs numéros sur différentes pages Facebook, vous devrez effectuer cette correspondance de votre côté.

Prospects arrivant sans numéro de téléphone #

Certaines personnes qui vous envoient un message depuis une publicité ont leur numéro de téléphone masqué par WhatsApp. Dans ce cas, Meta transmet un identifiant privé pour la personne au lieu d’un numéro, et le contact est créé avec un champ de téléphone vide. C’est un comportement attendu. Les réponses, les réponses par IA et les suivis automatiques atteignent toujours la personne, car Your AI Connector s’adresse à elle via cet identifiant.

Laissez le champ de téléphone vide pour ces contacts. N’y saisissez pas votre propre numéro professionnel : un message ne peut pas être envoyé d’un numéro vers lui-même, donc le prochain suivi automatique échouerait et le contact serait mis en pause. Your AI Connector refuse désormais d’enregistrer l’un de vos propres numéros connectés comme numéro de téléphone d’un contact. Si la personne partage son numéro plus tard, ou vous envoie un nouveau message avec celui-ci visible, il sera rempli automatiquement.

Connexions compatibles #

Cela fonctionne uniquement avec la connexion officielle à l’API WhatsApp. Meta ne transmet les informations de référence structurées (y compris ctwa_clid) que via l’API officielle WhatsApp Business. La connexion WhatsApp (web) non officielle ne les reçoit pas — aucune donnée de clic publicitaire n’est disponible sur cette connexion, par conception.

Par conséquent, si l’attribution publicitaire en boucle fermée est importante pour vous, diffusez vos campagnes « Click-to-WhatsApp » via un numéro connecté à l’API WhatsApp officielle.

Annonces Click-to-Instagram et Click-to-Messenger #

Les annonces qui ouvrent une discussion Instagram DM ou Messenger sont enregistrées de la même manière, sur la page Facebook et le compte Instagram que vous avez connectés avec la carte Instagram & Messenger. Lorsqu’une personne entame une discussion à partir de l’une de ces annonces, le contact reçoit un ad_referral avec channel défini sur instagram ou messenger, source_type défini sur ad et source_id défini sur l’identifiant de l’annonce. Cela vous permet d’identifier l’annonce à l’origine de chaque contact, afin de calculer le coût par réservation pour chaque annonce.

Quelques différences par rapport à WhatsApp :

• Il n’y a pas de ctwa_clid ; ce champ est vide. Meta émet cet identifiant de clic uniquement pour WhatsApp.
• headline est le titre de la publicité lorsque Meta l’envoie, et source_url est le lien de l’image ou de la vidéo de la publicité lorsqu’il y en a un. body est vide.
• Si le contact provient initialement d’une publicité et entame plus tard une discussion à partir d’une publicité différente, ad_referral affiche la publicité la plus récente.
• Les contacts issus de publicités Messenger incluent la publicité à partir du 14 octobre 2026. Les contacts provenant d’une publicité Messenger avant cette date n’ont pas de ad_referral, car les détails de la publicité n’étaient pas enregistrés à ce moment-là et ne peuvent pas être ajoutés ultérieurement.
• Les discussions Messenger qui commencent par un appui sur le bouton Démarrer de la Page ne sont pas enregistrées. Supprimez le bouton Démarrer de votre Page (Meta Business Suite, paramètres de la boîte de réception) afin que les utilisateurs commencent la discussion en écrivant, et la publicité sera enregistrée lors de leur premier message.

Comportement au premier contact #

La référence est capturée lors du premier message qu’un contact envoie à partir d’une publicité. Si le même contact clique plus tard sur une publicité différente et que ce nouveau clic contient un identifiant de clic, le ad_referral stocké est actualisé afin que l’identifiant de clic reste à jour pour les rapports. Les références provenant de publications organiques (qui n’ont pas de ctwa_clid) ne remplacent jamais un identifiant de clic publicitaire payant précédemment capturé.

Transmettre les données à Meta ou Google Ads #

Your AI Connector capture les données d’attribution et les expose. Pour les publicités qui envoient d’abord les utilisateurs vers votre propre site web, Your AI Connector peut envoyer les résultats à Meta pour vous lorsqu’une balise est appliquée : voir Envoyer les résultats à Meta. Pour les publicités « Click-to-WhatsApp », vous transférez les données à l’aide de webhooks et d’un outil d’automatisation.

L’objet ad_referral est inclus dans la section contact des événements de webhook sortants (par exemple, Nouveau message, Contact repris, Étiquettes de contact mises à jour, et événements analytiques tels que Rendez-vous réservé).

Une configuration typique en boucle fermée :

1. Un prospect clique sur votre publicité Click-to-WhatsApp et vous envoie un message. Your AI Connector enregistre ad_referral (y compris ctwa_clid) sur le contact.
2. Au fur et à mesure que le prospect progresse — appel réservé, devenu client, perdu — vous marquez ce résultat (voir « Suivi de l’étape de l’entonnoir » ci-dessous).
3. Un webhook est envoyé à votre outil d’automatisation (Zapier, Make ou Pabbly) contenant à la fois le résultat et le ctwa_clid du contact.
4. Votre outil d’automatisation appelle l’API Conversions de Meta (en utilisant action_source = business_messaging et le ctwa_clid) ou Google Ads (Importation des conversions hors ligne / Conversions améliorées pour les prospects) pour signaler la conversion.

De cette façon, Meta et Google apprennent quelles publicités ont produit des résultats réels et les optimisent en conséquence.

Suivi de l’étape de l’entonnoir #

Pour signaler une conversion, vous avez généralement besoin de deux éléments : l’identifiant du clic (capturé automatiquement) et le résultat (que vous définissez). Le moyen le plus fiable d’associer un résultat consiste à utiliser des tags, car l’application d’un tag déclenche le webhook contact_tags_updated — et cette charge utile inclut le ad_referral du contact. (La suppression d’un tag ne le déclenche pas ; voir Tags de contact mis à jour.)

Vous pouvez appliquer des tags automatiquement :

• Laissez votre agent IA étiqueter le contact pendant la conversation — configurez des règles d’étiquetage automatique dans la configuration de l’agent. C’est ainsi que fonctionne le modèle « une page de destination par publicité → un message d’entrée → une étiquette » si vous souhaitez étiqueter la source vous-même.
• Ou étiquetez manuellement depuis les Discussions ou la page Contacts.

Chaque fois qu’un tag pertinent change, le webhook se déclenche avec l’identifiant du clic associé, prêt à être transmis en tant que conversion.

L’URL du webhook est définie sur la balise elle-même, dans l’onglet Tags de l’éditeur de l’agent IA auquel le contact est assigné, et non dans les Paramètres. Chaque balise possède sa propre URL, et elles peuvent toutes pointer vers le même point de terminaison si vous souhaitez centraliser la réception de toutes les données.

Lire un identifiant de clic que vous avez déjà manqué #

ad_referral est également renvoyé par l’API à la fois sur GET /v1/contacts/{id} (en tant que adReferral) et sur le point de terminaison de la liste de contacts (en tant que ad_referral). Ainsi, si votre récepteur était hors ligne, ou si vous effectuez un rapprochement a posteriori, vous pouvez récupérer l’identifiant de clic au lieu d’attendre le prochain webhook. Les contacts arrivés avant que l’identifiant de clic ne leur soit associé ont null ici — la valeur ne peut être capturée qu’à partir du message entrant lui-même, il n’y a donc rien à remplir rétroactivement.

Limitations #

• Connexion officielle à l’API WhatsApp uniquement (pas la connexion web non officielle).
• La fonction intégrée Envoyer les résultats à Meta envoie les données de clic enregistrées par le script du site web ; elle n’envoie pas le ctwa_clid des publicités « Click-to-WhatsApp ». Pour celles-ci, ainsi que pour Google Ads, vous transférez les données via Zapier/Make/Pabbly. Si vous souhaitez une intégration native, informez le support à hi@youraiconnector.com.
• L’attribution est capturée à partir du moment où cette fonctionnalité est active. Elle ne peut pas être appliquée rétroactivement aux conversations ayant eu lieu auparavant.

Étapes suivantes #

• Webhooks — consultez la charge utile complète et les événements qui incluent ad_referral.
• Utiliser des balises pour étiqueter les contacts — configurez les balises qui portent les étapes de votre entonnoir.
• Attribution des clics publicitaires pour WhatsApp : faites correspondre les clics sur les publicités menant à votre propre site web avec la conversation WhatsApp.