Instalacja WP Pixel
Instalacja WP Pixel na stronie
Aby zainstalować WP Pixel należy dodać poniższy kod w sekcji <head>
na każdej stronie serwisu. Należy umieścić indywidualny identyfikator w dwóch miejscach oznaczonych PIXEL_ID
.
Ponadto skrypt dopuszcza podanie dodatkowych parametrów (DODATKOWE_PARAMETRY
).
Parametry identyfikujące użytkownika nie są obowiązkowe, jednak zarówno HEM
jak i LTID
pozwolą aktywować kampanie w środowisku bez Third-Party Cookies - obecnie na przeglądarkach Safari, Firefox, ale w przyszłości również na przeglądarce Chrome.
W przypadku rezygnacji z przekazywania dodatkowych parametrów, należy usunąć zapis , DODATKOWE_PARAMETRY
ze skryptu osadzenia.
<head>
<script>
!function(w,p,e,v,n,t,s){w['WphTrackObject'] = n;
w[n] = window[n] || function() {(w[n].queue=w[n].queue||[]).push(arguments)},
w[n].l = 1 * new Date(), t=p.createElement(e), s=p.getElementsByTagName(e)[0],
t.async=1;t.src=v;s.parentNode.insertBefore(t,s)}(window,document,'script',
'https://pixel.wp.pl/w/PIXEL_ID/tr.js', 'wph');
wph('init', 'PIXEL_ID', DODATKOWE_PARAMETRY);
</script>
</head>
Po wdrożeniu skryptu osadzenia, należy przejść do następnego kroku, jakim jest implementacja kodów zdarzeń:
klienci z branży e-commerce
klienci spoza branży e-commerce
Dodatkowe parametry
Skrypt dopuszcza podanie dodatkowych parametrów w opcjonalnym obiekcie konfiguracyjnym:
em
- e-mail użytkownika znormalizowany i zahashowany zgodnie z poniższymi wytycznymi. W przypadku podania adresu e-mail w postaci oryginalnej skrypt dokona normalizacji i hashowania przed wysyłką eventów.ltid
(long-term id) - unikalny, tekstowy identyfikator użytkownika (niepustystring
). Przed wysyłką eventu skrypt usunie białe znaki z początku i końca identyfikatora.ltid_name
- jeśliltid
przechowywane jest w cookie, skrypt może sam wyciągnąć tę wartość i wysłać ją w evencie. W tym parametrze należy wtedy podać nazwę cookie. W przypadku podania poprawnego parametrultid
, parametr (ltid_name
) zostanie zignorowany. Zarówno nazwa jak i wartość cookie powinna być niepustymi tekstami (string
).
Przykłady osadzenia z dodatkowymi parametrami
Osadzenie bez dodatkowych parametrów
<head>
<script>
!function(w,p,e,v,n,t,s){w['WphTrackObject'] = n;
w[n] = window[n] || function() {(w[n].queue=w[n].queue||[]).push(arguments)},
w[n].l = 1 * new Date(), t=p.createElement(e), s=p.getElementsByTagName(e)[0],
t.async=1;t.src=v;s.parentNode.insertBefore(t,s)}(window,document,'script',
'https://pixel.wp.pl/w/PIXEL_ID/tr.js', 'wph');
wph('init', 'PIXEL_ID');
</script>
</head>
Osadzenie z hashem adresu e-mail (parametr em
)
<head>
<script>
!function(w,p,e,v,n,t,s){w['WphTrackObject'] = n;
w[n] = window[n] || function() {(w[n].queue=w[n].queue||[]).push(arguments)},
w[n].l = 1 * new Date(), t=p.createElement(e), s=p.getElementsByTagName(e)[0],
t.async=1;t.src=v;s.parentNode.insertBefore(t,s)}(window,document,'script',
'https://pixel.wp.pl/w/PIXEL_ID/tr.js', 'wph');
wph('init', 'PIXEL_ID', {em:
'f02f61d33aac1c8d56813d668299b33d05aa99adf2056c1950f688459da1a465'});
</script>
</head>
Osadzenie z id użytkownika (parametr ltid
)
<head>
<script>
!function(w,p,e,v,n,t,s){w['WphTrackObject'] = n;
w[n] = window[n] || function() {(w[n].queue=w[n].queue||[]).push(arguments)},
w[n].l = 1 * new Date(), t=p.createElement(e), s=p.getElementsByTagName(e)[0],
t.async=1;t.src=v;s.parentNode.insertBefore(t,s)}(window,document,'script',
'https://pixel.wp.pl/w/PIXEL_ID/tr.js', 'wph');
wph('init', 'PIXEL_ID', {ltid: '48b69fcca1d29075b14b8aef0'});
</script>
</head>
Osadzenie z wieloma dodatkowymi parametrami (ltid_name
i em
)
<head>
<script>
!function(w,p,e,v,n,t,s){w['WphTrackObject'] = n;
w[n] = window[n] || function() {(w[n].queue=w[n].queue||[]).push(arguments)},
w[n].l = 1 * new Date(), t=p.createElement(e), s=p.getElementsByTagName(e)[0],
t.async=1;t.src=v;s.parentNode.insertBefore(t,s)}(window,document,'script',
'https://pixel.wp.pl/w/PIXEL_ID/tr.js', 'wph');
wph('init', 'PIXEL_ID', {em: 'user@test.com', ltid_name: 'ID_COOKIE_NAME'});
</script>
</head>
Normalizacja adresów e-mail
Normalizacja adresów e-mail ma na celu standaryzację i unifikację danych wejściowych, w kierunku poprawy spójności procesu hashowania. Przeprowadzenie poprawnej normalizacji adresów e-mail pomaga w utrzymaniu jednolitości i unikalności danych wejściowych, co przekłada się na poprawę bezpieczeństwa i skuteczności procesu identyfikacji.
Aby znormalizować adres e-mail, należy wykonać następujące kroki:
- usunąć spacje z początku i z końca adresu;
- przekształcić wszystkie znaki ASCII na małe litery;
- w adresach e-mail z domeny gmail.com należy usunąć następujące znaki z części adresu email dotyczącej nazwy użytkownika:
kropka .
np. jan.kowalski@gmail.com
powinno zostać zmienione na jankowalski@gmail.com
;
- z części adresu e-mail dotyczącej nazwy użytkownika należy usunąć znak
+
oraz wszystkie następujące po nim znaki:
np. jankowalski+newsletter@wp.pl
powinno zostać zamienione na jankowalski@wp.pl
.
Kodowanie hash adresów e-mail
Metoda normalizacji adresów e-mail ma na celu umożliwienie systemom informatycznym bezpiecznego przechowywania i analizowania informacji identyfikacyjnych użytkowników. Hashowanie, będące procesem przekształcania danych wejściowych (w tym adresów e-mail) w unikalny ciąg znaków o stałej długości, pozwala na skuteczne utajnienie oryginalnych danych przy jednoczesnym zachowaniu ich unikalności.
Identyfikacja zahashowanych adresów e-mail stanowi kluczową część praktyk bezpieczeństwa informacji. Wprowadzanie zahashowanych wersji adresów e-mail umożliwia systemom przechowywanie informacji identyfikacyjnych w sposób, który minimalizuje ryzyko naruszeń prywatności.
Znormalizowany adres e-mail należy zahashować algorytmem hashującym SHA-256. Zahashowany adres e-mail powinien mieć postać heksadecymalnego ciągu znaków.