# Meta Conversions API (CAPI) dla formularzy leadowych: wysyłaj leady bez podwójnego liczenia

> **Odpowiedź**: Meta Conversions API (CAPI) wysyła zdarzenia z Twojego serwera zamiast z przeglądarki odwiedzającego. Używaj go razem z Pixelem i nadaj **obu tę samą nazwę zdarzenia i to samo ID zdarzenia**; Meta zachowa wtedy jedno, a duplikat odrzuci. Leady, które Pixel pominie (blokery reklam, ograniczenia śledzenia w przeglądarkach, zamknięte karty), i tak zostaną zarejestrowane przez zdarzenie serwerowe.

## Dlaczego sam Pixel nie wystarcza

Pixel działa w przeglądarce odwiedzającego. Blokery reklam, ograniczenia śledzenia w iOS i zamykanie karty zaraz po wysłaniu formularza gubią zdarzenia. Meta raportuje wtedy za mało konwersji i optymalizuje Twoje reklamy na mniejszej ilości danych. Kopia po stronie serwera wypełnia tę lukę.

## Czego potrzebujesz

1. **ID Pixela (zbioru danych)** z Menedżera zdarzeń Meta → Źródła danych.
2. **Tokenu dostępu do Conversions API**: Menedżer zdarzeń → Twój zbiór danych → Ustawienia → Conversions API → Wygeneruj token dostępu.
3. **Kodu zdarzenia testowego** (opcjonalnie): widoczny na karcie Zdarzenia testowe, zaczyna się od `TEST`.

## Jak działa deduplikacja

| Wysyłane z | Nazwa zdarzenia | ID zdarzenia |
|---|---|---|
| Pixel w przeglądarce | `Lead` | `fbq('track', 'Lead', {}, {eventID: 'abc123'})` |
| Serwer (CAPI) | `Lead` | `"event_id": "abc123"` |

Gdy z obu źródeł przychodzi ta sama nazwa i to samo ID, Meta zachowuje jedno zdarzenie. Jeśli ID się różnią albo różni się nazwa (np. `Lead` i `SubmitApplication`), lead zostaje policzony dwa razy. Wygeneruj jedno ID w przeglądarce w chwili wysłania formularza i przekaż je do obu.

## Co umieścić w zdarzeniu serwerowym

- `event_name` (Lead), `event_time`, `event_id`, `action_source: "website"`, `event_source_url`
- `user_data`
  - wysyłane bez zmian: `client_ip_address`, `client_user_agent`, `fbc` (plik cookie z ID kliknięcia), `fbp` (plik cookie z ID przeglądarki)
  - zahashowane SHA-256: telefon (`ph`, cyfry z kodem kraju, np. 821012345678), e-mail (`em`, małymi literami), imię i nazwisko

Więcej identyfikatorów poprawia jakość dopasowania zdarzeń (Event Match Quality), ale najpierw załatw kwestię zgody.

## Zgoda: zahashowane dane to nadal dane osobowe

Zgodnie z koreańskim Personal Information Protection Act (i większością przepisów o prywatności) zahashowanie numeru telefonu nie czyni go anonimowym, a Meta jest odbiorcą zagranicznym. Bezpieczna konfiguracja:

1. Dodaj osobną, opcjonalną zgodę na „przekazywanie danych za granicę w celu pomiaru reklam”: odbiorca (Meta Platforms), kraj, zakres danych, cel, okres przechowywania.
2. Dołączaj zahashowane dane kontaktowe tylko w przypadku osób, które wyraziły zgodę.
3. Dla wszystkich pozostałych wysyłaj zdarzenie wyłącznie z IP, user agentem i ID kliknięć.
4. Nigdy nie wysyłaj informacji o zdrowiu, takich jak objawy.

Zobacz [treść zgód w formularzach leadowych w Korei](/en/guides/landing-consent-text) albo wygeneruj ją w [darmowym narzędziu do zgód](/en/tools/consent).

## Weryfikacja

1. Dodaj kod zdarzenia testowego i wyślij jednego testowego leada.
2. W Zdarzeniach testowych powinno pojawić się zdarzenie z przeglądarki i z serwera, a jedno z nich oznaczone jako zdeduplikowane.
3. Przed uruchomieniem usuń kod testowy.

## Odsyłaj wyniki

Gdy lead przechodzi w konsultację lub sprzedaż, wyślij niestandardowe zdarzenie serwerowe z tymi samymi zahashowanymi identyfikatorami (lub zewnętrznym ID). Meta może wtedy nauczyć się, kto idzie dalej niż samo wypełnienie formularza.

## W CutLanding

Wklej ID Pixela i token dostępu w Ustawienia → Połączenia. Po zapisaniu leada zdarzenia z Pixela i z serwera wychodzą z tym samym ID, zahashowane dane kontaktowe są dodawane tylko dla osób, które zgodziły się na pomiar reklam, dane o zdrowiu nigdy nie są wysyłane, a nieudane wysyłki są ponawiane przez 24 godziny.

## FAQ

### Czy mogę usunąć Pixel i używać tylko Conversions API?

Meta zaleca używanie obu z deduplikacją. Dane z przeglądarki (pliki cookie fbp i fbc) pomagają w dopasowaniu, a jeśli jedna strona zawiedzie, druga i tak zarejestruje leada.

### Moje leady są liczone podwójnie. Dlaczego?

Nazwy zdarzeń lub ID zdarzeń różnią się między Pixelem a serwerem. Używaj po obu stronach jednego ID na jedno wysłanie i tej samej nazwy zdarzenia.

### Co, jeśli mój token dostępu wycieknie?

Wygeneruj nowy token w Menedżerze zdarzeń i podmień go wszędzie, gdzie jest używany. Trzymaj token wyłącznie na serwerze, nigdy w kodzie HTML strony.


---
Source: https://cutlanding.com/pl/guides/meta-conversions-api
© CutLanding (컷랜딩). Quote freely with a link to the source.
