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

Rulezi reclame către o pagină de pe propriul tău site web cu un buton WhatsApp în schimb? Vezi Atribuirea clicurilor pe reclame pentru WhatsApp.

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:

O poți vedea fără nicio configurare: pagina contactului afișează o etichetă A venit din reclamă sub numele acestuia (treci cu cursorul peste ea pentru detaliile reclamei), panoul de contact de lângă chat o afișează de asemenea, iar Activitatea contactului începe cu accesarea reclamei. O poți citi și prin webhook-uri și API (vezi mai jos). Aceasta nu este o coloană î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.

Lead-uri care sosesc fără un număr de telefon #

Unii oameni care vă trimit mesaje dintr-o reclamă au numărul de telefon ascuns de WhatsApp. În acest caz, Meta transmite un ID privat pentru persoana respectivă în loc de un număr, iar contactul este creat cu un câmp telefonic gol. Acest lucru este normal. Răspunsurile, răspunsurile AI și follow-up-urile automate ajung în continuare la persoană, deoarece Your AI Connector îi contactează prin acel ID.

Lăsați câmpul telefonic gol pentru un astfel de contact. Nu introduceți propriul număr de afaceri în acesta: un mesaj nu poate fi trimis de la un număr către el însuși, așa că următorul follow-up automat ar eșua și contactul ar fi suspendat. Your AI Connector refuză acum salvarea unuia dintre propriile numere conectate ca număr de telefon al unui contact. Dacă persoana își partajează ulterior numărul sau vă trimite din nou un mesaj cu acesta vizibil, câmpul va fi completat automat.

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.

Anunțuri Click-to-Instagram și Click-to-Messenger #

Anunțurile care deschid un mesaj direct pe Instagram sau o conversație în Messenger sunt înregistrate în același mod, pe pagina de Facebook și contul de Instagram pe care le-ai conectat cu cardul Instagram & Messenger. Când cineva începe o conversație dintr-unul dintre aceste anunțuri, contactul primește un ad_referral cu channel setat la instagram sau messenger, source_type setat la ad și source_id setat la ID-ul anunțului. Acest lucru îți oferă anunțul din spatele fiecărui contact, astfel încât să poți calcula costul per rezervare pentru fiecare anunț.

Câteva diferențe față de WhatsApp:

• Nu există ctwa_clid; acel câmp este gol. Meta emite acel identificator de clic doar pentru WhatsApp.
• headline este titlul anunțului atunci când Meta îl trimite, iar source_url este linkul către imaginea sau videoclipul anunțului, atunci când există unul. body este gol.
• Dacă persoana de contact a provenit inițial dintr-un anunț și ulterior începe o conversație dintr-un anunț diferit, ad_referral afișează anunțul mai recent.
• Contactele din anunțurile Messenger includ anunțul începând cu 14 octombrie 2026. Contactele care au provenit dintr-un anunț Messenger înainte de acea dată nu au ad_referral, deoarece detaliile anunțului nu au fost înregistrate atunci și nu pot fi completate ulterior.
• Conversațiile din Messenger care încep prin atingerea butonului Începeți (Get Started) al Paginii nu sunt înregistrate. Eliminați butonul „Începeți” de pe Pagina dvs. (Meta Business Suite, setări Mesaje) astfel încât utilizatorii să înceapă conversația tastând, iar anunțul să fie înregistrat la primul lor mesaj.

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. Pentru reclamele care trimit oamenii mai întâi pe propriul tău site web, Your AI Connector poate trimite rezultatele către Meta pentru tine atunci când este aplicată o etichetă: vezi Trimite rezultatele către Meta. Pentru reclamele Click-to-WhatsApp, trimiți datele folosind webhook-uri și un instrument de automatizare.

Obiectul ad_referral este inclus în secțiunea contact a evenimentelor de webhook 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.)

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 este setat pe etichetă (tag) în sine, în fila Etichete (Tags) a editorului agentului AI căruia îi este alocat contactul, nu în Setări. Fiecare etichetă primește propriul URL și toate pot indica către același punct final (endpoint) dacă doriți un singur loc pentru a primi 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ă API WhatsApp (nu conexiunea web neoficială).
• Funcția încorporată Trimite rezultatele către Meta trimite datele despre clicuri înregistrate de scriptul site-ului web; aceasta nu trimite ctwa_clid pentru reclamele Click-to-WhatsApp. Pentru acestea, și pentru Google Ads, trimiți datele prin Zapier/Make/Pabbly. Dacă dorești o integrare nativă, anunță echipa de asistență la hi@youraiconnector.com.
• Atribuirea este capturată de acum înainte, 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 — vezi payload-ul complet și ce evenimente includ ad_referral.
• Utilizarea etichetelor pentru a marca contactele — configurează etichetele care poartă etapele pâlniei tale de vânzări.
• Atribuirea clicurilor pe reclame pentru WhatsApp: potrivește clicurile pe reclamele care duc către propriul tău site web cu conversația de pe WhatsApp.