Your AI Connector Docs

Attribuering för Click-to-WhatsApp-annonser

Om du kör Meta-annonser (Facebook/Instagram) av typen “Klicka för att chatta på WhatsApp”, kan Your AI Connector berätta för dig vilken annons varje WhatsApp-lead kom ifrån – och ge dig det Meta-klick-ID du behöver för att rapportera faktiska konverteringar tillbaka till Meta. Detta gör att dina annonskampanjer kan optimeras för faktiska försäljningar och bokningar, inte bara för “personer som startade en chatt.”


Vad som registreras

När någon trycker på en “Klicka för att chatta på WhatsApp”-annons och skickar ett meddelande till ditt företag, bifogar Meta dold hänvisningsinformation till det första meddelandet. Your AI Connector läser av den automatiskt och sparar den på kontakten. Ingen installation, ingen konfiguration – det sker bara.

Den insamlade informationen sparas på kontakten som ad_referral och innehåller:

Fält Vad det är
ctwa_clid Meta-klick-identifieraren. Detta är värdet du skickar till Metas Conversions API för att attribuera en konvertering längre ner i tratten till det exakta annonsklicket. Tomt för hänvisningar från organiska inlägg (se nedan).
source_id ID för annonsen (eller inlägget) som personen klickade på.
source_type Antingen ad (en betald Click-to-WhatsApp-annons) eller post (ett organiskt Facebook/Instagram-inlägg).
source_url Länken kopplad till annonsinnehållet.
headline Annonsens rubriktext.
body Annonsens brödtext.
channel Kanalen som hänvisningen kom via (för närvarande alltid whatsapp).
captured_at När hänvisningen först registrerades på kontakten.

Du kan se detta på en kontakts snabbvy-panel om du har konfigurerat ett anpassat fält för det, eller läsa det direkt via webhooks och API:et (se nedan) — det visas inte som ett eget märkt fält i kontakttabellen.

En sak som nyttolasten inte berättar för dig: vilket av dina nummer konversationen kom in på. Det finns inget sid-id eller WhatsApp Business Account-id i den. Med ett enda nummer spelar det ingen roll; om du kör flera nummer på olika Facebook-sidor måste du mappa detta på din sida.


Vilken anslutning detta fungerar med

Detta fungerar endast med den officiella WhatsApp API-anslutningen. Meta levererar endast den strukturerade hänvisningsinformationen (inklusive ctwa_clid) via det officiella WhatsApp Business API:et. Den inofficiella WhatsApp-anslutningen (webb) tar inte emot detta — det finns ingen annonsklickdata tillgänglig för den anslutningen, på grund av hur den är utformad.

Så om sluten annonsattribuering är viktig för dig, kör dina Click-to-WhatsApp-kampanjer via ett nummer som är anslutet via det officiella WhatsApp API:et.


Beteende vid första kontakt

Hänvisningen registreras vid det första meddelandet som en kontakt skickar från en annons. Om samma kontakt senare klickar på en annan annons och det nyare klicket innehåller ett klick-ID, uppdateras det sparade ad_referral så att klick-ID:t förblir aktuellt för rapportering. Hänvisningar från organiska inlägg (som saknar ctwa_clid) skriver aldrig över ett tidigare sparat klick-ID från en betald annons.


Att få in data i Meta eller Google Ads

Your AI Connector fångar upp attributionsdatan och gör den tillgänglig, men den skickar idag inte konverteringar vidare till Meta eller Google åt dig inbyggt. Du skickar vidare datan med hjälp av webhooks och ett automatiseringsverktyg.

Objektet ad_referral inkluderas i sektionen contact för utgående webhook-händelser (till exempel Nytt meddelande, Kontakt återupptagen, Kontakttaggar uppdaterade och analyshändelser som Bokad tid).

En typisk konfiguration för sluten attribuering:

  1. En lead klickar på din “Klicka för att chatta på WhatsApp”-annons och skickar ett meddelande till dig. Your AI Connector sparar ad_referral (inklusive ctwa_clid) på kontakten.
  2. Allt eftersom leaden går vidare – bokar ett samtal, blir kund, går förlorad – markerar du det resultatet (se “Hantera trattstadiet” nedan).
  3. En webhook skickas till ditt automatiseringsverktyg (Zapier, Make eller Pabbly) som innehåller både resultatet och kontaktens ctwa_clid.
  4. Ditt automatiseringsverktyg anropar Metas Conversions API (med action_source = business_messaging och ctwa_clid) eller Google Ads (Offline Conversion Import / Enhanced Conversions for Leads) för att rapportera konverteringen.

På så sätt lär sig Meta och Google vilka annonser som gav faktiska resultat och optimerar mot dem.


Hantera trattstadiet

För att rapportera en konvertering behöver du vanligtvis två saker: klick-id (som fångas upp automatiskt) och resultatet (som du anger). Det mest tillförlitliga sättet att koppla ett resultat är med taggar, eftersom applicering av en tagg utlöser contact_tags_updated-webhooken — och den nyttolasten inkluderar kontaktens ad_referral. (Att ta bort en tagg utlöser den inte; se Kontakt-taggar uppdaterade.)

Du kan använda taggar automatiskt:

  • Låt din AI-agent tagga kontakten under konversationen — ställ in regler för automatisk taggning i agentens konfiguration. Det är så mönstret “en landningssida per annons → ett ingångsmeddelande → en tagg” fungerar om du vill märka källan själv.
  • Eller tagga manuellt från Chattar eller kontaktsidan.

Varje gång en relevant tagg ändras utlöses webhooken med klick-id:t bifogat, redo att vidarebefordras som en konvertering.

Webhook-URL:en ställs in på själva taggen, under fliken Taggar för agenten (eller kampanjen) som kontakten tillhör – inte i Inställningar. Varje tagg får sin egen URL, och de kan alla peka på samma slutpunkt om du vill ha en plats för att ta emot allt.

Läsa ett klick-id som du redan missat

ad_referral returneras även av API:et på både GET /v1/contacts/{id} (som adReferral) och slutpunkten för kontaktlistan (som ad_referral), så om din mottagare var nere, eller om du stämmer av i efterhand, kan du läsa tillbaka klick-id:t istället för att vänta på nästa webhook. Kontakter som anlände innan klick-id:t registrerades på dem har null här – värdet kan endast fångas från det inkommande meddelandet självt, så det finns inget att fylla i retroaktivt.


Begränsningar

  • Endast officiell WhatsApp API-anslutning (inte den inofficiella webbanslutningen).
  • Ingen inbyggd Meta CAPI- eller Google Ads-integrering med ett klick ännu — du vidarebefordrar data via Zapier/Make/Pabbly. Om du vill ha en inbyggd integrering, meddela supporten på hi@youraiconnector.com.
  • Attribuering registreras framåt i tiden, från det ögonblick detta är live. Den kan inte efterregistreras för konversationer som skedde tidigare.

Nästa steg