Wtyczka YouLead tracking dla CMS WordPress służy do śledzenia (trackowania) ruchu użytkownika na stronie, a także pozwala w prosty sposób zintegrować formularze dodane za pomocą wtyczki Contact Form 7. Dane z formularza zaraz po wypełnieniu zostaną przesłane do YouLead.
W przypadku wystąpienia potrzeby trackowania zdarzeń związanych z e-commerce (obejrzenie produktu, koszyk, zakup), należy je obsłużyć niezależnie od wtyczki, w oparciu o dokumentację API.
Konfiguracja wtyczki
Po zainstalowaniu wtyczki należy ją skonfigurować. W tym celu należy wypełnić następujące dane:
![](https://manual.youlead.io/wp-content/uploads/2021/04/image-2.png)
- Client ID -> unikalny identyfikator klienta
- Application ID -> AppID (Panel YouLead > Ustawiania > Aplikacje)
- Secret Key -> AppSecretKey (Panel YouLead > Ustawiania > Aplikacje)
Client ID jest przekazywany od opiekuna instancji razem z danymi do logowania w panelu, który znajduje się pod adresem: clientId.youlead.pl
W panelu YouLead należy wybrać bądź stworzyć „Aplikację”, która umożliwi integrację.
Po zalogowaniu należy kliknąć zakładkę „Ustawiania”, następnie „Aplikacje”.
![](https://manual.youlead.io/wp-content/uploads/2021/04/1-1024x303.png)
Następnie należy wybrać lub stworzyć nową aplikację
AppID musi mieć inną nazwę niż Client ID
![](https://manual.youlead.io/wp-content/uploads/2021/04/2.png)
Konfiguracja Contact Form 7
Dane z wypełnionego formularza mogą mieć swoje odzwierciedlenie w atrybutach w systemie YouLead. W tym celu, podczas tworzenia lub edycji formularza polom formularza należy nadać odpowiednie nazwy. Poniżej zamieszczona jest przykładowa konfiguracja formularza
Następujące pola formularza zostaną odpowiednio ustawione w YouLead:
- Imię kontaktu -> imie
- Nazwisko kontaktu -> nazwisko
- Adres e-mail kontaktu -> email
- Telefon kontaktu -> telefon
Jeśli istnieje potrzeba użycia nazwy pola, która jest niedozwolona (na przykład name), to może ona być poprzedzona prefiksem yl-. Przykład takiego formularza zamieszczono poniżej.
Zgodnie z powyższym w YouLead zostaną ustawione atrybuty:
- Imię kontaktu -> yl-name
- Nazwisko kontaktu -> yl-lastname
- Adres e-mail kontaktu -> yl-email
- Telefon kontaktu -> yl-phone
Przekazywanie statusu
Istnieje możliwość określenia czy status kontaktu ma być wysyłany z konkretnym formularzem. Można to zrobić dodając do wybranego formularza pole typu hidden z parametrem name=”ylSendStatus”. Jeśli wartość tego pola wynosi true, status zostanie przesłany razem z formularzem. W przypadku ustawienia wartości false, status nie zostanie wysłany. Jeśli formularz nie będzie zawierać tego pola, domyślnie status będzie przesyłany.
W poniższej tabeli został zamieszczony szablon tagu formularza odpowiadający za sterowanie statusami
[hidden ylSendStatus default:”true”] | Formularz zostanie przesłany wraz z statusem |
[hidden ylSendStatus default:”false”] | Formularz zostanie przesłany bez statusu |
Przykład formularza, w którym status kontaktu nie jest przesyłany:
Wykluczanie formularzy:
Formularze mogą być wykluczone z integracji przy wykorzystaniu elementu [hidden ylBlockSend default:”true”]
![](https://manual.youlead.io/wp-content/uploads/2024/04/image-7.png)
Do wybranego formularza należy dodać ukryty element o nazwie ylBlockSend z wartością true, analogicznie do ylSendStatus.
Moduł zarządzania plikami cookies:
Uwaga!
Moduł działa tylko z cookiebotami które tworzą ciastko, a wartości w nim są rozpisane jako para klucz:wartość.
np.: necessary:yes,functional:yes,analytics:yes
![](https://manual.youlead.io/wp-content/uploads/2024/04/image-4.png)
- Zaznaczenie checkboxa „Dodaj ciastko blokowania śledzenia*” uruchomi sterowanie ciastkami
- Wpisanie nazwy ciastka cookie bota przechowującego dane
- Opcjonalnie pole wstawienia znaku, który oddziela wartości w ciastku (domyślnie przecinek)
- Pole na zgody rozpisane jako para klucz:wartość na podstawie ciastka, którego nazwę się podało wyżej
Przykład:
![](https://manual.youlead.io/wp-content/uploads/2024/04/image-5.png)
Dla testów można skorzystać w konsoli z document.cookie = 'ylDebug=1; path=/;’; w celu dodania ciastka technicznego i sprawdzenia ciastek, które zostały zdefiniowane:
![](https://manual.youlead.io/wp-content/uploads/2024/04/image-6.png)