Your AI Connector Docs

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 ».

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 :

Champ Description
ctwa_clid L’identifiant de clic Meta. Il s’agit de la valeur que vous envoyez à l’API Conversions de Meta pour attribuer une conversion en aval au clic publicitaire exact. Vide pour les références provenant de publications organiques (voir ci-dessous).
source_id L’identifiant de la publicité (ou de la publication) sur laquelle la personne a cliqué.
source_type Soit ad (une publicité payante « Click-to-WhatsApp ») ou post (une publication organique Facebook/Instagram).
source_url Le lien associé au contenu publicitaire.
headline Le titre de la publicité.
body Le corps du texte de la publicité.
channel Le canal par lequel la référence est arrivée (actuellement toujours whatsapp).
captured_at Le moment où la référence a été enregistrée pour la première fois sur le contact.

Vous pouvez le voir sur le panneau de vue rapide d’un contact si vous avez configuré un champ personnalisé pour cela, ou le lire directement via des webhooks et l’API (voir ci-dessous) — il n’est pas séparé en tant que champ étiqueté propre dans la table 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é.

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.

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, mais ne transmet pas nativement les conversions à Meta ou Google pour vous aujourd’hui. 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 le tag lui-même, dans l’onglet Tags de l’agent (ou de la campagne) auquel appartient le contact — et non dans les paramètres. Chaque tag possède sa propre URL, et ils peuvent tous 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).
  • Pas encore d’intégration native en un clic avec Meta CAPI ou Google Ads — vous transférez les données via Zapier/Make/Pabbly. Si vous souhaitez une intégration native, faites-le savoir au 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