Używanie kodu JavaScript i jego ustawień
Po zainstalowaniu skryptu na stronach witryny utworzone zostały dwa obiekty globalne.
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'