Meta Conversions API (CAPI) dla formularzy leadowych: wysyłaj leady bez podwójnego liczenia
Jak wysyłać leady do Meta jednocześnie przez Pixel i Conversions API z jednym wspólnym ID zdarzenia, uzyskać token dostępu, zweryfikować wszystko w Zdarzeniach testowych i obsłużyć zgodę na przekazywanie zahashowanych danych kontaktowych.
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
- ID Pixela (zbioru danych) z Menedżera zdarzeń Meta → Źródła danych.
- Tokenu dostępu do Conversions API: Menedżer zdarzeń → Twój zbiór danych → Ustawienia → Conversions API → Wygeneruj token dostępu.
- 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_urluser_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
- wysyłane bez zmian:
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:
- Dodaj osobną, opcjonalną zgodę na „przekazywanie danych za granicę w celu pomiaru reklam”: odbiorca (Meta Platforms), kraj, zakres danych, cel, okres przechowywania.
- Dołączaj zahashowane dane kontaktowe tylko w przypadku osób, które wyraziły zgodę.
- Dla wszystkich pozostałych wysyłaj zdarzenie wyłącznie z IP, user agentem i ID kliknięć.
- Nigdy nie wysyłaj informacji o zdrowiu, takich jak objawy.
Zobacz treść zgód w formularzach leadowych w Korei albo wygeneruj ją w darmowym narzędziu do zgód.
Weryfikacja
- Dodaj kod zdarzenia testowego i wyślij jednego testowego leada.
- W Zdarzeniach testowych powinno pojawić się zdarzenie z przeglądarki i z serwera, a jedno z nich oznaczone jako zdeduplikowane.
- 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.