Dodawanie kodu skryptu do stron witryny w celu obsługi telemetrii

Artykuł
07/26/2024

W tym artykule opisano sposób dodawania kodu skryptów po stronie klienta do stron witryny w celu obsługi zbierania danych telemetrycznych po stronie klienta.

Narzędzie Web Analytics jest podstawowym narzędziem, które umożliwia zrozumienie, w jaki sposób klienci współpracują z daną witryną, a następnie podejmujmowanie decyzji, które pozwolą zoptymalizować możliwości konwersji. Dostępnych jest wiele pakietów analiz sieci Web ułatwiających osiągnięcie tych celów, takich jak Google Analytics, Clicky, Moz Analytics, and KISSMetrics. Większość pakietów analiz sieci Web wymaga dodania kodu skryptu po stronie klienta w elemencie <head> kodu HTML na wszystkich stronach witryny.

Banknot

Instrukcje przedstawione w tym artykule dotyczą również innych niestandardowych funkcji po stronie klienta, które Microsoft Dynamics 365 Commerce nie oferuje w sposób macierzysty.

Tworzenie fragmentu wielokrotnego użytku dla kodu skryptu

Fragment umożliwia ponowne użycie wewnętrznego lub zewnętrznego kodu skryptu na wszystkich stronach w witrynie, niezależnie od szablonu, którego używają.

Tworzenie fragmentu wielokrotnego użytku dla wbudowanego kodu skryptu

Aby utworzyć fragment do ponownego użycia dla kodu skryptu wbudowanego w konstruktorze witryn, wykonaj następujące kroki.

Przejdź do obszaru Fragmenty, a następnie wybierz pozycję Nowy.
W oknie dialogowym Nowy fragment wybierz opcję Skrypt wbudowany.
W obszarze Nazwa fragmentu wprowadź nazwę fragmentu, a następnie kliknij przycisk OK.
Pod utworzonym fragmentem wybierz Domyślny moduł skryptu wbudowanego.
W okienku właściwości po prawej stronie, w obszarze Skrypt wbudowany, wprowadź skrypt po stronie klienta. Następnie skonfiguruj inne opcje stosownie do potrzeb.
Wybierz Zapisz i następnie wybierz Zakończ edycję.
Wybierz opcję Publikuj.

Tworzenie fragmentu wielokrotnego użytku dla zewnętrznego kodu skryptu

Aby utworzyć fragment do ponownego użycia dla kodu skryptu zewnętrznego w konstruktorze witryn, wykonaj następujące kroki.

Przejdź do obszaru Fragmenty, a następnie wybierz pozycję Nowy.
W oknie dialogowym Nowy fragment wybierz opcję Skrypt zewnętrzny.
W obszarze Nazwa fragmentu wprowadź nazwę fragmentu, a następnie kliknij przycisk OK.
Pod utworzonym fragmentem wybierz Domyślny moduł skryptu zewnętrznego.
W okienku właściwości po prawej stronie w obszarze Źródło skryptu dodaj zewnętrzny lub względny adres URL dla zewnętrznego źródła skryptów. Następnie skonfiguruj inne opcje stosownie do potrzeb.
Wybierz Zapisz i następnie wybierz Zakończ edycję.
Wybierz opcję Publikuj.

Banknot

Jeśli dla danej witryny jest włączona zasada zabezpieczeń zawartości (CSP), upewnij się, że wszystkie zewnętrzne adresy URL są dodane do dyrektywy script-src zasad CSP w module konstruktora witryn Commerce. Aby uzyskać więcej informacji, zajrzyj do Zarządzanie zasadami zabezpieczeń zawartości (CSP).

Dodawanie fragmentu zawierającego kod skryptu do szablonu

Aby dodać fragment zawierający kod skryptu do szablonu w kreatorze witryn, wykonaj następujące kroki.

Przejdź do Szablony i otwórz szablon stron, do których chcesz dodać kod skryptu.
W lewym okienku rozwiń hierarchię szablonów, aby wyświetlić gniazdo nagłówka HTML.
W gnieździe nagłówka HTML wybierz przycisk wielokropka (...), a następnie wybierz Dodaj fragment.
Umożliwia wybór fragmentu utworzonego dla kodu skryptu.
Wybierz Zapisz i następnie wybierz Zakończ edycję.
Wybierz opcję Publikuj.

Dodawanie skryptu zewnętrznego lub skryptu wbudowanego bezpośrednio do szablonu

Jeśli chcesz wstawić wewnętrzny lub zewnętrzny skrypt bezpośrednio do zbioru stron, które są kontrolowane przez jeden szablon, nie musisz najpierw utworzyć fragmentu.

Dodawanie skryptu wbudowanego bezpośrednio do szablonu

Aby dodać wbudowany skrypt bezpośrednio do szablonu w konstruktorze stron, należy wykonać następujące kroki.

Przejdź do Szablony i otwórz szablon stron, do których chcesz dodać kod skryptu.
W lewym okienku rozwiń hierarchię szablonów, aby wyświetlić gniazdo nagłówka HTML.
W gnieździe nagłówka HTML wybierz przycisk wielokropka (...), a następnie wybierz Dodaj moduł.
W oknie dialogowym Dodaj moduł wybierz opcję Skrypt wbudowany.
W okienku właściwości po prawej stronie, w obszarze Skrypt wbudowany, wprowadź skrypt po stronie klienta. Następnie skonfiguruj inne opcje stosownie do potrzeb.
Wybierz Zapisz i następnie wybierz Zakończ edycję.
Wybierz opcję Publikuj.

Dodawanie skryptu zewnętrznego bezpośrednio do szablonu

Aby dodać zewnętrzny skrypt bezpośrednio do szablonu w konstruktorze stron, należy wykonać następujące kroki.

Przejdź do Szablony i otwórz szablon stron, do których chcesz dodać kod skryptu.
W lewym okienku rozwiń hierarchię szablonów, aby wyświetlić gniazdo nagłówka HTML.
W gnieździe nagłówka HTML wybierz przycisk wielokropka (...), a następnie wybierz Dodaj moduł.
W oknie dialogowym Dodaj moduł wybierz opcję Skrypt zewnętrzny.
W okienku właściwości po prawej stronie w obszarze Źródło skryptu dodaj zewnętrzny lub względny adres URL dla zewnętrznego źródła skryptów. Następnie skonfiguruj inne opcje stosownie do potrzeb.
Wybierz Zapisz i następnie wybierz Zakończ edycję.
Wybierz opcję Publikuj.