Spadek Event Match Quality w Conversions API — diagnostyka i kroki naprawcze
Reklamy i pozyskiwanie klientów · Kacper Bernecki
Ten dokument opisuje konkretną ścieżkę diagnostyczną, gdy w Menedżerze zdarzeń Meta obserwujesz obniżenie Event Match Quality (EMQ) po przełączeniu części ruchu na Conversions API (CAPI) lub po zmianach w implementacji. EMQ zależy od jakości i kompletności danych identyfikujących użytkownika (np. email, phone, client_ip_address, fbp, fbc) oraz od sposobu hashowania i przesyłania tych pól. Spadek jakości zwykle wynika z jednej lub z kombinacji: brakującego/niezgodnego pola identyfikacyjnego, błędnego hashowania (PHP/JS vs SHA256 raw bytes), niezgodności time_stamp (różnice >24h), duplikacji zdarzeń bez prawidłowego deduplikowania (pixel + CAPI bez event_id) albo filtrów i reguł prywatności w panelu reklamowym, które obcinają lub mapują pola. Poniżej znajdziesz uporządkowaną diagnostykę różnicową z testami do wykonania krok po kroku, konkretne polecenia w logach i narzędziach Meta, oraz sposoby weryfikacji efektu po poprawkach. Nie zakładamy przyczyny — każdy punkt trzeba sprawdzić i wyeliminować sekwencyjnie.
Jak rozpoznać przyczynę
Porównaj payloady Pixel i CAPI: sprawdź, czy pola zgodne z wymaganiami EMQ są obecne w żądaniach serwerowych. Brakuje zwykle email_hash, phone_hash, client_ip_address lub user_agent. Jeśli pola są przesyłane z klienta przez serwer, odnotuj, które pochodzą z cookie, a które z payloadu formularza.
Sprawdź proces hashowania: Meta oczekuje SHA256 w formacie hex dla personal identifiers. Błędy typowe: podwójne hashowanie, base64 zamiast hex, hashowanie z dodatkowym salt lub błędne kodowanie znaków (UTF-8 vs Latin-1). Zaloguj przykładowe wejścia i porównaj z narzędziem sha256 online.
Zidentyfikuj problemy z time_stamp i event_id: jeśli event_id lub event_time różnią się między Pixel i CAPI, deduplikacja nie zadziała i Meta może traktować zdarzenia jako oddzielne, co wpływa na EMQ. Sprawdź też opóźnienia przesyłania (>24h) i buffering, które obniżają trafność dopasowania.
Rozwiązanie krok po kroku
1. Wyciągnij 50 losowych zdarzeń z Menedżera zdarzeń z okresu problemu; pobierz przykład payloadu Pixel (z przeglądarki) i odpowiadający mu payload CAPI (z serwera) i zapisz oba w pliku JSON do porównań.
2. Dla każdego pola identyfikacyjnego porównaj wartości: czy email/phone/fbp/fbc/client_ip_address obecne w Pixel są też w CAPI? Jeżeli nie, otwórz kod serwera i sprawdź, czy middleware przepuszcza nagłówki i ciała żądań od klienta.
3. Zaimplementuj test hashowania: weź oryginalne dane (np. surowy email), policz SHA256 w hex na serwerze i porównaj z wartością wysyłaną do Meta; jeśli różne, napraw funkcję hashu i dopilnuj jednolitego kodowania UTF-8.
4. Zweryfikuj event_id i event_time: wymuś wysłanie identycznego event_id z Pixel i z CAPI w przykładzie testowym; jeśli pixel nie generuje event_id, wygeneruj u klienta zgodny identyfikator i przesyłaj go do obu źródeł.
5. Sprawdź opóźnienia: zmierz czas między zdarzeniem w przeglądarce a żądaniem CAPI; jeśli >5–10s sprawdź kolejki, batching i retry; jeśli >24h, sprawdź joby cron i ETL, bo takie opóźnienia obniżają EMQ.
6. Przejrzyj konfiguracje prywatności i mapping pól w Menedżerze zdarzeń: upewnij się, że pola nie są zmapowane do niestandardowych etykiet ani filtrowane przez reguły prywatności, które mogłyby obciąć email/phone.
7. Wprowadź jedną poprawkę na raz (hashing lub przesyłanie event_id) i obserwuj zmiany EMQ w ciągu 24–72 godzin; dokumentuj każdy deploy i czas wdrożenia.
Jak sprawdzić, czy problem zniknął
Test 1: Wyślij 20 kontrolowanych zdarzeń testowych z unikatowym event_id i kompletnymi zhashowanymi identyfikatorami; w Menedżerze zdarzeń sprawdź, że przynajmniej 80% ma 'High' lub 'Good' EMQ w ciągu 24–48 godzin.
Test 2: Porównaj wskaźnik matches między Pixel a CAPI dla tych samych event_id; oczekuj, że liczba poprawnie dopasowanych (matched) rośnie po poprawce hashowania/udostępnienia pól o minimum 30% wobec stanu wyjściowego.
Czego nie robić
Nie wdrażaj jednocześnie wielu zmian (hashing, event_id i opóźnienia). To uniemożliwia wskazanie, która poprawka poprawiła EMQ; wprowadzaj zmiany inkrementalnie.
Nie zakładaj, że brak email oznacza problem serwera — sprawdź polityki zgody i frontend (consent management), bo użytkownik może zablokować przekazanie danych.
Nie loguj pełnych PII do produkcyjnych logów. Loguj jedynie skróty/identyfikatory testowe i stosuj maskowanie, aby nie łamać zasad prywatności.