# Atribuirea reclamelor de tip Click-to-WhatsApp Dacă rulezi reclame Meta (Facebook/Instagram) de tip „Click to WhatsApp”, Your AI Connector îți poate spune din ce reclamă provine fiecare lead de pe WhatsApp — și îți poate oferi identificatorul de clic Meta de care ai nevoie pentru a raporta conversiile reale înapoi către Meta. Acest lucru permite campaniilor tale publicitare să se optimizeze pentru vânzări și rezervări reale, nu doar pentru „persoane care au început o conversație”. --- ## Ce este capturat Atunci când cineva atinge o reclamă „Click-to-WhatsApp” și trimite un mesaj afacerii tale, Meta atașează informații ascunse de referință la acel prim mesaj. Your AI Connector le citește automat și le stochează în profilul contactului. Fără configurare, fără setări — se întâmplă pur și simplu. Informațiile capturate sunt stocate în contact sub formă de `ad_referral` și conțin: | Câmp | Ce reprezintă | |---|---| | `ctwa_clid` | Identificatorul de clic Meta. Aceasta este valoarea pe care o trimiți către Conversions API de la Meta pentru a atribui o conversie ulterioară exact acelui clic pe reclamă. Este gol pentru referințele din postări organice (vezi mai jos). | | `source_id` | ID-ul reclamei (sau postării) pe care a dat clic persoana. | | `source_type` | Fie `ad` (o reclamă plătită Click-to-WhatsApp), fie `post` (o postare organică pe Facebook/Instagram). | | `source_url` | Linkul asociat conținutului reclamei. | | `headline` | Textul titlului reclamei. | | `body` | Textul corpului reclamei. | | `channel` | Canalul pe care a sosit referința (în prezent, întotdeauna `whatsapp`). | | `captured_at` | Momentul în care referința a fost înregistrată pentru prima dată în contact. | Poți vedea acest lucru în [panoul de vizualizare rapidă](../get-started/creating-contacts.md) al unui contact dacă ai configurat un câmp personalizat pentru acesta, sau îl poți citi direct prin webhook-uri și API (vezi mai jos) — nu este separat ca un câmp etichetat propriu în tabelul Contacte. > **Un lucru pe care payload-ul nu ți-l spune:** pe care dintre numerele tale a venit conversația. Nu conține niciun id de pagină sau id de cont WhatsApp Business. Cu un singur număr, acest lucru nu contează; dacă rulezi mai multe numere pe diferite pagini de Facebook, va trebui să mapezi acest lucru de partea ta. --- ## Pe ce conexiune funcționează > Acest lucru funcționează **doar pe conexiunea oficială WhatsApp API.** Meta livrează informațiile structurate de referință (inclusiv `ctwa_clid`) doar prin API-ul oficial WhatsApp Business. **Conexiunea neoficială WhatsApp (web) nu le primește** — nu există date despre click-urile pe reclame disponibile pe acea conexiune, din cauza modului în care este concepută. Așadar, dacă atribuirea reclamelor de tip „closed-loop” este importantă pentru tine, rulează campaniile Click-to-WhatsApp printr-un număr conectat prin API-ul oficial WhatsApp. --- ## Comportamentul la primul contact Referința este capturată la **primul** mesaj pe care un contact îl trimite dintr-o reclamă. Dacă același contact dă clic ulterior pe o reclamă diferită și acel clic mai nou conține un identificator de clic, `ad_referral` stocat este actualizat, astfel încât ID-ul de clic să rămână curent pentru raportare. Referințele din postări organice (care nu au un `ctwa_clid`) nu suprascriu niciodată un ID de clic de reclamă plătită capturat anterior. --- ## Introducerea datelor în Meta sau Google Ads Your AI Connector captează datele de atribuire și le expune, dar **nu** trimite nativ conversiile către Meta sau Google pentru tine în prezent. Tu transmiți datele folosind webhook-uri și un instrument de automatizare. Obiectul `ad_referral` este inclus în secțiunea `contact` a evenimentelor de [webhook](webhooks.md) de ieșire (de exemplu, Mesaj Nou, Contact Reluat, Etichete Contact Actualizate și evenimente de analiză precum Programare Rezervată). O configurare tipică de tip „closed-loop”: 1. Un lead dă clic pe reclama ta „Click-to-WhatsApp” și îți trimite un mesaj. Your AI Connector înregistrează `ad_referral` (inclusiv `ctwa_clid`) în profilul contactului. 2. Pe măsură ce lead-ul avansează — a rezervat un apel, a devenit client, a fost pierdut — marchezi acel rezultat (vezi „Gestionarea etapei din pâlnia de vânzări” mai jos). 3. Un webhook este declanșat către instrumentul tău de automatizare (Zapier, Make sau Pabbly), transmițând atât rezultatul, cât și `ctwa_clid`-ul contactului. 4. Instrumentul tău de automatizare apelează API-ul de Conversii Meta (folosind `action_source = business_messaging` și `ctwa_clid`) sau Google Ads (Import conversii offline / Conversii îmbunătățite pentru lead-uri) pentru a raporta conversia. În acest fel, Meta și Google află ce anunțuri au produs rezultate reale și se optimizează în funcție de acestea. --- ## Transmiterea etapei din pâlnie Pentru a raporta o conversie, de obicei ai nevoie de două lucruri: ID-ul clic-ului (capturat automat) și rezultatul (pe care îl setezi tu). Cea mai sigură metodă de a atașa un rezultat este prin **etichete**, deoarece aplicarea unei etichete declanșează webhook-ul `contact_tags_updated` — iar acel payload include `ad_referral` al contactului. (Eliminarea unei etichete nu îl declanșează; vezi [Contact Tags Updated](webhooks.md#contact-tags-updated-webhook).) Poți aplica etichete automat: - Lasă agentul tău AI să eticheteze contactul în timpul conversației — configurează reguli de etichetare automată în setările agentului. Așa funcționează modelul „o pagină de destinație per reclamă → un mesaj de intrare → o etichetă” dacă dorești să etichetezi singur sursa. - Sau etichetează manual din secțiunea Chat-uri sau din pagina de Contacte. Ori de câte ori o etichetă relevantă se modifică, webhook-ul se declanșează cu ID-ul de click atașat, gata de a fi transmis ca o conversie. URL-ul webhook-ului este setat pe etichetă (tag) în sine, în fila **Etichete** a agentului (sau campaniei) de care aparține contactul — nu în Setări. Fiecare etichetă primește propriul URL și toate pot indica către același endpoint dacă dorești un singur loc în care să primești totul. ### Citirea unui id de click pe care l-ai ratat deja `ad_referral` este, de asemenea, returnat de API atât pe `GET /v1/contacts/{id}` (ca `adReferral`), cât și pe endpoint-ul listei de contacte (ca `ad_referral`), deci dacă receptorul tău a fost indisponibil sau dacă faci reconcilierea ulterior, poți citi id-ul de click înapoi în loc să aștepți următorul webhook. Contactele care au sosit înainte ca id-ul de click să fie înregistrat pe ele au `null` aici — valoarea poate fi capturată doar din mesajul primit, așa că nu există nimic de completat retroactiv. --- ## Limitări - Doar conexiune oficială WhatsApp API (nu conexiunea web neoficială). - Nu există încă o integrare nativă, cu un singur clic, pentru Meta CAPI sau Google Ads — redirecționați datele prin Zapier/Make/Pabbly. Dacă doriți o integrare nativă, anunțați echipa de asistență la hi@youraiconnector.com. - Atribuirea este capturată începând de acum, din momentul în care aceasta este activă. Nu poate fi completată retroactiv pentru conversațiile care au avut loc înainte. --- ## Pașii următori - [Webhook-uri](webhooks.md) — vezi payload-ul complet și ce evenimente includ `ad_referral`. - [Utilizarea etichetelor pentru a marca contactele](../get-started/creating-tags.md) — configurează etichetele care conțin etapele pâlniei tale de vânzări.