# 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](../get-started/creating-contacts.md) 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](webhooks.md)-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](webhooks.md#contact-tags-updated-webhook).) 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 - [Webhooks](webhooks.md) — bekijk de volledige payload en welke gebeurtenissen `ad_referral` bevatten. - [Tags gebruiken om contactpersonen te labelen](../get-started/creating-tags.md) — stel de tags in die je trechterfasen markeren.