{"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-10-26T11:52:52","modified_gmt":"2026-10-26T10:52:52","slug":"przygotowanie-danych-klientow-do-meta-conversions-api-formatowanie-i-hashowanie","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/digital-marketing-pl\/przygotowanie-danych-klientow-do-meta-conversions-api-formatowanie-i-hashowanie\/","title":{"rendered":"Przygotowanie danych klient\u00f3w do Meta Conversions API: formatowanie i hashowanie"},"content":{"rendered":"

SHA-256 oblicza z danych wej\u015bciowych warto\u015b\u0107 o sta\u0142ej d\u0142ugo\u015bci, nazywan\u0105 skr\u00f3tem lub haszem. Poprawna odpowied\u017a Conversions API nie potwierdza prawid\u0142owego dopasowania adresu e-mail. Wiarygodnie wygl\u0105daj\u0105cy skr\u00f3t SHA-256 mo\u017ce powsta\u0107 z niew\u0142a\u015bciwie przygotowanych danych. Inne identyfikatory nadal mog\u0105 wspiera\u0107 dopasowanie. Przyj\u0119cie zdarzenia, jako\u015b\u0107 danych i rzeczywiste dopasowanie wymagaj\u0105 zatem osobnych kontroli.<\/p>\n

Normalizacja oznacza tutaj przygotowanie warto\u015bci do postaci wymaganej dla konkretnego pola przed haszowaniem. Dla adresu e-mail kolejno\u015b\u0107 obejmuje usuni\u0119cie bia\u0142ych znak\u00f3w z pocz\u0105tku i ko\u0144ca, zamian\u0119 liter na ma\u0142e, a nast\u0119pnie obliczenie SHA-256. Zmiana gotowego skr\u00f3tu nie naprawia b\u0142\u0119du wej\u015bcia.<\/p>\n

\"Dwie
Dwa zapisy, dwa skr\u00f3ty. Lokalne por\u00f3wnanie z oczekiwan\u0105 warto\u015bci\u0105 nie potwierdza przyj\u0119cia przez API ani atrybucji.<\/figcaption><\/figure>\n

Dlaczego dok\u0142adna posta\u0107 wej\u015bcia ma znaczenie<\/h2>\n

SHA-256 przetwarza bajty. Spacje i wielko\u015b\u0107 liter zmieniaj\u0105 wynik. W przyk\u0142adzie trzy zapisy tego samego fikcyjnego adresu daj\u0105 trzy r\u00f3\u017cne skr\u00f3ty. Por\u00f3wnanie z oczekiwanym skr\u00f3tem wymaga znormalizowanego zapisu. Nie oznacza to, \u017ce Meta w og\u00f3le nie por\u00f3wnuje innych warto\u015bci ani \u017ce ca\u0142e zdarzenie musi pozosta\u0107 bez dopasowania.<\/p>\n

Regu\u0142y p\u00f3l zamiast jednej funkcji do wszystkiego<\/h2>\n

Poni\u017csza tabela u\u0142atwia przygotowanie integracji. Rozstrzygaj\u0105ce pozostaj\u0105 aktualna specyfikacja p\u00f3l Meta i u\u017cywana wersja SDK. SDK to biblioteka programistyczna u\u0142atwiaj\u0105ca korzystanie z API. Mo\u017ce ju\u017c normalizowa\u0107 i haszowa\u0107 dane, dlatego wcze\u015bniejsze przekszta\u0142cenia musz\u0105 by\u0107 zgodne z tym dzia\u0142aniem.<\/p>\n\n
Pole<\/th>Przygotowanie i kontrola<\/th><\/tr><\/thead>
em<\/code><\/td>Usuni\u0119cie zewn\u0119trznych bia\u0142ych znak\u00f3w i ma\u0142e litery; bez wymy\u015blonych poprawek samego adresu.<\/td><\/tr>\n
ph<\/code><\/td>Numer mi\u0119dzynarodowy z kodem kraju, do haszowania zapisany samymi cyframi. Prefiksy zale\u017cne od kraju wymagaj\u0105 wcze\u015bniejszej interpretacji.<\/td><\/tr>\n
fn<\/code>, ln<\/code><\/td>Ma\u0142e litery i kontrola zewn\u0119trznych bia\u0142ych znak\u00f3w. Sprawdzone funkcje Python\/Node.js nie usuwaj\u0105 tutaj automatycznie wszystkich wewn\u0119trznych spacji i znak\u00f3w interpunkcyjnych.<\/td><\/tr>\n
ct<\/code><\/td>Nazwa miejscowo\u015bci ma\u0142ymi literami, bez spacji i interpunkcji wed\u0142ug specyfikacji pola; dzia\u0142anie SDK wymaga test\u00f3w na przyk\u0142adach.<\/td><\/tr>\n
country<\/code>, st<\/code><\/td>Kraj jako dwuliterowy kod ISO, np. pl<\/code>. Region wymaga osobnej obs\u0142ugi: skr\u00f3t stanu USA nie jest \u015bwiatow\u0105 regu\u0142\u0105 zapisu region\u00f3w.<\/td><\/tr>\n
ge<\/code>, db<\/code><\/td>Je\u017celi dane s\u0105 dost\u0119pne i przetwarzanie dozwolone: f<\/code>\/m<\/code> albo poprawna data w formacie YYYYMMDD<\/code>. Brakuj\u0105cych warto\u015bci nie nale\u017cy zgadywa\u0107.<\/td><\/tr>\n<\/tbody><\/table>\n

Numery telefon\u00f3w mo\u017cna przetwarza\u0107 automatycznie z uwzgl\u0119dnieniem kraju i aktualnej biblioteki, takiej jak libphonenumber. Samo usuni\u0119cie znak\u00f3w innych ni\u017c cyfry nie wystarcza: w niemieckim przyk\u0142adzie +49 (0)170 1234567<\/code> pozosta\u0142oby zb\u0119dne zero. Usuwanie zera po ka\u017cdym kodzie kraju r\u00f3wnie\u017c jest b\u0142\u0119dem; pocz\u0105tkowe zero mo\u017ce nale\u017ce\u0107 do w\u0142oskiego numeru mi\u0119dzynarodowego. Niejednoznaczne dane wymagaj\u0105 wyja\u015bnienia. Kontrola formatu nie potwierdza aktualnej dost\u0119pno\u015bci numeru.<\/p>\n\n\n\n

\"Pranie
Pranie jest posortowane wed\u0142ug rodzaju w trzech koszach, a jedwabna chusta wisi osobno. Tak samo ka\u017cdy rodzaj danych klienta potrzebuje w\u0142asnej regu\u0142y przed hashowaniem (uczynieniem nieczytelnymi).<\/figcaption><\/figure>\n\n\n

Warto\u015bci przekazywane bez haszowania<\/h2>\n

client_ip_address<\/code>, client_user_agent<\/code>, fbp<\/code> i fbc<\/code> s\u0105 przekazywane bez haszowania, zgodnie ze specyfikacj\u0105 p\u00f3l. Nie oznacza to braku znaczenia dla prywatno\u015bci ani braku zwi\u0105zku z danymi osobowymi. Adres IP musi odpowiada\u0107 zdarzeniu; adres proxy nie zast\u0119puje adresu przegl\u0105darki. Identyfikator\u00f3w plik\u00f3w cookie i klikni\u0119\u0107 nie wolno dowolnie wymy\u015bla\u0107.<\/p>\n

To wa\u017cne przyk\u0142ady, a nie pe\u0142na lista p\u00f3l API. Jawne mapowanie okre\u015bla walidacj\u0119, normalizacj\u0119, haszowanie albo przekazanie bez zmian. Nowe pola wymagaj\u0105 osobnej decyzji zamiast obj\u0119cia ca\u0142ego obiektu jedn\u0105 p\u0119tl\u0105 haszuj\u0105c\u0105.<\/p>\n

Powtarzalny test bez prawdziwych danych klient\u00f3w<\/h2>\n

Przyk\u0142ad w Pythonie oblicza pe\u0142ne skr\u00f3ty fikcyjnego adresu. Pierwsze dwa wyniki zaczynaj\u0105 si\u0119 od 524d6368<\/code> i de4c5edc<\/code>; wersja znormalizowana zaczyna si\u0119 od dd432348<\/code>.<\/p>\n

Python<\/span>