# 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](../get-started/creating-contacts.md) 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](webhooks.md) (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](webhooks.md#contact-tags-updated-webhook).) 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 - [Webhooki](webhooks.md) — zobacz pełny ładunek i dowiedz się, które zdarzenia zawierają `ad_referral`. - [Używanie tagów do oznaczania kontaktów](../get-started/creating-tags.md) — skonfiguruj tagi, które przenoszą etapy Twojego lejka.