{"id":8833,"date":"2026-08-18T10:43:00","date_gmt":"2026-08-18T08:43:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=8833"},"modified":"2026-10-24T01:42:42","modified_gmt":"2026-10-23T23:42:42","slug":"meta-conversions-api-maksymalizacja-event-match-quality-emq-i-deduplikacja","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/digital-analytics-pl\/meta-conversions-api-maksymalizacja-event-match-quality-emq-i-deduplikacja\/","title":{"rendered":"Meta Conversions API: Maksymalizacja Event Match Quality (EMQ) i deduplikacja"},"content":{"rendered":"
Co mierzy EMQ<\/h2>\n
Meta Pixel wysy\u0142a zdarzenia z przegl\u0105darki, a Conversions API (CAPI) z serwera. Przy dw\u00f3ch zg\u0142oszeniach tego samego zakupu dopasowanie s\u0142u\u017cy znalezieniu mo\u017cliwego konta Meta. Deduplikacja rozpoznaje natomiast powt\u00f3rzone zdarzenie. To dwa odr\u0119bne zadania.<\/p>\n
Event Match Quality (EMQ) ocenia informacje o klientach przekazane w zdarzeniach internetowych w skali do 10. Wynik opisuje mo\u017cliw\u0105 przydatno\u015b\u0107 danych do dopasowania. EMQ 8 nie oznacza dopasowania 80% zakup\u00f3w. Wysoki wynik nie potwierdza poprawno\u015bci atrybucji, dodatkowej sprzeda\u017cy ani zgodno\u015bci przetwarzania z prawem.<\/p>\n
Normalizacja zale\u017cy od pola<\/h2>\n
SHA-256 tworzy skr\u00f3t o sta\u0142ej d\u0142ugo\u015bci. Dodatkowa spacja zmienia wynik, dlatego Meta okre\u015bla zasady przygotowania poszczeg\u00f3lnych p\u00f3l:<\/p>\n
\n
em<\/code>: usuni\u0119cie bia\u0142ych znak\u00f3w z pocz\u0105tku i ko\u0144ca oraz zamiana adresu e-mail na ma\u0142e litery. Podejrzane znaki steruj\u0105ce lub niewidoczne znaki formatowania wymagaj\u0105 kontroli zamiast cichej zmiany adresu.<\/li>\n
ph<\/code>: najpierw ustalenie numeru mi\u0119dzynarodowego z potwierdzonym kodem kraju, nast\u0119pnie usuni\u0119cie formatowania. Samo usuni\u0119cie znak\u00f3w innych ni\u017c cyfry nie dodaje kodu kraju i nie rozwi\u0105zuje kwestii krajowego prefiksu.<\/li>\n
Imiona i dane adresowe: obowi\u0105zuj\u0105 regu\u0142y konkretnego parametru. Usuwanie wszystkich znak\u00f3w diakrytycznych jest b\u0142\u0119dem; przyk\u0142ad Meta zachowuje akcent w imieniu val\u00e9ry<\/code>.<\/li>\n<\/ul>\n
Adresy e-mail, telefony oraz oznaczone pola imienia i adresu wymagaj\u0105 SHA-256. Adres IP klienta, user agent, fbp<\/code> i fbc<\/code> s\u0105 przekazywane bez haszowania. Dla external_id<\/code> Meta zaleca haszowanie, ale API nie ustanawia og\u00f3lnego obowi\u0105zku haszowania tego parametru. Haszowanie nie anonimizuje danych nadal umo\u017cliwiaj\u0105cych powi\u0105zanie z klientem.<\/p>\n
Przyk\u0142ad Node.js o ograniczonym zakresie<\/h3>\n
Poni\u017cszy modu\u0142 ES haszuje adres e-mail albo wcze\u015bniej zweryfikowany mi\u0119dzynarodowy numer telefonu. Kontrola e-maila jest podstawowym sprawdzeniem formatu, a nie pe\u0142n\u0105 walidacj\u0105 adresu. Rozpoznanie numeru i potwierdzenie kraju musz\u0105 nast\u0105pi\u0107 wcze\u015bniej. Wyra\u017cenie regularne sprawdza tylko akceptowan\u0105 posta\u0107. Numery krajowe lub nadal zawieraj\u0105ce formatowanie s\u0105 odrzucane zamiast zgadywane. Zero nale\u017c\u0105ce do numeru po kodzie kraju pozostaje bez zmian.<\/p>\n
import { createHash } from 'node:crypto';\nconst sha256 = value => createHash('sha256').update(value, 'utf8').digest('hex');\nexport function hashEmail(raw) {\n if (typeof raw !== 'string') return null;\n const email = raw.trim().toLowerCase();\n if (\/[\\p{Cc}\\p{Cf}]\/u.test(email) || !\/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$\/u.test(email)) return null;\n return sha256(email);\n}\nexport function hashCanonicalPhone(e164) {\n if (typeof e164 !== 'string' || !\/^\\+[1-9][0-9]{6,14}$\/.test(e164)) return null;\n return sha256(e164.slice(1));\n}\n<\/code><\/pre>\n
Nieprawid\u0142owe dane daj\u0105 wynik null<\/code> i musz\u0105 zosta\u0107 pomini\u0119te w \u017c\u0105daniu. SDK lub szablon tagu mo\u017ce ju\u017c wykonywa\u0107 normalizacj\u0119 i haszowanie. Podw\u00f3jne haszowanie tworzy b\u0142\u0119dny identyfikator, dlatego znaczenie ma format wej\u015bciowy wymagany przez konkretn\u0105 integracj\u0119.<\/p>\n\nNormalizacja w\u0142a\u015bciwa dla pola poprzedza haszowanie. Deduplikacja wymaga tak\u017ce zgodnej nazwy zdarzenia, Pixel ID i okna odbioru.<\/figcaption><\/figure>\n
Jedno zdarzenie, wsp\u00f3lny identyfikator<\/h2>\n
Zalecane parowanie wymaga tej samej nazwy zdarzenia i identyfikatora dla tego samego Pixel ID. W przegl\u0105darce parametr nazywa si\u0119 eventID<\/code>, a w CAPI event_id<\/code>. Dla zakupu oba zdarzenia maj\u0105 nazw\u0119 Purchase<\/code>. Meta dokumentuje okno odbioru 48 godzin od pierwszego zdarzenia z dan\u0105 identyfikacj\u0105.<\/p>\n
Identyfikator mo\u017ce powsta\u0107 w backendzie albo przegl\u0105darce. Raz utworzona, stabilna identyfikacja zdarzenia zakupu trafia do obu kana\u0142\u00f3w. Ponowienia tego samego zdarzenia zachowuj\u0105 warto\u015b\u0107; kolejny zakup otrzymuje now\u0105. Wsp\u00f3lny identyfikator wszystkich zakup\u00f3w prowadzi\u0142by do \u0142\u0105czenia r\u00f3\u017cnych zdarze\u0144.<\/p>\n
Szybka wysy\u0142ka ogranicza problemy z kolejkami, ale nie gwarantuje natychmiastowej aktualizacji raport\u00f3w. Dane serwerowe nie zawsze pozostaj\u0105 zachowane w ca\u0142o\u015bci. Meta opisuje kilka strategii i przy braku istotnych r\u00f3\u017cnic zwykle preferuje zdarzenie odebrane jako pierwsze.<\/p>\n
Cookies, identyfikatory klient\u00f3w i zgoda<\/h2>\n
_fbp<\/code> i _fbc<\/code> to cookies pierwszej strony. Istniej\u0105ce warto\u015bci mog\u0105 zasila\u0107 parametry fbp<\/code> i fbc<\/code>. Utworzenie fbc<\/code> wymaga rzeczywi\u015bcie zaobserwowanego fbclid<\/code>. Wielko\u015b\u0107 liter w identyfikatorze klikni\u0119cia pozostaje bez zmian. Zmy\u015blone warto\u015bci nie poprawiaj\u0105 pomiaru.<\/p>\n
external_id<\/code> to identyfikator klienta nadany przez reklamodawc\u0119. Po dopasowaniu na podstawie innych informacji Meta mo\u017ce powi\u0105za\u0107 identyfikator z kontem i ponownie wykorzysta\u0107 powi\u0105zanie przy kolejnych zdarzeniach. Powi\u0105zania okresowo wygasaj\u0105. Sp\u00f3jne identyfikatory mog\u0105 wspiera\u0107 ci\u0105g\u0142o\u015b\u0107 pomiaru, ale nie gwarantuj\u0105 atrybucji mi\u0119dzy urz\u0105dzeniami po wielu tygodniach ani nie wyd\u0142u\u017caj\u0105 okna atrybucji.<\/p>\n
Integracja reklamowa oparta na zgodzie wymaga odpowiedniej kontroli zar\u00f3wno w przegl\u0105darce, jak i na serwerze. Google Consent Mode nie blokuje automatycznie serwerowego tagu Meta: sygna\u0142 CMP wymaga jawnego mapowania i egzekwowania. Wycofanie zgody musi r\u00f3wnie\u017c zatrzyma\u0107 oczekuj\u0105ce wysy\u0142ki, je\u017celi przetwarzanie przestaje by\u0107 dozwolone. Haszowanie i transport serwerowy nie zast\u0119puj\u0105 tych mechanizm\u00f3w.<\/p>\n
Kontrola przed ocen\u0105 raport\u00f3w<\/h2>\n
Kontrolowany zakup testowy powinien utworzy\u0107 zdarzenie przegl\u0105darkowe i serwerowe z identyczn\u0105 nazw\u0105 oraz identyfikatorem, a nast\u0119pnie oczekiwany wynik deduplikacji. Osobne pr\u00f3by obejmuj\u0105 brak zgody, wycofanie zgody, ponowienia, op\u00f3\u017anienia i brak identyfikator\u00f3w. Trend EMQ uzupe\u0142nia liczb\u0119 zdarze\u0144 oraz b\u0142\u0119dy przetwarzania; pojedynczy wynik nie stanowi certyfikatu jako\u015bci.<\/p>\n
\u015acie\u017ck\u0119 integracji przedstawia Meta Conversions API przez Server-Side GTM<\/span>.<\/p>\n
\n
Pytania i odpowiedzi<\/h2>\n
Czy mo\u017cna dopisa\u0107 kod kraju do numeru krajowego?<\/h3>\n
Tylko przy wiarygodnie ustalonym kraju danego numeru i poprawnym rozpoznaniu krajowego prefiksu. J\u0119zyk strony lub kraj sklepu nie wystarcza. Dla niejednoznacznych danych historycznych bezpieczniejszym technicznie rozwi\u0105zaniem jest pomini\u0119cie pola i poprawa danych \u017ar\u00f3d\u0142owych. Brak numeru nie obni\u017ca dopasowania o sta\u0142\u0105, znan\u0105 warto\u015b\u0107: wynik zale\u017cy r\u00f3wnie\u017c od pozosta\u0142ych identyfikator\u00f3w.<\/p>\n<\/div>\n
![\"\u0141a\u0144cuch](\"https:\/\/www.lukaswojcik.com\/blog\/wp-content\/uploads\/diagrams\/quality-8833-20261024.png\")