# Atrybucja kliknięć reklam dla WhatsApp

Jeśli kierujesz reklamy Meta lub Google na stronę w swojej witrynie, a ta strona zawiera przycisk WhatsApp, <span data-t="appName">Your AI Connector</span> 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](click-to-whatsapp-attribution.md).

---

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

{% code overflow="wrap" %}
```html
<script src="https://api.youraiconnector.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>
```
{% endcode %}

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 <span data-t="appName">Your AI Connector</span>.

---

## 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 <span data-t="appName">Your AI Connector</span> 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:

{% code overflow="wrap" %}
```html
<script src="https://api.youraiconnector.com/v1/ad-visit/YOUR_SITE_KEY.js" data-manual async></script>
```
{% endcode %}

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

{% code overflow="wrap" %}
```html
<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>
```
{% endcode %}

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 <span data-t="appName">Your AI Connector</span> w momencie dotarcia wizyty

Gdy wizyta zostanie dopasowana, <span data-t="appName">Your AI Connector</span> 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, <span data-t="appName">Your AI Connector</span> 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](webhooks.md#contact-tags-updated-webhook) 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.

| Pole | Co to jest |
|---|---|
| `visit_at` | Kiedy odwiedzający dotknął przycisku WhatsApp. |
| `matched_at` | Kiedy wizyta została dopasowana do kontaktu. |
| `match_method` | `reference` (dopasowano według numeru zapytania) lub `text` (dopasowano według identycznej treści wiadomości). |
| `reference` | Numer zapytania lub `null`, gdy było wyłączone. |
| `fbc` / `fbp` | Kliknięcie Meta i pliki cookie przeglądarki z Twojego własnego piksela Meta, jeśli są obecne. |
| `fbclid` | Identyfikator kliknięcia reklamy Meta z adresu strony. |
| `gclid` / `gbraid` / `wbraid` | Identyfikatory kliknięć reklam Google z adresu strony. |
| `utm_source` / `utm_medium` / `utm_campaign` / `utm_content` / `utm_term` | Tagi kampanii z adresu strony. |
| `landing_url` | Strona, na którą trafił odwiedzający. |
| `referrer` | Strona, z której przyszedł odwiedzający. |
| `client_ip` | Adres IP odwiedzającego. |
| `user_agent` | Przeglądarka odwiedzającego. |
| `geo_country` / `geo_region` / `geo_city` / `geo_timezone` | Przybliżona lokalizacja na podstawie adresu IP: dwuliterowy kod kraju, kod regionu, miasto i strefa czasowa. Brak, gdy nieznane. |
| `device_type` / `device_os` / `device_browser` | Urządzenie z przeglądarki: `mobile`, `tablet` lub `desktop`, system operacyjny z wersją (taki jak `iOS 18.3`) oraz przeglądarka (taka jak `Safari` lub `Instagram in-app`). Brak, gdy nieznane. |
| `site_key` | Klucz witryny skryptu, który zarejestrował wizytę. |
| `visit_id` | Identyfikator rekordu wizyty. |
| `latest` | Najnowsze kliknięcie dopasowane po pierwszym, z tymi samymi polami. Używane dla zdarzeń wysyłanych do Meta. Brak, gdy nie istnieje. |

---

## Wysyłaj wyniki do Meta (opcjonalnie)

Możesz pozwolić <span data-t="appName">Your AI Connector</span> 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ę), <span data-t="appName">Your AI Connector</span> 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**

| Pole | Opis działania |
|---|---|
| **Nazwa zdarzenia** | Wymagane. **Zakup**, **Termin**, **Lead** lub własna nazwa. Własna nazwa może zawierać litery, cyfry, spacje i podkreślenia, musi zaczynać się od litery i mieć maksymalnie 40 znaków. |
| **Wartość** i **Waluta** | Kwota konwersji, np. wartość transakcji. Waluta to 3-literowy kod, domyślnie EUR. Wartość jest wysyłana tylko wtedy, gdy zostanie podana. |
| **Kontakt** | Opcjonalne. Kontakt, którego dotyczy konwersja. |
| **E-mail**, **Telefon**, **Imię**, **Nazwisko** | Dane osoby. Wypełnij je, gdy osoba nie jest kontaktem lub aby uzupełnić dane kontaktu. |
| **Twój własny identyfikator osoby** | Identyfikator osoby z Twojego własnego systemu, np. identyfikator CRM. |
| **Identyfikator zdarzenia** | Identyfikator używany przez Meta do jednorazowego zliczenia zdarzenia. Zobacz poniżej. |
| **Czas zdarzenia** | Moment wystąpienia konwersji w formacie sekund unixowych lub daty. Maksymalnie 7 dni wstecz. Pozostaw puste, aby użyć momentu uruchomienia kroku. |
| **URL strony** | Strona, z którą powiązana jest konwersja, jeśli dotyczy. |
| **Kod zdarzenia testowego** | Tylko do testów: kod z karty Testowanie zdarzeń w Meta. Zdarzenie wysłane z tym kodem pojawi się w sekcji Testowanie zdarzeń i nie będzie wliczane do Twoich reklam. Pozostaw puste dla zdarzeń na żywo. |

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](click-to-whatsapp-attribution.md).

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