Atrybucja reklam typu „Click-to-WhatsApp” #

Jeśli prowadzisz reklamy Meta (Facebook/Instagram) typu „Kliknij, aby przejść do WhatsApp”, Your AI Connector może wskazać, z której reklamy pochodzi każdy lead z WhatsAppa — i przekazać Ci identyfikator kliknięcia Meta, którego potrzebujesz, aby raportować rzeczywiste konwersje do Meta. Dzięki temu Twoje kampanie reklamowe mogą optymalizować się pod kątem faktycznej sprzedaży i rezerwacji, a nie tylko „osób, które rozpoczęły czat”.

Chcesz wyświetlać reklamy kierujące do strony w Twojej witrynie z przyciskiem WhatsApp? Zobacz Atrybucja kliknięć reklam dla WhatsApp.

Co jest rejestrowane #

Gdy ktoś kliknie reklamę typu „Kliknij, aby przejść do WhatsApp” i wyśle wiadomość do Twojej firmy, Meta dołącza ukryte informacje o źródle do tej pierwszej wiadomości. Your AI Connector odczytuje je automatycznie i zapisuje w danych kontaktu. Bez konfiguracji, bez ustawień — to dzieje się samo.

Zarejestrowane informacje są przechowywane w kontakcie jako ad_referral i zawierają:

Możesz to zobaczyć bez żadnej konfiguracji: strona kontaktu wyświetla etykietę Pochodzi z reklamy pod jego imieniem i nazwiskiem (najedź kursorem, aby zobaczyć szczegóły reklamy), panel kontaktu obok czatu również ją pokazuje, a aktywność kontaktu rozpoczyna się od kliknięcia w reklamę. Możesz to również odczytać za pomocą webhooków i API (patrz poniżej). Nie jest to kolumna w tabeli Kontakty.

Jedna rzecz, o której ładunek nie informuje: na który z Twoich numerów wpłynęła konwersacja. Nie ma w nim identyfikatora strony (page id) ani identyfikatora konta WhatsApp Business (WhatsApp Business Account id). Przy jednym numerze nie ma to znaczenia; jeśli obsługujesz kilka numerów na różnych stronach na Facebooku, musisz zmapować to po swojej stronie.

Leady, które docierają bez numeru telefonu #

Niektóre osoby, które wysyłają do Ciebie wiadomość z reklamy, mają ukryty numer telefonu w WhatsApp. W takim przypadku Meta przekazuje prywatny identyfikator danej osoby zamiast numeru, a kontakt jest tworzony z pustym polem telefonu. Jest to zachowanie oczekiwane. Odpowiedzi, odpowiedzi AI oraz automatyczne działania następcze nadal docierają do tej osoby, ponieważ Your AI Connector kieruje je do niej za pomocą tego identyfikatora.

Pozostaw pole telefonu puste w przypadku takiego kontaktu. Nie wpisuj w nie własnego numeru firmowego: wiadomości nie można wysłać z numeru na ten sam numer, więc kolejne automatyczne działanie następcze zakończyłoby się niepowodzeniem, a kontakt zostałby wstrzymany. Your AI Connector od teraz odmawia zapisania jednego z Twoich własnych podłączonych numerów jako numeru telefonu kontaktu. Jeśli dana osoba później udostępni swój numer lub ponownie wyśle do Ciebie wiadomość z widocznym numerem, zostanie on uzupełniony automatycznie.

Z jakim połączeniem to działa #

Działa to tylko w przypadku oficjalnego połączenia WhatsApp API. Meta dostarcza ustrukturyzowane informacje o poleceniu (w tym ctwa_clid) wyłącznie przez oficjalne API WhatsApp Business. Nieoficjalne połączenie WhatsApp (web) ich nie otrzymuje — ze względu na sposób działania tego połączenia, dane o kliknięciach reklam nie są w nim dostępne.

Jeśli więc zależy Ci na atrybucji reklam w zamkniętej pętli, prowadź kampanie Click-to-WhatsApp przy użyciu numeru połączonego przez oficjalne API WhatsApp.

Reklamy typu Click-to-Instagram i Click-to-Messenger #

Reklamy otwierające czat na Instagramie lub Messengerze są rejestrowane w ten sam sposób na stronie na Facebooku i koncie na Instagramie połączonym za pomocą karty Instagram & Messenger. Gdy ktoś rozpocznie czat z takiej reklamy, kontakt otrzymuje ad_referral z wartością channel ustawioną na instagram lub messenger, source_type ustawioną na ad oraz source_id ustawioną na identyfikator reklamy. Dzięki temu wiesz, która reklama stoi za każdym kontaktem, co pozwala obliczyć koszt rezerwacji w przeliczeniu na reklamę.

Kilka różnic w porównaniu z WhatsApp:

• Brak ctwa_clid; to pole jest puste. Meta generuje ten identyfikator kliknięcia tylko dla WhatsApp.
• headline to tytuł reklamy w momencie wysłania jej przez Meta, a source_url to link do obrazu lub wideo reklamy, jeśli taki istnieje. body jest puste.
• Jeśli kontakt pochodzi najpierw z jednej reklamy, a później rozpoczyna czat z innej reklamy, ad_referral pokazuje nowszą reklamę.
• Kontakty z reklam w Messengerze zawierają informacje o reklamie od 14 października 2026 r. Kontakty, które pochodziły z reklamy w Messengerze przed tą datą, nie mają ad_referral, ponieważ szczegóły reklamy nie były wtedy rejestrowane i nie można ich uzupełnić później.
• Czaty w Messengerze, które rozpoczynają się od kliknięcia przycisku Rozpocznij na stronie, nie są rejestrowane. Usuń przycisk Rozpocznij ze swojej strony (Meta Business Suite, ustawienia skrzynki odbiorczej), aby użytkownicy rozpoczynali czat poprzez pisanie, dzięki czemu reklama zostanie zarejestrowana przy ich pierwszej wiadomości.

Zachowanie przy pierwszym kontakcie #

Polecenie jest rejestrowane przy pierwszej wiadomości, którą kontakt wysyła z reklamy. Jeśli ten sam kontakt później kliknie inną reklamę, a to nowsze kliknięcie zawiera identyfikator, zapisany ad_referral jest odświeżany, aby identyfikator kliknięcia był aktualny do celów raportowania. Polecenia z postów organicznych (które nie mają ctwa_clid) nigdy nie nadpisują wcześniej zarejestrowanego identyfikatora kliknięcia płatnej reklamy.

Przesyłanie danych do Meta lub Google Ads #

Your AI Connector przechwytuje dane atrybucji i je udostępnia. W przypadku reklam, które najpierw kierują użytkowników do Twojej własnej witryny, Your AI Connector może przesyłać wyniki do Meta w Twoim imieniu po zastosowaniu tagu: zobacz Wysyłanie wyników do Meta. W przypadku reklam typu Click-to-WhatsApp przesyłasz dane za pomocą webhooków oraz narzędzia do automatyzacji.

Obiekt ad_referral jest zawarty w sekcji contact wychodzących zdarzeń webhook (na przykład Nowa wiadomość, Wznowienie kontaktu, Aktualizacja tagów kontaktu oraz zdarzenia analityczne, takie jak Zarezerwowano wizytę).

Typowa konfiguracja w pętli zamkniętej:

1. Lead klika Twoją reklamę „Kliknij, aby przejść do WhatsApp” i wysyła do Ciebie wiadomość. Your AI Connector zapisuje ad_referral (w tym ctwa_clid) w danych kontaktu.
2. W miarę postępów leada — umówienie rozmowy, zostanie klientem, utrata — oznaczasz ten wynik (zobacz „Przenoszenie etapu lejka” poniżej).
3. Webhook uruchamia Twoje narzędzie do automatyzacji (Zapier, Make lub Pabbly), przekazując zarówno wynik, jak i ctwa_clid kontaktu.
4. Twoje narzędzie do automatyzacji wywołuje Conversions API od Meta (używając action_source = business_messaging oraz ctwa_clid) lub Google Ads (Import konwersji offline / Rozszerzone konwersje dla leadów), aby zaraportować konwersję.

W ten sposób Meta i Google dowiadują się, które reklamy przyniosły rzeczywiste wyniki i optymalizują działania pod tym kątem.

Przenoszenie etapu lejka #

Aby zgłosić konwersję, zazwyczaj potrzebujesz dwóch rzeczy: identyfikatora kliknięcia (przechwytywanego automatycznie) oraz wyniku (który ustawiasz samodzielnie). Najbardziej niezawodnym sposobem na przypisanie wyniku jest użycie tagów, ponieważ zastosowanie tagu wyzwala webhook contact_tags_updated — a ten ładunek zawiera ad_referral kontaktu. (Usunięcie tagu nie wyzwala go; zobacz Zaktualizowano tagi kontaktu.)

Tagi możesz nakładać automatycznie:

• Pozwól swojemu agentowi AI oznaczyć kontakt tagiem podczas rozmowy — skonfiguruj reguły automatycznego tagowania w ustawieniach agenta. W ten sposób działa schemat „jedna strona docelowa na reklamę → jedna wiadomość wejściowa → jeden tag”, jeśli chcesz samodzielnie oznaczać źródło.
• Możesz też tagować ręcznie z poziomu czatów lub strony kontaktów.

Za każdym razem, gdy odpowiedni tag ulegnie zmianie, webhook wysyła dane wraz z dołączonym identyfikatorem kliknięcia, gotowe do przekazania jako konwersja.

Adres URL elementu webhook jest ustawiany bezpośrednio w samym tagu, na karcie Tagi w edytorze agenta AI, do którego przypisany jest kontakt, a nie w Ustawieniach. Każdy tag otrzymuje własny adres URL i wszystkie mogą wskazywać na ten sam punkt końcowy, jeśli chcesz, aby jedno miejsce odbierało wszystkie dane.

Odczytywanie identyfikatora kliknięcia (click id), który już przegapiłeś #

ad_referral jest również zwracane przez API zarówno w GET /v1/contacts/{id} (jako adReferral), jak i w punkcie końcowym listy kontaktów (jako ad_referral), więc jeśli Twój odbiornik nie działał lub dokonujesz uzgodnień po fakcie, możesz odczytać identyfikator kliknięcia zamiast czekać na kolejny webhook. Kontakty, które dotarły przed zarejestrowaniem na nich identyfikatora kliknięcia, mają tutaj null — wartość tę można przechwycić tylko z przychodzącej wiadomości, więc nie ma czego uzupełniać wstecznie.

Ograniczenia #

• Tylko oficjalne połączenie z WhatsApp API (nie nieoficjalne połączenie internetowe).
• Wbudowana funkcja Wysyłanie wyników do Meta przesyła dane o kliknięciach zarejestrowane przez skrypt witryny; nie wysyła ona ctwa_clid reklam typu Click-to-WhatsApp. W ich przypadku, a także w przypadku Google Ads, przesyłasz dane za pośrednictwem Zapier/Make/Pabbly. Jeśli chcesz skorzystać z natywnej integracji, daj znać zespołowi wsparcia pod adresem hi@youraiconnector.com.
• Atrybucja jest przechwytywana na bieżąco, od momentu uruchomienia tej funkcji. Nie można jej uzupełnić wstecz dla konwersacji, które miały miejsce wcześniej.

Następne kroki #

• Webhooki — zobacz pełny ładunek (payload) i sprawdź, które zdarzenia zawierają ad_referral.
• Używanie tagów do oznaczania kontaktów — skonfiguruj tagi, które przenoszą etapy Twojego lejka sprzedażowego.
• Atrybucja kliknięć reklam dla WhatsApp: dopasuj kliknięcia reklam prowadzących do Twojej własnej witryny do konwersacji w WhatsApp.