Integracja zewnętrznych narzędzi i widgetów
Narzędzia analityczne, reklamowe, piksele śledzące oraz inne zewnętrzne widgety, dla których nie ma natywnej integracji w panelu administracyjnym IdoSell, można dodać do sklepu za pomocą funkcji Dodatki HTML/JS. Dzięki temu nie trzeba edytować maski ani szablonu sklepu - wystarczy wkleić kod dostarczony przez zewnętrzne narzędzie w odpowiednim miejscu konfiguracji dodatku.
Co znajdziesz w tym artykule?
jak wygląda ogólna konfiguracja zewnętrznych narzędzi przez Dodatki HTML/JS,
jak przygotować i wkleić kod widgetu opinii Ceneo,
jak przygotować i wkleić kod śledzący Microsoft Clarity,
jak przygotować i wkleić kod śledzący Hotjar.
Ogólna konfiguracja przez Dodatki HTML/JS
Większość zewnętrznych narzędzi analitycznych, reklamowych, pikseli śledzących i widgetów, które nie mają natywnej integracji w panelu administracyjnym IdoSell, można dodać do sklepu przez funkcję Dodatki HTML/JS. Ogólny schemat konfiguracji jest taki sam niezależnie od narzędzia - różni się przede wszystkim miejscem pobrania kodu oraz sposobem weryfikacji działania po stronie dostawcy usługi.
W panelu IdoSell przejdź do Sklep > Dodatki HTML/JS.
Dodaj kampanię i uzupełnij wymagane informacje.
Wróć do listy stron i wybierz opcję edytuj dodatki.
Wybierz opcję Nowy dodatek.
Uzupełnij tytuł dodatku.
Aktywuj dodatek, ustawiając wartość pola Aktywny na tak.
Zdefiniuj typ dodatku (więcej informacji znajdziesz w sekcji Typ dodatku i sposób ładowania)
Zdefiniuj, jak dodatek będzie się wczytywał na stronie (więcej informacji znajdziesz w sekcji Typ dodatku i sposób ładowania)
W polu Pokazuj zdecyduj, na jakich wersjach strony ma być prezentowany dodatek.
Zaznaczenie tak w polu Automatyczna kontrola i wyłączanie może wyłączyć dodatek, jeśli zewnętrzny skrypt, do którego odwołuje się konfiguracja, nie odpowiada albo odpowiada dłużej niż 2 sekundy trzy razy z rzędu. Chroni to sklep przed problemami z ładowaniem strony lub jej elementów. Jeśli dodatek zostanie automatycznie wyłączony, otrzymasz odpowiedni komunikat.
Wklej kod dostarczony przez zewnętrzne narzędzie w polu zawartości dodatku, korzystając z zakładki Edycja zaawansowana.
W polu miejsca wyświetlania wybierz Sekcja Head.
Zapisz zmiany.
Po zapisaniu zmian odczekaj na publikację dodatku. W zależności od konfiguracji i mechanizmu publikacji zmiany mogą być widoczne po pewnym czasie.
Typ dodatku i sposób ładowania
Przed zapisaniem dodatku wybierz jego typ oraz sposób ładowania. Decyzja zależy przede wszystkim od rodzaju kodu otrzymanego od dostawcy narzędzia oraz od tego, czy dodatek powinien działać od razu po wczytaniu strony, czy dopiero po jej pełnym załadowaniu i ewentualnej zgodzie użytkownika na określone typy cookies.
| Typ dodatku | Kiedy go użyć? | Na co uważać? |
|---|---|---|
| HTML | Wybierz ten typ w większości przypadków, zwłaszcza gdy kod integracji zawiera znaczniki HTML lub skrypt przekazany w formie kodu HTML. | Jeśli kod zawiera JavaScript, powinien mieć odpowiednie znaczniki skryptu <script>, o ile dostawca narzędzia przekazał go w takiej formie. |
| JS | Wybierz ten typ tylko wtedy, gdy wklejasz czysty kod JavaScript. | Nie wklejaj znaczników HTML (m.in. <script>). Ten typ dodatku dodaje je automatycznie. |
| CGI (Common Gateway Interface) | Użyj tylko w bardzo specyficznych przypadkach, gdy integracja wymaga odwołania do zewnętrznego skryptu CGI. | Nie wklejaj kodu. Podaj link do skryptu, który ma zostać wykonany na stronie. |
Wczytywanie dodatku na stronie
Ładowanie razem z treścią strony oznacza, że kod dodatku generuje się razem z kodem strony. Dzięki temu ładuje się szybciej i jest widoczny w strukturze strony w narzędziach developerskich przeglądarki. To dobre rozwiązanie dla kodu, który ma działać od początku, na przykład dla stylów CSS lub elementów wymaganych już podczas pierwszego renderowania strony.
Ładowanie przez AJAX, po załadowaniu strony oznacza, że dodatek uruchamia się dopiero po pełnym wczytaniu strony. Ten tryb jest zalecany dla dodatków analitycznych, reklamowych, pikseli śledzących oraz innych narzędzi, które zbierają lub przekazują dane o użytkowniku. Pozwala powiązać dodatek z odpowiednimi cookies, dzięki czemu kod może czekać na zgodę użytkownika i nie uruchomi się, jeśli użytkownik nie zaakceptuje danego typu cookies. Kod takiego dodatku nie jest widoczny bezpośrednio w kodzie strony, ale można go sprawdzić w narzędziach developerskich, na przykład w zakładkach Network lub Sources.
Integracja widgetu opinii Ceneo
Widget opinii Ceneo pozwala wyświetlać w sklepie informacje i opinie pochodzące z Ceneo. Kod widgetu znajdziesz w panelu Ceneo w sekcji Widget > Instalacja i konfiguracja, a następnie możesz wkleić go w dodatku HTML/JS zgodnie z ogólną konfiguracją opisaną wyżej.
Jak sprawdzić, czy widget Ceneo działa poprawnie?
kod jest widoczny w źródle strony,
widget wyświetla się na stronie sklepu,
na stronie widoczne są aktualne opinie z Ceneo.
Integracja Microsoft Clarity
Microsoft Clarity służy do analizy zachowania użytkowników na stronie, między innymi przez nagrania sesji i mapy cieplne. Kod śledzący wygenerujesz zgodnie z instrukcją producenta: Konfiguracja Microsoft Clarity . Następnie wklej go w dodatku HTML/JS zgodnie z ogólną konfiguracją opisaną wyżej.
Jak sprawdzić, czy Microsoft Clarity działa poprawnie?
dodatek został zapisany bez błędów,
kod jest widoczny w źródle strony,
od publikacji minęło około 60 minut,
w panelu Microsoft Clarity pojawiają się pierwsze dane o ruchu.
Integracja Hotjar
Hotjar pomaga analizować zachowanie użytkowników na stronie, między innymi za pomocą map cieplnych, nagrań sesji i ankiet. Kod śledzący pobierzesz zgodnie z instrukcją producenta: Instrukcja instalacji Hotjar Tracking Code . Następnie wklej go w dodatku HTML/JS zgodnie z ogólną konfiguracją opisaną wyżej. Więcej o tym rozwiązaniu możesz przeczytać na naszym blogu .
Jak sprawdzić, czy Hotjar działa poprawnie?
dodatek został opublikowany,
status witryny w panelu Hotjar potwierdza aktywną instalację,
Hotjar wykrywa poprawnie zainstalowany kod,
w panelu Hotjar pojawiają się pierwsze dane analityczne.