{"id":10468,"date":"2026-09-18T18:10:00","date_gmt":"2026-09-18T16:10:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=10468"},"modified":"2026-09-10T12:14:28","modified_gmt":"2026-09-10T10:14:28","slug":"hashowanie-w-conversions-api-normalizacja-danych-klienta-przed-sha-256","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/digital-marketing-pl\/hashowanie-w-conversions-api-normalizacja-danych-klienta-przed-sha-256\/","title":{"rendered":"Hashowanie w Conversions API: normalizacja danych klienta przed SHA-256 i kt\u00f3re pola pozostaj\u0105 niezahashowane"},"content":{"rendered":"

Zdarzenie Conversions API z zahaszowanym adresem e-mail wygl\u0105da tak samo, czy zahaszowano dobrze, czy \u017ale. \u0141adunek jest poprawny, interfejs odpowiada powodzeniem, licznik zdarze\u0144 ro\u015bnie, a jako\u015b\u0107 dopasowania zostaje tam, gdzie by\u0142a – bo adres, poprawnie zahaszowany do napisu, kt\u00f3remu nic nie odpowiada, por\u00f3wnano z baz\u0105 klient\u00f3w i nie znaleziono w \u017cadnej.<\/p>\n

To rodzaj pora\u017cki, kt\u00f3ry warto zrozumie\u0107 przed ca\u0142\u0105 instalacj\u0105: haszowanie nie zawodzi g\u0142o\u015bno, zawodzi, wytwarzaj\u0105c co\u015b technicznie nienagannego i tre\u015bciowo pustego.<\/p>\n

\n\"Ten
Dwie prawdziwe warto\u015bci SHA-256 tego samego adresu. Dziel\u0105 je trzy znaki odst\u0119pu i kilka wielkich liter.<\/figcaption><\/figure>\n

Dlaczego ma\u0142a r\u00f3\u017cnica jest r\u00f3\u017cnic\u0105 ca\u0142kowit\u0105<\/h2>\n

Funkcja skr\u00f3tu jest zbudowana tak, by drobna zmiana wej\u015bcia dawa\u0142a wyj\u015bcie r\u00f3\u017cne nie do poznania. Ta w\u0142asno\u015b\u0107 czyni haszowanie u\u017cytecznym i dok\u0142adnie ona czyni b\u0142\u0105d normalizacji \u015bmiertelnym: prawie-dopasowanie nie istnieje. Dwa skr\u00f3ty s\u0105 r\u00f3wne albo nie maj\u0105 ze sob\u0105 nic wsp\u00f3lnego, a \u017cadne, cho\u0107by najbardziej rozmyte, dopasowanie dalej w potoku tej r\u00f3\u017cnicy nie odzyska.<\/p>\n

O tym, czy zdarzenie znajdzie osob\u0119, rozstrzyga si\u0119 wi\u0119c, zanim funkcja skr\u00f3tu w og\u00f3le zostanie wywo\u0142ana – w tych kilku wierszach, kt\u00f3re ustalaj\u0105, co dok\u0142adnie do niej trafia.<\/p>\n

Posta\u0107, w jakiej musi sta\u0107 ka\u017cdy parametr<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n
Parametr<\/th>\nWymagana posta\u0107<\/th>\nCo idzie \u017ale<\/th>\n<\/tr>\n<\/thead>\n
em<\/code><\/td>\nprzyci\u0119te, ma\u0142e litery<\/td>\nwielka litera z formularza, spacja ze schowka<\/td>\n<\/tr>\n
ph<\/code><\/td>\nsame cyfry, z numerem kraju<\/td>\nkrajowe zero w +48 (0)601 prze\u017cywa<\/td>\n<\/tr>\n
fn<\/code>, ln<\/code><\/td>\nma\u0142e litery, bez znak\u00f3w i odst\u0119p\u00f3w<\/td>\n\u0142\u0105cznik w nazwisku dwucz\u0142onowym<\/td>\n<\/tr>\n
ct<\/code><\/td>\nma\u0142e litery, bez spacji<\/td>\nNowy S\u0105cz zachowuje spacj\u0119<\/td>\n<\/tr>\n
st<\/code>, country<\/code><\/td>\ndwuliterowy kod, ma\u0142e litery<\/td>\nkraj stoi rozpisany<\/td>\n<\/tr>\n
ge<\/code><\/td>\ndok\u0142adnie f<\/code> albo m<\/code><\/td>\ncokolwiek innego, zahaszowane jakby by\u0142o warto\u015bci\u0105<\/td>\n<\/tr>\n
db<\/code><\/td>\nRRRRMMDD<\/td>\nlokalny format daty, bezg\u0142o\u015bnie przestawiony<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Numer telefonu zas\u0142uguje na osobn\u0105 uwag\u0119, bo to jedyny przypadek, kt\u00f3rego nie da si\u0119 znormalizowa\u0107 maszynowo. Usuni\u0119cie z +48 (0)601 234567<\/code> wszystkiego poza cyframi daje 480601234567<\/code>, a zero po numerze kierunkowym kraju jest krajow\u0105 cyfr\u0105 wyj\u015bcia, kt\u00f3rej w numerze mi\u0119dzynarodowym by\u0107 nie powinno. \u017badna regu\u0142a nie rozstrzygnie tego niezawodnie dla ka\u017cdego kraju, dlatego uczciwym post\u0119powaniem jest usun\u0105\u0107 i zg\u0142osi\u0107 podejrzany wzorzec cz\u0142owiekowi, zamiast zgadywa\u0107.<\/p>\n

Parametry, kt\u00f3rych haszowa\u0107 nie wolno<\/h2>\n

B\u0142\u0105d odwrotny jest rzadszy i r\u00f3wnie ostateczny. client_ip_address<\/code>, client_user_agent<\/code>, fbp<\/code> i fbc<\/code> wysy\u0142a si\u0119 jawnie. Nie s\u0105 identyfikatorami w tym sensie, w jakim s\u0105 nimi pola haszowane; s\u0105 warto\u015bciami, kt\u00f3re Meta zestawia z w\u0142asnymi zapisami, a zahaszowana z nich to napis, kt\u00f3remu po drugiej stronie nic nie odpowiada.<\/p>\n

Najcz\u0119\u015bciej dzieje si\u0119 to wtedy, gdy pomocnicza funkcja haszuj\u0105ca zostaje zastosowana do ca\u0142ego obiektu danych u\u017cytkownika naraz – rozs\u0105dnie wygl\u0105daj\u0105cy kawa\u0142ek kodu, b\u0142\u0119dny w dok\u0142adnie czterech polach. Funkcja haszuj\u0105ca po nazwach p\u00f3l, a nie po obiekcie, to ta wersja, kt\u00f3ra przetrwa zmian\u0119 schematu.<\/p>\n

Jak to wygl\u0105da z zewn\u0105trz<\/h2>\n
# ten sam adres, trzy drogi\n\"  Max.Mustermann@Example.COM \"   → 524d6368ceb086b2b1d8fed14ee75313…\n\"  max.mustermann@example.com \"   → de4c5edc5348280eedb5b029d7851764…\n\"max.mustermann@example.com\"      → dd432348e6c3373c5f646913fa94ae79…\n\n# porównywany z czymkolwiek zostaje tylko trzeci<\/code><\/pre>\n
\u017baden z nich nie daje b\u0142\u0119du. Liczba zdarze\u0144 w mened\u017cerze zdarze\u0144 jest we wszystkich trzech przypadkach ta sama, dostarczenie zostaje potwierdzone we wszystkich trzech, a jedyn\u0105 wielko\u015bci\u0105, kt\u00f3ra si\u0119 rusza, jest jako\u015b\u0107 dopasowania – w d\u00f3\u0142, powoli i w spos\u00f3b, kt\u00f3ry wygodnie przypisa\u0107 porze roku albo zmianie w zgodach.<\/p>\n
U\u017cyteczn\u0105 kontrol\u0105 nie jest wi\u0119c odpowied\u017a interfejsu, tylko por\u00f3wnanie ze znan\u0105 warto\u015bci\u0105. Wzi\u0105\u0107 jeden adres z bazy klient\u00f3w, zahaszowa\u0107 go tak, jak robi to sklep, zahaszowa\u0107 tak, jak ka\u017ce specyfikacja, i por\u00f3wna\u0107 oba napisy. Zgadzaj\u0105 si\u0119 albo potok ma b\u0142\u0105d normalizacji – a odpowied\u017a zajmuje minut\u0119.<\/p>\n
Gdzie nale\u017cy normalizacja<\/h2>\n
Ostatnia decyzja dotyczy budowy. Normalizowa\u0107 da si\u0119 w przegl\u0105darce, w kontenerze serwerowym albo w systemie prowadz\u0105cym rekord klienta – i tylko ten ostatni ma pierwotn\u0105 warto\u015b\u0107 w tej postaci, w jakiej trzyma j\u0105 baza klient\u00f3w.<\/p>\n
Robienie tego w kontenerze serwerowym to zwyk\u0142a droga po\u015brednia i sprawdza si\u0119, o ile kontener dostaje warto\u015b\u0107 surow\u0105, a nie co\u015b, co formularz ju\u017c obrobi\u0142. Robienie tego w przegl\u0105darce to jedyny uk\u0142ad, kt\u00f3rego nale\u017cy unika\u0107: k\u0142adzie adres jawnie w \u017c\u0105daniu opuszczaj\u0105cym urz\u0105dzenie odwiedzaj\u0105cego – dok\u0142adnie to, czemu haszowanie mia\u0142o zapobiec.<\/p>\n
\n
\u0179r\u00f3d\u0142a<\/h2>\n