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

Poradniki · Śledzenie konwersji

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

  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 albo wygeneruj ją w darmowym narzędziu do zgód.

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.

Powiązane poradniki