Your AI Connector Docs

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

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ą:

Pole Co to jest
ctwa_clid Identyfikator kliknięcia Meta. Jest to wartość, którą przesyłasz do Conversions API firmy Meta, aby przypisać konwersję do konkretnego kliknięcia reklamy. Puste dla poleceń z postów organicznych (patrz poniżej).
source_id Identyfikator reklamy (lub posta), w który kliknęła osoba.
source_type Albo ad (płatna reklama Click-to-WhatsApp), albo post (organiczny post na Facebooku/Instagramie).
source_url Link powiązany z treścią reklamy.
headline Nagłówek reklamy.
body Treść reklamy.
channel Kanał, z którego pochodzi polecenie (obecnie zawsze whatsapp).
captured_at Kiedy polecenie zostało po raz pierwszy zarejestrowane w kontakcie.

Możesz to zobaczyć w panelu szybkiego podglądu kontaktu, jeśli skonfigurowałeś dla niego pole niestandardowe, lub odczytać bezpośrednio przez webhooki i API (patrz poniżej) — nie jest to wydzielone jako osobne pole z etykietą w tabeli Kontaktów.

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.

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.

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 udostępnia je, ale obecnie nie przesyła automatycznie konwersji do Meta ani Google w Twoim imieniu. Dane te przesyłasz 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 webhooka ustawia się na samym tagu, w zakładce Tagi agenta (lub kampanii), do którego należy kontakt — nie w Ustawieniach. Każdy tag otrzymuje własny adres URL i wszystkie mogą wskazywać na ten sam punkt końcowy, jeśli chcesz otrzymywać wszystko w jednym miejscu.

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 przez przeglądarkę).
  • Brak jeszcze natywnej integracji Meta CAPI lub Google Ads za pomocą jednego kliknięcia — dane przesyła się przez Zapier/Make/Pabbly. Jeśli chcesz natywnej integracji, daj znać wsparciu pod adresem hi@youraiconnector.com.
  • Atrybucja jest rejestrowana od momentu uruchomienia funkcji. Nie można jej uzupełnić wstecz dla konwersacji, które miały miejsce wcześniej.

Następne kroki