Używanie kodu JavaScript i jego ustawień

Po zainstalowaniu skryptu na stronach witryny utworzone zostały dwa obiekty globalne.

Obiekt

Tytuł

Opis

Obiekt

Tytuł

Opis

window.SPH

Smart Pixel Helper

Obiekt do ustawiania i inicjalizacji samego kodu JavaScript

window.SPM

Smart Pixel Manager

Interfejs umożliwiający pracę z pikselami wewnątrz strony

Ustawienia podstawowe aplikacji Smart Pixel Helper (SPH):

  • cookieName - nazwa pliku cookie, w którym będzie przechowywany identyfikator użytkownika (domyślnie "ssId")

  • cookieExpireYears - czas życia pliku cookie z identyfikatorem użytkownika zapisany w zmiennej cookieName (domyślnie 10 lat)

  • queryParameter - wartość zmiennej GET przechowującej identyfikator użytkownika

Domyślną wartością jest "ssId", jeśli zmienisz tę opcję, opcja Smart Pixel wewnątrz lejka zostanie zepsuta i będziesz musiał ręcznie podać identyfikator użytkownika.

  • timeout - wartość opóźnienia, która jest wykorzystywana do opóźnionego przetwarzania wideo, elementów formularzy, ponieważ ich ładowanie jest asynchroniczne (domyślnie wartość wynosi 3 sekundy). Wartość jest podawana w formacie milisekund, np. 3 sekundy = 3000 milisekund.

Nie należy podawać zbyt niskiej wartości, ponieważ przy niskich opóźnieniach nie wszystkie elementy mogą zostać przechwycone.

  • identyfikator - identyfikator twojego piksela dla projektu

  • baseUrl - bazowy adres URL, który jest używany przez system do integracji i przesyłania danych

Nie zmieniaj tej wartości samodzielnie, jeśli integracja jest aktualizowana przez Smart Sender, będziesz musiał zmienić tę wartość

 

Główne funkcje programu Smart Pixel Manager (SPM):

  • fire(nazwa, kontekst) - wywołuje ręczne zdarzenie o nazwie ze zmiennymi, które mają być przechowywane w karcie klienta

  • user.get(): Number|String|Null - zwraca identyfikator użytkownika Smart Sender;

  • user.exists(): Boolean - sprawdza, czy identyfikator użytkownika Smart Sender istnieje;

  • user.set(identyfikator): void - Określa identyfikator użytkownika Smart Sender dla bieżącej sesji.

 

Przykłady zastosowania

Inicjalizowanie skryptu z parametrami niestandardowymi

.... window.SPH = { timeout: 8000, // 8 sec cookieName: 'smartId', cookieExpireYears: 1, identifier: 'SPH-XXXXXX', // enter your Smart Pixel identifiier here baseUrl: 'https://customer.smartsender.eu/pixel', }; ...

Uruchomienie ręcznego zdarzenia "demo" ze zmienną użytkownika "nazwa" i wartością "wartość".

window.SPM.fire('demo', { name: 'value', });

Uzyskiwanie identyfikatora użytkownika

return window.SPM.user.get(); // return '7777'