Your AI Connector Docs

Attribuering af Click-to-WhatsApp-annoncer

Hvis du kører Meta (Facebook/Instagram) “Klik til WhatsApp”-annoncer, kan Your AI Connector fortælle dig, hvilken annonce hver WhatsApp-lead kom fra — og give dig den Meta-klik-identifikator, du skal bruge for at rapportere faktiske konverteringer tilbage til Meta. Dette gør det muligt for dine annoncekampagner at optimere efter faktiske salg og bookinger, ikke kun efter “folk, der startede en chat.”

Kører du i stedet annoncer til en side på dit eget websted med en WhatsApp-knap? Se Annonceklik-attribuering for WhatsApp.


Hvad bliver registreret

Når nogen trykker på en Klik-til-WhatsApp-annonce og sender en besked til din virksomhed, vedhæfter Meta skjulte henvisningsoplysninger til den første besked. Your AI Connector læser dem automatisk og gemmer dem på kontakten. Ingen opsætning, ingen konfiguration — det sker bare.

De registrerede oplysninger gemmes på kontakten som ad_referral og indeholder:

Felt Hvad det er
ctwa_clid Meta-klikidentifikatoren. Dette er værdien, du sender til Metas Conversions API for at tilskrive en efterfølgende konvertering tilbage til det præcise annonceklik. Tom for organiske opslagshenvisninger (se nedenfor).
source_id ID’et på annoncen (eller opslaget), som personen klikkede på.
source_type Enten ad (en betalt Click-to-WhatsApp-annonce) eller post (et organisk Facebook/Instagram-opslag).
source_url Linket tilknyttet annonceindholdet.
headline Annoncens overskriftstekst.
body Annoncens brødtekst.
channel Kanalen, som henvisningen ankom via: whatsapp, instagram eller messenger.
captured_at Hvornår henvisningen første gang blev registreret på kontakten.

Du kan se det uden nogen form for opsætning: kontaktpersonens side viser en Kom fra annonce-etiket under deres navn (hold musen over den for at se annoncedetaljer), kontaktpanelet ved siden af chatten viser det også, og kontaktpersonens aktivitet starter med annoncetrykket. Du kan også læse det via webhooks og API’et (se nedenfor). Det er ikke en kolonne i tabellen Kontakter.

Én ting, som payloaden ikke fortæller dig: hvilket af dine numre samtalen kom ind på. Der er intet side-id eller WhatsApp Business Account-id i den. Med et enkelt nummer betyder det ikke noget; hvis du kører flere numre på forskellige Facebook-sider, bliver du nødt til at mappe det på din side.


Leads, der ankommer uden et telefonnummer

Nogle personer, der sender dig en besked fra en annonce, har deres telefonnummer skjult af WhatsApp. I det tilfælde udleverer Meta et privat id for personen i stedet for et nummer, og kontakten oprettes med et tomt telefonfelt. Det er forventet. Svar, AI-svar og automatiske opfølgninger når stadig frem til personen, fordi Your AI Connector adresserer dem via dette id.

Lad telefonfeltet være tomt på en sådan kontakt. Indtast ikke dit eget virksomhedsnummer i det: en besked kan ikke sendes fra et nummer til sig selv, så den næste automatiske opfølgning ville fejle, og kontakten ville blive sat på pause. Your AI Connector nægter nu at gemme et af dine egne tilsluttede numre som en kontakts telefonnummer. Hvis personen senere deler sit nummer eller sender dig en besked igen, hvor det er synligt, udfyldes det automatisk.


Hvilken forbindelse dette virker på

Dette virker kun på den officielle WhatsApp API-forbindelse. Meta leverer kun de strukturerede henvisningsoplysninger (inklusive ctwa_clid) gennem den officielle WhatsApp Business API. Den uofficielle WhatsApp (web)-forbindelse modtager dem ikke — der er ingen annonceklikdata tilgængelige på den forbindelse, hvilket er et designvalg i måden, den fungerer på.

Så hvis closed-loop annonceattribuering er vigtig for dig, skal du køre dine Click-to-WhatsApp-kampagner via et nummer, der er forbundet via den officielle WhatsApp API.


Click-to-Instagram og Click-to-Messenger-annoncer

Annoncer, der åbner en Instagram DM eller en Messenger-chat, registreres på samme måde på den Facebook-side og Instagram-konto, du har forbundet med Instagram & Messenger-kortet. Når nogen starter en chat fra en af disse annoncer, får kontakten en ad_referral med channel sat til instagram eller messenger, source_type sat til ad og source_id sat til annonce-ID’et. Det giver dig annoncen bag hver kontakt, så du kan beregne pris pr. booking pr. annonce.

Et par forskelle fra WhatsApp:

  • Der er ingen ctwa_clid; det felt er tomt. Meta udsteder kun dette klik-id for WhatsApp.
  • headline er annoncens titel, når Meta sender den, og source_url er annoncens billede- eller videolink, når et sådant findes. body er tomt.
  • Hvis kontakten først kom fra én annonce og senere starter en chat fra en anden annonce, viser ad_referral den nyere annonce.
  • Kontakter fra Messenger-annoncer indeholder annoncen fra 14. oktober 2026 og frem. Kontakter, der kom fra en Messenger-annonce før denne dato, har ingen ad_referral, da annonceoplysningerne ikke blev registreret dengang og ikke kan udfyldes efterfølgende.
  • Messenger-chats, der starter med et tryk på sidens Kom i gang-knap, bliver ikke registreret. Fjern knappen Kom i gang fra din side (Meta Business Suite, Indbakke-indstillinger), så folk starter chatten ved at skrive, og annoncen bliver registreret ved deres første besked.

First-Touch-adfærd

Henvisningen registreres på den første besked, en kontakt sender fra en annonce. Hvis den samme kontakt senere klikker på en anden annonce, og det nyere klik indeholder et klik-id, opdateres det gemte ad_referral, så klik-id’et forbliver aktuelt til rapportering. Organiske opslagshenvisninger (som ikke har noget ctwa_clid) overskriver aldrig et tidligere registreret klik-id fra en betalt annonce.


Sådan får du dataene ind i Meta eller Google Ads

Your AI Connector indsamler og eksponerer attributionsdataene. For annoncer, der først sender folk til dit eget websted, kan Your AI Connector sende resultater til Meta for dig, når et tag anvendes: se Send resultater til Meta. For Click-to-WhatsApp-annoncer videresender du dataene ved hjælp af webhooks plus et automatiseringsværktøj.

Objektet ad_referral er inkluderet i sektionen contact i de udgående webhook-hændelser (for eksempel Ny besked, Kontakt genoptaget, Kontakttags opdateret og analytiske hændelser såsom Booket aftale).

En typisk closed-loop-opsætning:

  1. En lead klikker på din Klik-til-WhatsApp-annonce og sender dig en besked. Your AI Connector gemmer ad_referral (inklusive ctwa_clid) på kontakten.
  2. Efterhånden som leadet gør fremskridt — bookede et opkald, blev kunde, gik tabt — markerer du resultatet (se “Overførsel af tragtstadiet” nedenfor).
  3. Et webhook udløses til dit automatiseringsværktøj (Zapier, Make eller Pabbly), der indeholder både resultatet og kontaktens ctwa_clid.
  4. Dit automatiseringsværktøj kalder Metas Conversions API (ved hjælp af action_source = business_messaging og ctwa_clid) eller Google Ads (Offline Conversion Import / Enhanced Conversions for Leads) for at rapportere konverteringen.

På denne måde lærer Meta og Google, hvilke annoncer der skabte reelle resultater, og optimerer mod dem.


Videreførelse af tragtstadiet

For at rapportere en konvertering skal du normalt bruge to ting: klik-id’et (som indsamles automatisk) og resultatet (som du selv angiver). Den mest pålidelige måde at tilknytte et resultat på er ved hjælp af tags, da anvendelse af et tag udløser contact_tags_updated-webhooken — og denne payload inkluderer kontaktens ad_referral. (Fjernelse af et tag udløser den ikke; se Kontakt-tags opdateret.)

Du kan anvende tags automatisk:

  • Lad din AI-agent tagge kontakten under samtalen — opsæt regler for automatisk tagging i agentens konfiguration. Det er sådan, “én landingsside pr. annonce → én indgangsbesked → ét tag”-mønsteret fungerer, hvis du selv vil mærke kilden.
  • Eller tag manuelt fra Chats eller Kontaktsiden.

Hver gang et relevant tag ændres, sendes webhooken med det tilknyttede klik-id, klar til at blive videresendt som en konvertering.

Webhook-URL’en indstilles på selve tagget under fanen Tags i editoren for den AI-agent, som kontakten er tildelt, ikke i Indstillinger. Hvert tag får sin egen URL, og de kan alle pege på det samme endpoint, hvis du ønsker ét sted at modtage alt.

Læsning af et klik-id, du allerede er gået glip af

ad_referral returneres også af API’en på både GET /v1/contacts/{id} (som adReferral) og kontaktliste-endpointet (som ad_referral), så hvis din modtager var nede, eller du afstemmer efterfølgende, kan du læse klik-id’et tilbage i stedet for at vente på den næste webhook. Kontakter, der ankom, før klik-id’et blev registreret på dem, har null her — værdien kan kun fanges fra selve den indgående besked, så der er intet at udfylde retrospektivt.


Begrænsninger

  • Kun officiel WhatsApp API-forbindelse (ikke den uofficielle webforbindelse).
  • Den indbyggede Send resultater til Meta sender klikdataene, der er registreret af webstedets script; den sender ikke ctwa_clid for Click-to-WhatsApp-annoncer. For disse, og for Google Ads, videresender du dataene via Zapier/Make/Pabbly. Hvis du ønsker en indbygget integration, så giv support besked på hi@youraiconnector.com.
  • Attribuering indsamles fremadrettet fra det øjeblik, dette er live. Det kan ikke efterregistreres for samtaler, der fandt sted tidligere.

Næste skridt