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

Kör du annonser till en sida på din egen webbplats med en WhatsApp-knapp istället? Se Annonsklicksattribuering för WhatsApp.

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 Metas klickidentifierare. Detta är värdet du skickar till Metas Conversions API för att tillskriva en konvertering längre ner i tratten till det exakta annonsklicket. Tomt för organiska inläggshänvisningar (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: whatsapp, instagram eller messenger.
captured_at När hänvisningen först registrerades på kontakten.

Du kan se det utan någon konfiguration: kontaktsidan visar en etikett för Kom från annons under namnet (för muspekaren över den för annonsdetaljer), kontaktpanelen bredvid chatten visar den också, och kontaktens aktivitet börjar med annonsklicket. Du kan även läsa av det via webhooks och API:et (se nedan). Det är inte en kolumn 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.

Leads som inkommer utan telefonnummer

Vissa personer som skickar meddelanden till dig från en annons har dolt sitt telefonnummer i WhatsApp. I sådana fall tillhandahåller Meta ett privat ID för personen istället för ett nummer, och kontakten skapas med ett tomt telefonfält. Detta är förväntat. Svar, AI-svar och automatiska uppföljningar når fortfarande personen, eftersom Your AI Connector adresserar dem via detta ID.

Lämna telefonfältet tomt för en sådan kontakt. Skriv inte in ditt eget företagsnummer där: ett meddelande kan inte skickas från ett nummer till sig självt, så nästa automatiska uppföljning skulle misslyckas och kontakten skulle pausas. Your AI Connector vägrar nu att spara ett av dina egna anslutna nummer som en kontakts telefonnummer. Om personen senare delar sitt nummer, eller skickar ett meddelande till dig igen med numret synligt, fylls det i automatiskt.

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.

Click-to-Instagram- och Click-to-Messenger-annonser

Annonser som öppnar ett Instagram DM eller en Messenger-chatt registreras på samma sätt, på den Facebook-sida och det Instagram-konto som du anslöt med kortet Instagram & Messenger. När någon startar en chatt från en av dessa annonser får kontakten en ad_referral med channel inställt på instagram eller messenger, source_type inställt på ad och source_id inställt på annons-ID:t. Det ger dig annonsen bakom varje kontakt, så att du kan räkna ut kostnad per bokning per annons.

Några skillnader från WhatsApp:

  • Det finns ingen ctwa_clid; det fältet är tomt. Meta utfärdar endast den klickidentifieraren för WhatsApp.
  • headline är annonsens titel när Meta skickar den, och source_url är annonsens bild- eller videolänk när en sådan finns. body är tom.
  • Om kontakten först kom från en annons och senare startar en chatt från en annan annons, visar ad_referral den nyare annonsen.
  • Messenger-annonskontakter bär med sig annonsen från och med 14 oktober 2026. Kontakter som kom från en Messenger-annons före det datumet har ingen ad_referral, eftersom annonsdetaljerna inte registrerades då och inte kan fyllas i i efterhand.
  • Messenger-chattar som startar med ett tryck på sidans Kom igång-knapp registreras inte. Ta bort knappen Kom igång från din sida (Meta Business Suite, inkorgsinställningar) så att folk startar chatten genom att skriva, så registreras annonsen vid deras första meddelande.

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 attriberingsdata och exponerar den. För annonser som först skickar besökare till din egen webbplats kan Your AI Connector skicka resultat till Meta åt dig när en tagg appliceras: se Skicka resultat till Meta. För Click-to-WhatsApp-annonser vidarebefordrar du 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 i redigeraren för den AI-agent som kontakten är tilldelad, inte i Inställningar. Varje tagg får sin egen URL, och de kan alla peka på samma slutpunkt om du vill ha en gemensam 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).
  • Den inbyggda funktionen Skicka resultat till Meta skickar klickdatan som registrerats av webbplatsskriptet; den skickar inte ctwa_clid för Click-to-WhatsApp-annonser. För dessa, och för Google Ads, vidarebefordrar du datan via Zapier/Make/Pabbly. Om du vill ha en inbyggd integration, meddela supporten på hi@youraiconnector.com.
  • Attribuering fångas upp framåtriktat, från det ögonblick detta är live. Den kan inte läggas till i efterhand för konversationer som skedde tidigare.

Nästa steg