Atrybucja kliknięć reklam dla WhatsApp #

Jeśli kierujesz reklamy Meta lub Google na stronę w swojej witrynie, a ta strona zawiera przycisk WhatsApp, Your AI Connector może poinformować Cię, z którego kliknięcia w reklamę pochodzi dana konwersacja w WhatsApp. Wystarczy wkleić na swojej stronie jeden krótki skrypt. Gdy odwiedzający kliknie przycisk WhatsApp, kliknięcie zostanie zapamiętane i przypisane do pierwszej wiadomości, którą do Ciebie wyśle. Następnie przy kontakcie wyświetli się kampania, z której pochodzi, a dane o kliknięciu powędrują wraz z kontaktem do webhooków, API oraz, jeśli chcesz, z powrotem do Meta.

Działa to na każdej stronie z przyciskiem WhatsApp: stronie docelowej (landing page), stronie rezerwacji, stronie z cennikiem lub quizie, który kończy się przyciskiem „Wyślij moje odpowiedzi przez WhatsApp”.

Ta strona dotyczy reklam, które najpierw kierują użytkowników na Twoją witrynę. Jeśli Twoje reklamy otwierają WhatsApp bezpośrednio (reklamy Meta „Click to WhatsApp”), jest to obsługiwane automatycznie, bez użycia skryptu, w sekcji Atrybucja reklam Click-to-WhatsApp.

Konfiguracja #

1. Przejdź do Ustawienia → Śledzenie kliknięć reklam (grupa Integracje).
2. Kliknij Włącz i pobierz mój skrypt. Twoje konto otrzyma własny klucz witryny oraz jednowierszowy skrypt.
3. Skopiuj skrypt i wklej go tuż przed tagiem zamykającym </body> na każdej stronie, która zawiera przycisk WhatsApp:

<script src="https://api.youraiconnector.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>

4. Opcjonalnie: w polu Numer WhatsApp wpisz numer, do którego prowadzą Twoje przyciski. Wtedy śledzone będą tylko linki do tego numeru. Pozostaw to pole puste, aby śledzić każdy link WhatsApp w witrynie.
5. Wybierz brzmienie numeru zapytania (patrz poniżej) i kliknij Zapisz. Po zmianie ustawień nie musisz zmieniać skryptu na swojej stronie.
6. Przetestuj to: otwórz swoją stronę z linku zawierającego tag kampanii, na przykład https://yoursite.com/?utm_source=test&utm_campaign=setup-check, kliknij własny przycisk WhatsApp i wyślij wiadomość. Otwórz ten kontakt w czatach: panel kontaktu pokaże Pochodzi z kliknięcia w reklamę wraz z nazwą kampanii.

Klucz witryny znajduje się już wewnątrz skryptu. Nie jest to hasło, więc bezpiecznie można go używać na publicznej stronie.

Co robi skrypt #

• Podczas ładowania strony, zapisuje identyfikatory kliknięć reklam i tagi kampanii (parametry utm_) z adresu strony w pamięci sesji karty przeglądarki, dzięki czemu pozostają one dostępne, jeśli odwiedzający najpierw przejrzy inną stronę. Nie ustawia żadnych plików cookie, niczego innego nie ładuje i niczego nie wysyła.
• Gdy odwiedzający kliknie link WhatsApp (wa.me, api.whatsapp.com/send lub whatsapp://send), dodaje numer zapytania do wiadomości, rejestruje wizytę i pozwala na kontynuowanie kliknięcia do WhatsApp w normalny sposób.

Przed kliknięciem nic nie jest wysyłane do Your AI Connector.

Numer zapytania #

Krótki numer, podobny do numeru referencyjnego nadawanego przez sklep lub przychodnię, jest dodawany do wiadomości WhatsApp odwiedzającego. Dzięki niemu Your AI Connector wie dokładnie, które kliknięcie w reklamę należy do której konwersacji. Wiadomość wygląda tak:

Hi, I would like to know more.
Enquiry no. 4827

• Brzmienie: Domyślnie jest to „Enquiry no.”. Możesz użyć dowolnego tekstu jednowierszowego, który brzmi naturalnie dla Twojej firmy, na przykład „Booking ref” lub „Ref”. Bez cyfr.
• Miejsce: W osobnej ostatniej linii (domyślnie) lub Na końcu tekstu. Strona ustawień pokazuje podgląd na żywo.
• Długość: 4 cyfry lub 5, gdy Twoja witryna jest bardzo obciążona ruchem.
• Twój agent AI nigdy go nie widzi i nigdy go nie powtarza. Skrzynka odbiorcza pokazuje pełną wiadomość, włącznie z numerem.

Możesz wyłączyć numer zapytania. Dopasowywanie będzie wtedy działać tylko na podstawie treści wiadomości, więc dwóch odwiedzających, którzy wyślą dokładnie ten sam tekst (na przykład te same odpowiedzi w quizie), nie będzie mogło zostać rozróżnionych, a niektóre kliknięcia nie zostaną dopasowane.

Twój własny kod quizu lub przycisku #

Jeśli Twoja strona sama tworzy wiadomość WhatsApp (quiz, który umieszcza odpowiedzi w tekście, lub Twój własny kod przycisku), dodaj data-manual do tagu skryptu:

<script src="https://api.youraiconnector.com/v1/ad-visit/YOUR_SITE_KEY.js" data-manual async></script>

Dzięki data-manual skrypt nie zmienia już samodzielnie linków WhatsApp. Twój własny kod wywołuje go tuż przed otwarciem WhatsApp, więc każda wizyta jest rejestrowana tylko raz:

• window.ChatAttribution.text(finalText, number) zwraca Twój tekst z dodanym numerem zapytania i rejestruje wizytę. Użyj zwróconego tekstu w swoim linku WhatsApp.
• window.ChatAttribution.link(finalText, number) robi to samo i zwraca gotowy link wa.me z tym tekstem. Pomiń numer, aby użyć tego znajdującego się w ustawieniach w sekcji Numer WhatsApp.

<script>
  function sendAnswers(answers) {
    var text = "Hi, my answers: " + answers.join(", ");
    if (window.ChatAttribution) {
      window.location.href = window.ChatAttribution.link(text, "+15551234567");
    } else {
      window.location.href = "https://wa.me/15551234567?text=" + encodeURIComponent(text);
    }
  }
</script>

Gałąź else sprawia, że przycisk działa, nawet jeśli skrypt się nie załadował, na przykład gdy blokuje go rozszerzenie przeglądarki. Tekst, który już zawiera numer nadany przez skrypt, nigdy nie jest zmieniany po raz drugi.

Co jest rejestrowane #

W momencie kliknięcia rekord wizyty zawiera:

• identyfikatory kliknięć reklam w adresie strony, takie jak fbclid (Meta) i gclid (Google)
• pliki cookie _fbc i _fbp, jeśli Twój własny piksel Meta ustawił je w Twojej witrynie (skrypt je odczytuje, nigdy ich nie ustawia)
• tagi kampanii (utm_source, utm_medium, utm_campaign, utm_content, utm_term)
• stronę docelową, stronę, z której przyszedł odwiedzający, przeglądarkę oraz treść wiadomości
• adres IP i czas, dodane przez Your AI Connector w momencie dotarcia wizyty

Gdy wizyta zostanie dopasowana, Your AI Connector na podstawie tych danych określa również w przybliżeniu, gdzie znajdował się odwiedzający (miasto i kraj, w przybliżeniu, na podstawie adresu IP) oraz z jakiego urządzenia korzystał (telefon, tablet lub komputer, system operacyjny i przeglądarka, na przykład wbudowana przeglądarka w aplikacji Instagram). Lokalizacja pozostaje pusta, gdy nie można jej ustalić, co jest częstym zjawiskiem w sieciach komórkowych.

Rekordy wizyt są przechowywane przez 90 dni. Gdy wizyta zostanie dopasowana, kopia danych o kliknięciu jest zapisywana w kontakcie i pozostaje przy nim, dopóki jej nie usuniesz.

Twoja informacja o prywatności: skrypt działa na Twojej stronie internetowej, więc informacja o prywatności Twojej witryny powinna o nim wspominać: co rejestruje (lista powyżej) oraz że robi to, gdy odwiedzający kliknie przycisk WhatsApp.

Jak działa dopasowywanie #

Gdy dotrze pierwsza wiadomość od kontaktu, Your AI Connector szuka wizyty z ostatnich 15 minut:

1. Najpierw według numeru zapytania. Wiadomość zawierająca numer nadany przez skrypt jest dopasowywana do tej wizyty.
2. W przeciwnym razie według identycznego tekstu. Wiadomość o dokładnie takiej samej treści jak wizyta jest do niej dopasowywana. Jeśli dwóch różnych odwiedzających wysłało ten sam tekst w tym samym oknie czasowym, żaden z nich nie zostanie dopasowany – jest to celowe działanie, aby kontakt nigdy nie został błędnie przypisany do niewłaściwej reklamy.

Późniejsza wiadomość, która zawiera numer zapytania, również zostanie dopasowana, o ile kontakt nie ma jeszcze przypisanego dopasowania.

Gdy kontakt, który ma już przypisane dopasowanie, powraca przez inną reklamę i wysyła wiadomość z nowszym numerem zapytania, to kliknięcie jest zachowywane jako najnowsze kliknięcie kontaktu. Pierwsze dopasowanie pozostaje bez zmian.

• Pierwsze kliknięcie, do celów raportowania: kontakt nadal wskazuje, skąd pierwotnie pochodził lead. To nigdy się nie zmienia.
• Najnowsze kliknięcie, dla Meta: zdarzenia wysyłane do Meta wykorzystują najnowsze kliknięcie, ponieważ Meta przypisuje zasługę reklamie, która sprowadziła osobę z powrotem, i to tylko w ramach swojego okna atrybucji. Raportowanie starego kliknięcia przypisałoby zasługę niewłaściwej reklamie lub żadnej.
• Najnowsze kliknięcie jest pobierane wyłącznie z numeru zapytania, nigdy tylko na podstawie dopasowania tekstu, a starsza wizyta nigdy nie zastępuje nowszej.

Limity:

• Pierwsze dopasowanie nigdy nie jest nadpisywane. Nowsze kliknięcia trafiają do pola najnowszego kliknięcia.
• Tylko WhatsApp: kanały WhatsApp Business API oraz WhatsApp Web.
• 15 minut: odwiedzający, który kliknie przycisk, ale wyśle wiadomość znacznie później, nie zostanie dopasowany.
• Tylko od teraz: kontakty sprzed zainstalowania skryptu nie mają przypisanego dopasowania.

Gdzie to zobaczysz #

• Panel kontaktu: Pochodzi z kliknięcia w reklamę wraz z kampanią lub źródłem oraz datą pierwszego kliknięcia. Najedź kursorem, aby zobaczyć szczegóły: kampanię, Reklamę (utm_content) i Zestaw reklam (utm_term), przybliżoną Lokalizację i Urządzenie (każde tylko wtedy, gdy jest znane), a także to samo dla ostatniego kliknięcia, jeśli takie istnieje. Tagi kampanii, które nigdy nie zostały wypełnione (kliknięcie w podgląd reklamy wysyła szablon tagu zamiast nazw), są pomijane. Wizyta jest liczona jako kliknięcie w reklamę tylko wtedy, gdy strona została otwarta z linku reklamowego (identyfikator kliknięcia Meta lub Google albo tagi kampanii). Każdy, kto dotarł na stronę w inny sposób, na przykład z wyszukiwarki Google, wpisując adres lub klikając w witrynie, będzie miał oznaczenie Pochodzi z Twojej witryny wraz z informacją, skąd przyszedł, np. Wyszukiwarka Google lub Wizyta w witrynie, brak zarejestrowanego źródła odsyłającego, gdy przeglądarka nie przekazała takiej informacji.
• Strona kontaktu: ten sam wiersz znajduje się pod nazwą kontaktu w sekcji Kontakty, dzięki czemu widzisz go od razu, również na telefonie. Najedź kursorem lub dotknij go, aby uzyskać szczegóły.
• Aktywność: oś czasu kontaktu zaczyna się od Dotknięto przycisku WhatsApp po kliknięciu w reklamę (lub w Twojej witrynie) w momencie kliknięcia, przed wysłaniem pierwszej wiadomości. Panel kontaktu na czacie pokazuje ten sam wiersz w sekcji Aktywność.
• Webhooki: contact.ad_attribution w webhookach tagów agenta oraz w każdym zdarzeniu subskrypcji webhooka, które zawiera kontakt.
• API: ad_attribution na liście kontaktów oraz adAttribution dla pojedynczego kontaktu, w sekcji Kontakty dokumentacji API.
• Narzędzia MCP: ten sam obiekt przy każdym zwracanym kontakcie.

Wartość wynosi null, gdy kontakt nie ma dopasowania. Poniższe pola opisują pierwsze kliknięcie. Gdy dopasowano późniejsze kliknięcie, latest przechowuje je z tymi samymi polami; do tego momentu pole jest nieobecne.

Wysyłaj wyniki do Meta (opcjonalnie) #

Możesz pozwolić Your AI Connector na raportowanie wyników do Twojego konta reklamowego Meta, aby Meta uczyła się, które reklamy przynoszą realne leady i sprzedaż, oraz optymalizowała pod tym kątem. Wykorzystuje to Twoje własne dane Meta Conversions API.

1. W Menedżerze zdarzeń Meta znajdź identyfikator swojego piksela (zwanego również zbiorem danych) w sekcji Źródła danych, a następnie utwórz token dostępu w sekcji Ustawienia, Conversions API, Wygeneruj token dostępu.
2. W sekcji Ustawienia → Śledzenie kliknięć reklam, w obszarze Wyślij wyniki do Meta (opcjonalnie), wprowadź Identyfikator piksela / zbioru danych oraz Token dostępu. Kliknij Zapisz szczegóły Meta.
3. Opcjonalnie: sprawdź połączenie. W Menedżerze zdarzeń Meta otwórz swój piksel i przejdź do karty Testowanie zdarzeń, skopiuj wyświetlony tam kod testowy, wklej go w polu Wyślij zdarzenie testowe i kliknij Wyślij zdarzenie testowe. Wiersz pod przyciskiem wyświetli komunikat „Meta otrzymała 1 zdarzenie testowe” (sprawdź to w sekcji Testowanie zdarzeń w Meta) lub pokaże przyczynę odrzucenia przez Meta, na przykład błędny token. Kod jest używany tylko do tego jednego testu i nigdy nie jest zapisywany.
4. Otwórz edytor agenta, przejdź do karty Tagi i otwórz tag. W sekcji Wyślij do Meta wybierz zdarzenie: Lead, Kontakt, Termin, Zakup lub własną nazwę. Opcjonalnie dodaj wartość i walutę.

Od tego momentu, za każdym razem, gdy dany tag zostanie przypisany do kontaktu (przez AI, ręcznie, przez API lub automatyzację), Your AI Connector wysyła zdarzenie do Meta z danymi najnowszego kliknięcia kontaktu (fbc, fbp, adres IP, przeglądarka, strona docelowa, z najnowszego kliknięcia, jeśli istnieje, w przeciwnym razie z pierwszego) oraz zahaszowanym numerem telefonu, adresem e-mail i imieniem, aby Meta mogła powiązać je z reklamą. Kontakt bez dopasowania nadal wysyła zdarzenie, tylko z zahaszowanym telefonem, e-mailem i imieniem.

• Zdarzenia na żywo są zawsze liczone: kod zdarzenia testowego nigdy nie jest przechowywany wraz z Twoimi danymi Meta, więc zdarzenia wysyłane przez Twoje tagi i automatyzacje zawsze trafiają do Twoich rzeczywistych danych w Meta, a nigdy do karty Testowanie zdarzeń.
• Brak podwójnego zliczania: każde zdarzenie ma stały identyfikator utworzony z identyfikatora kontaktu i nazwy tagu. Jeśli Twój system CRM wyśle do Meta to samo zdarzenie z tym samym identyfikatorem, Meta zachowa tylko jedno z nich.
• Okno atrybucji Meta: Meta przypisuje zdarzenie do reklamy tylko w ramach swojego okna atrybucji, które domyślnie wynosi 7 dni od kliknięcia. Transakcja, która zostanie sfinalizowana kilka tygodni później, nie zostanie uwzględniona samodzielnie, dlatego należy wysłać również wcześniejsze zdarzenie, na przykład tag dla zarezerwowanej lub opłaconej konsultacji.

Wysyłanie konwersji z automatyzacji #

Tag wysyła swoje zdarzenie w momencie jego przypisania. Gdy wynik ma miejsce gdzie indziej, na przykład przy zamknięciu transakcji w CRM lub umówieniu konsultacji, użyj akcji Wyślij konwersję do Meta w automatyzacji. Raportuje ona jedno zdarzenie do Twojego zbioru danych Meta za pośrednictwem Conversions API, dzięki czemu Meta optymalizuje Twoje reklamy pod kątem rzeczywistych wyników, a nie tylko wiadomości.

Wykorzystuje te same dane Meta, co tagi: Identyfikator piksela / zbioru danych oraz Token dostępu w sekcji Ustawienia → Śledzenie kliknięć reklam. Bez nich krok zakończy się niepowodzeniem z komunikatem „Meta nie jest połączona”.

Pola

Wypełnij przynajmniej jedno z pól: Kontakt, E-mail lub Telefon. Osoba nie musi być kontaktem: transakcja w HubSpot, która osiągnęła status „Zamknięta wygrana”, może wysłać zdarzenie Purchase z kwotą transakcji i adresem e-mail kupującego.

Gdy wybierzesz Kontakt, użyte zostaną jego numer telefonu, adres e-mail i imię. Jeśli osoba pochodzi z kliknięcia w reklamę, które zostało dopasowane przez skrypt, szczegóły kliknięcia również zostaną przesłane, co pomaga Meta dopasować zdarzenie do reklamy. Adres e-mail, numer telefonu i imiona są haszowane przed wysłaniem. Identyfikator kliknięcia, adres IP i przeglądarka są wysyłane zgodnie z wymaganiami Meta.

Identyfikator zdarzenia (Event ID) a podwójne zliczanie

Meta zlicza zdarzenia o tej samej nazwie i tym samym identyfikatorze zdarzenia tylko raz. Użyj stałego identyfikatora, np. identyfikatora transakcji, gdy inne narzędzie również raportuje tę samą konwersję lub gdy automatyzacja może zostać dla niej uruchomiona dwukrotnie. Pozostaw to pole puste, a przy każdym uruchomieniu zostanie wygenerowany nowy identyfikator, dzięki czemu każde uruchomienie będzie zliczane.

Czym różni się to od zdarzeń tagów

Zdarzenie Wyślij do Meta w tagu jest wysyłane raz na kontakt dla danego tagu (maksymalnie raz na 30 dni). Ta akcja wysyła dane przy każdym uruchomieniu. Identyfikator zdarzenia (Event ID) zapobiega dwukrotnemu zliczeniu konwersji.

Przykład: zamknięta transakcja i umówiona konsultacja

1. Uruchom automatyzację, która działa po wygraniu transakcji: wyzwalacz Zdarzenie aplikacji (App event) dla zdarzenia transakcji w Twoim CRM, z Warunkiem (Condition), aby przepuszczać tylko wygrane transakcje. HubSpot wysyła zdarzenia etapu transakcji tylko do aplikacji deweloperskich, więc w przypadku HubSpot użyj wyzwalacza Harmonogram (Schedule) z wyszukiwaniem w HubSpot transakcji, które osiągnęły status „Zamknięta wygrana” od ostatniego uruchomienia, oraz Pętli (Loop) dla nich.
2. Dodaj Wyślij konwersję do Meta (Send conversion to Meta). Ustaw Nazwę zdarzenia (Event name) na Zakup (Purchase), Wartość (Value) na kwotę transakcji (wstaw ją za pomocą przycisku +) oraz Walutę (Currency) na swoją walutę. Wpisz adres e-mail kupującego w polu E-mail, a identyfikator transakcji w polu Identyfikator zdarzenia (Event ID), aby ta sama transakcja nigdy nie została policzona dwukrotnie.
3. W przypadku umówionej konsultacji uruchom drugą automatyzację z wyzwalaczem Umówione spotkanie (Appointment booked) i dodaj Wyślij konwersję do Meta z Nazwą zdarzenia ustawioną na Harmonogram (Schedule) oraz kontaktem z wyzwalacza w polu Kontakt (Contact). Jeśli chcesz, dodaj drugi krok Wyślij konwersję do Meta, który wyśle Zakup ze stałą wartością, taką jak cena konsultacji.

Możesz również wysłać konwersję przez API za pomocą POST https://api.youraiconnector.com/v1/ad-attribution/meta-event. Przyjmuje ona te same pola w formacie snake case: event_name, value, currency, contact_id, email, phone, first_name, last_name, external_id, event_id, event_time, event_source_url oraz test_event_code.

FAQ #

Czy to działa, jeśli moja reklama otwiera WhatsApp bezpośrednio? Takie reklamy nie przechodzą przez Twoją stronę internetową, więc skrypt nigdy się nie uruchamia. Meta wysyła szczegóły reklamy wraz z pierwszą wiadomością, zobacz Atrybucja reklam typu Click-to-WhatsApp.

Czy skrypt spowalnia moją stronę lub ustawia pliki cookie? Ładuje się w tle (async), nie ustawia żadnych plików cookie i nie ładuje niczego innego. Wysyła dane tylko wtedy, gdy odwiedzający kliknie przycisk WhatsApp.

Czy mogę śledzić Google Ads tak samo jak reklamy Meta? Tak. Identyfikatory kliknięć Google (gclid, gbraid, wbraid) oraz wszelkie tagi kampanii są rejestrowane i wyświetlane przy kontakcie. Odsyłanie wyników jest dostępne tylko dla Meta.

Dlaczego kontakt nie został dopasowany? Najczęstsze powody: wiadomość dotarła ponad 15 minut po kliknięciu, numer zapytania został usunięty z wiadomości, numer zapytania jest wyłączony i inny odwiedzający wysłał ten sam tekst lub na stronie nie ma skryptu.

Moja strona linkuje do dwóch numerów WhatsApp. Czy mogę śledzić tylko jeden? Tak. Wpisz ten numer w ustawieniach w polu Numer WhatsApp. Pozostaw puste, aby śledzić każdy link WhatsApp.

Czy mogę później zmienić treść? Tak. Zmiany zostaną wprowadzone na Twojej stronie internetowej natychmiast; nie musisz ponownie wklejać skryptu.