Scriptcode toevoegen aan sitepagina's voor ondersteuning van telemetrie

Artikel
03/08/2023

In dit artikel wordt beschreven hoe u scriptcode op de client toevoegt aan de sitepagina's om de verzameling telemetrie aan clientzijde te ondersteunen.

Webanalyses zijn een essentieel hulpmiddel om inzicht te krijgen in de manier waarop uw klanten met uw site communiceren en om beslissingen te nemen die de ervaring voor een maximale conversie optimaliseren. Er zijn veel webanalysepakketten beschikbaar om u te helpen deze doelstellingen te verwezenlijken, zoals Google Analytics, Clicky, Moz Analytics en KISSMetrics. Voor de meeste webanalysepakketten moet u scriptcode op de client toevoegen in het element <head> van de HTML-code op uw sitepagina's.

Notitie

De instructies in dit artikel gelden ook voor andere aangepaste clientfunctionaliteit die Microsoft Dynamics 365 Commerce niet zelf aanbiedt.

Een herbruikbaar fragment maken voor uw scriptcode

Met een fragment kunt u inline of externe scriptcode opnieuw gebruiken voor alle pagina's van uw site, ongeacht de sjabloon die ze gebruiken.

Een herbruikbaar fragment maken voor uw inline scriptcode

Voer de volgende stappen uit om een herbruikbaar fragment te maken voor de inline scriptcode in Site Builder.

Ga naar Fragmenten en selecteer Nieuw.
Selecteer Inline script in het dialoogvenster Nieuw fragment.
Voer onder Naam fragment een naam in voor het fragment en selecteer OK.
Selecteer onder het fragment dat u hebt gemaakt de module Standaard inline script.
Voer in het eigenschappenvenster rechts onder Inline script uw script op de client in. Configureer vervolgens de overige opties naar wens.
Selecteer Opslaan en vervolgens Bewerken voltooien.
Selecteer Publiceren.

Een herbruikbaar fragment maken voor uw externe scriptcode

Voer de volgende stappen uit om een herbruikbaar fragment te maken voor de externe scriptcode in Site Builder.

Ga naar Fragmenten en selecteer Nieuw.
Selecteer Extern script in het dialoogvenster Nieuw fragment.
Voer onder Naam fragment een naam in voor het fragment en selecteer OK.
Selecteer onder het fragment dat u hebt gemaakt de module Standaard extern script.
Voeg in het eigenschappenvenster aan de rechterkant onder Scriptbron een externe of relatieve URL toe voor de externe scriptbron. Configureer vervolgens de overige opties naar wens.
Selecteer Opslaan en vervolgens Bewerken voltooien.
Selecteer Publiceren.

Notitie

Als CSP (Content Security Policy) is ingeschakeld voor uw site, moet u ervoor zorgen dat alle externe URL's worden toegevoegd aan de CSP-instructie script-src in Commerce Site Builder. Zie voor meer informatie Beveiligingsbeleid voor inhoud (CSP) beheren.

Een fragment met scriptcode aan een sjabloon toevoegen

Voer de volgende stappen uit om een fragment met scriptcode toe te voegen aan een sjabloon in Site Builder.

Ga naar Sjablonen en open de sjabloon voor de pagina's waaraan u de scriptcode wilt toevoegen.
Vouw in het linkerdeelvenster de sjabloonhiërarchie uit om het vak HTML-koptekst weer te geven.
Selecteer de knop met het weglatingsteken (...) in het vak HTML-koptekst en selecteer Fragment toevoegen.
Selecteer het fragment dat u voor de scriptcode hebt gemaakt.
Selecteer Opslaan en vervolgens Bewerken voltooien.
Selecteer Publiceren.

Een extern script of inline script rechtstreeks aan een sjabloon toevoegen

Als u een inline of extern script rechtstreeks wilt invoegen in een set pagina's die wordt aangestuurd door één sjabloon, hoeft u niet eerst een fragment te maken.

Een inline script rechtstreeks aan een sjabloon toevoegen

Voer de volgende stappen uit om een inline script rechtstreeks toe te voegen aan een sjabloon in Site builder.

Ga naar Sjablonen en open de sjabloon voor de pagina's waaraan u de scriptcode wilt toevoegen.
Vouw in het linkerdeelvenster de sjabloonhiërarchie uit om het vak HTML-koptekst weer te geven.
Selecteer de knop met het weglatingsteken (...) in het vak HTML-koptekst en selecteer Module toevoegen.
Selecteer Inline script in het dialoogvenster Module toevoegen.
Voer in het eigenschappenvenster rechts onder Inline script uw script op de client in. Configureer vervolgens de overige opties naar wens.
Selecteer Opslaan en vervolgens Bewerken voltooien.
Selecteer Publiceren.

Een extern script rechtstreeks aan een sjabloon toevoegen

Voer de volgende stappen uit om een extern script rechtstreeks toe te voegen aan een sjabloon in Site builder.

Ga naar Sjablonen en open de sjabloon voor de pagina's waaraan u de scriptcode wilt toevoegen.
Vouw in het linkerdeelvenster de sjabloonhiërarchie uit om het vak HTML-koptekst weer te geven.
Selecteer de knop met het weglatingsteken (...) in het vak HTML-koptekst en selecteer Module toevoegen.
Selecteer Extern script in het dialoogvenster Module toevoegen.
Voeg in het eigenschappenvenster aan de rechterkant onder Scriptbron een externe of relatieve URL toe voor de externe scriptbron. Configureer vervolgens de overige opties naar wens.
Selecteer Opslaan en vervolgens Bewerken voltooien.
Selecteer Publiceren.