Your AI Connector Docs

Click-to-WhatsApp advertentie-attributie

Als je Meta (Facebook/Instagram) “Klik naar WhatsApp”-advertenties gebruikt, kan Your AI Connector je vertellen van welke advertentie elke WhatsApp-lead afkomstig is — en je de Meta-klik-ID geven die je nodig hebt om echte conversies terug te rapporteren aan Meta. Hierdoor kunnen je advertentiecampagnes optimaliseren voor daadwerkelijke verkopen en boekingen, in plaats van alleen voor “mensen die een chat zijn gestart.”

Wat wordt vastgelegd

Wanneer iemand op een Klik-naar-WhatsApp-advertentie tikt en je bedrijf een bericht stuurt, voegt Meta verborgen verwijzingsinformatie toe aan dat eerste bericht. Your AI Connector leest dit automatisch en slaat het op bij de contactpersoon. Geen installatie, geen configuratie — het gebeurt gewoon.

De vastgelegde informatie wordt opgeslagen bij de contactpersoon als ad_referral en bevat:

Veld Wat het is
ctwa_clid De Meta-klik-ID. Dit is de waarde die je naar de Conversions API van Meta stuurt om een downstream-conversie toe te wijzen aan de exacte advertentieklik. Leeg voor verwijzingen via organische berichten (zie hieronder).
source_id De ID van de advertentie (of het bericht) waarop de persoon heeft geklikt.
source_type Ofwel ad (een betaalde Click-to-WhatsApp-advertentie) of post (een organisch Facebook/Instagram-bericht).
source_url De link die is gekoppeld aan de advertentie-inhoud.
headline De koptekst van de advertentie.
body De hoofdtekst van de advertentie.
channel Het kanaal waar de verwijzing vandaan kwam (momenteel altijd whatsapp).
captured_at Wanneer de verwijzing voor het eerst werd vastgelegd bij de contactpersoon.

Je kunt dit zien op het snelweergavepaneel van een contactpersoon als je hiervoor een aangepast veld hebt geconfigureerd, of het direct uitlezen via webhooks en de API (zie hieronder) — het wordt niet als een apart gelabeld veld weergegeven in de tabel Contactpersonen.

Eén ding dat de payload je niet vertelt: op welk van je nummers het gesprek binnenkwam. Er staat geen pagina-id of WhatsApp Business Account-id in. Bij een enkel nummer maakt dat niet uit; als je meerdere nummers op verschillende Facebook-pagina’s gebruikt, moet je dat aan jouw kant toewijzen.

Voor welke verbinding dit werkt

Dit werkt alleen voor de officiële WhatsApp API-verbinding. Meta levert de gestructureerde verwijzingsinformatie (inclusief ctwa_clid) alleen via de officiële WhatsApp Business API. De niet-officiële WhatsApp (web)-verbinding ontvangt dit niet — er zijn geen advertentieklikgegevens beschikbaar op die verbinding, vanwege de manier waarop deze werkt.

Dus als closed-loop advertentie-attributie belangrijk voor je is, voer je Click-to-WhatsApp-campagnes dan uit via een nummer dat is verbonden via de officiële WhatsApp API.

First-Touch-gedrag

De verwijzing wordt vastgelegd bij het eerste bericht dat een contactpersoon stuurt vanuit een advertentie. Als dezelfde contactpersoon later op een andere advertentie klikt en die nieuwere klik bevat een klik-ID, wordt de opgeslagen ad_referral vernieuwd, zodat de klik-ID actueel blijft voor rapportage. Verwijzingen via organische berichten (die geen ctwa_clid hebben) overschrijven nooit een eerder vastgelegde klik-ID van een betaalde advertentie.

De gegevens in Meta of Google Ads krijgen

Your AI Connector legt de attributiegegevens vast en stelt deze beschikbaar, maar verstuurt momenteel niet standaard conversies naar Meta of Google voor je. Je stuurt de gegevens door met behulp van webhooks en een automatiseringstool.

Het ad_referral-object is opgenomen in de contact-sectie van de uitgaande webhook-gebeurtenissen (bijvoorbeeld Nieuw bericht, Contact hervat, Contacttags bijgewerkt en analysegebeurtenissen zoals Afspraak geboekt).

Een typische closed-loop opzet:

  1. Een lead klikt op je Klik-naar-WhatsApp-advertentie en stuurt je een bericht. Your AI Connector registreert ad_referral (inclusief ctwa_clid) bij de contactpersoon.
  2. Naarmate de lead vordert — een gesprek geboekt, klant geworden, verloren — markeer je dat resultaat (zie “De trechterfase bijhouden” hieronder).
  3. Er wordt een webhook geactiveerd naar je automatiseringstool (Zapier, Make of Pabbly) die zowel het resultaat als de ctwa_clid van de contactpersoon bevat.
  4. Je automatiseringstool roept de Conversions API van Meta aan (met behulp van action_source = business_messaging en de ctwa_clid) of Google Ads (Offline conversie-import / Verbeterde conversies voor leads) om de conversie te rapporteren.

Op deze manier leren Meta en Google welke advertenties echte resultaten opleveren en optimaliseren ze daarop.

De trechterfase bijhouden

Om een conversie te rapporteren heb je meestal twee dingen nodig: de klik-id (automatisch vastgelegd) en het resultaat (dat je zelf instelt). De meest betrouwbare manier om een resultaat te koppelen is met tags, omdat het toepassen van een tag de contact_tags_updated webhook activeert — en die payload bevat de ad_referral van de contactpersoon. (Het verwijderen van een tag activeert deze niet; zie Contact Tags Updated.)

Je kunt tags automatisch toepassen:

  • Laat je AI-agent de contactpersoon taggen tijdens het gesprek — stel regels voor automatisch taggen in via de configuratie van de agent. Dit is hoe het “één landingspagina per advertentie → één welkomstbericht → één tag”-patroon werkt als je de bron zelf wilt labelen.
  • Of tag handmatig vanuit Chats of de Contacten-pagina.

Wanneer een relevante tag verandert, wordt de webhook geactiveerd met de bijgevoegde klik-id, klaar om door te sturen als conversie.

De webhook-URL wordt ingesteld op de tag zelf, in het tabblad Tags van de agent (of campagne) waartoe de contactpersoon behoort — niet in Instellingen. Elke tag krijgt zijn eigen URL, en ze kunnen allemaal naar hetzelfde eindpunt verwijzen als je alles op één plek wilt ontvangen.

Een click-id lezen die je al hebt gemist

ad_referral wordt ook door de API geretourneerd op zowel GET /v1/contacts/{id} (als adReferral) als het eindpunt voor de contactenlijst (als ad_referral), dus als je ontvanger offline was, of als je achteraf wilt reconciliëren, kun je de click-id teruglezen in plaats van te wachten op de volgende webhook. Contacten die arriveerden voordat de click-id bij hen werd geregistreerd, hebben hier null — de waarde kan alleen worden vastgelegd vanuit het inkomende bericht zelf, dus er is niets dat achteraf kan worden ingevuld.

Beperkingen

  • Alleen officiële WhatsApp API-verbinding (geen onofficiële webverbinding).
  • Nog geen native, one-click Meta CAPI- of Google Ads-integratie — je stuurt de gegevens door via Zapier/Make/Pabbly. Als je een native integratie wilt, laat het dan weten aan de support via hi@youraiconnector.com.
  • Attributie wordt vanaf het moment dat dit live staat vastgelegd. Het kan niet met terugwerkende kracht worden toegepast op gesprekken die eerder hebben plaatsgevonden.

Volgende stappen