Instalacja WP Pixel

Skrypt osadzenia

Implementacja na każdej stronie witryny. Rekomendowane jest, aby skrypt został umieszczony w sekcji <head> lub na koniec <body>. Łańcuch znaków PIXEL_ID, który pojawia się dwa razy w skrypcie, należy zastąpić wygenerowanym identyfikatorem.

Ponadto skrypt dopuszcza przekazanie dodatkowych parametrów.
Parametry identyfikujące użytkownika nie są obowiązkowe, jednak zarówno em 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.

Ogólna forma skryptu osadzenia

Skrypt ogólny

!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);

Osadź skrypt Pixla na swojej stronie w 3 prostych krokach (bez parametrów dodatkowych)

Wpisz w ramkę swój pixel ID i zatwierdź: →

Skopiuj poniższy blok kodu

<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>

Wklej go w źródło strony lub w odpowiednie miejsce w panelu platformy e-commerce. Gotowe!

Skrypty zdarzeń

Po wdrożeniu skryptu osadzenia, kolejnym etapem jest wdrożenie pozostałych kodów WP Pixel:

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 (niepusty string). Przed wysyłką eventu skrypt usunie białe znaki z początku i końca identyfikatora.
ltid_name - jeśli ltid 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 parametru ltid, 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

<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>

Osadzenie z hashem adresu e-mail (parametr em)

<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>

Osadzenie z id użytkownika (parametr ltid)

<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>

Osadzenie z wieloma dodatkowymi parametrami (ltid_name i em)

<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>

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.