
# 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 <span data-t="appName">Your AI Connector</span> 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. <span data-t="appName">Your AI Connector</span> 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](../get-started/creating-contacts.md) 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

<span data-t="appName">Your AI Connector</span> 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](webhooks.md)-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. <span data-t="appName">Your AI Connector</span> 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](webhooks.md#contact-tags-updated-webhook).)

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å <span data-t="supportEmail">hi@youraiconnector.com</span>.
- 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

- [Webhooks](webhooks.md) — se hela nyttolasten och vilka händelser som inkluderar `ad_referral`.
- [Använda taggar för att märka kontakter](../get-started/creating-tags.md) — ställ in de taggar som bär dina trattsteg.
