Ajout d’un code de script aux pages de site pour prendre en charge la télémétrie

Article
03/08/2023

Cet article décrit comment ajouter un code du script côté client à vos pages du site pour prendre en charge la collection de télémétrie côté client.

Les analyses web sont un outil essentiel lorsque vous souhaitez inclure la manière dont vos clients peuvent interagir avec votre site et prendre des décisions qui aideront à optimiser l’expérience pour la conversion maximale. De nombreux packages d’analyses web sont disponibles pour vous aider à atteindre ces objectifs, comme Google Analytics, Clicky, Moz Analytics, et KISSMetrics. La plupart des packages d’analyses web nécessitent que vous ajoutiez un code du script côté client dans l’élément <head> du fichier HTML pour toutes les pages du site.

Note

Les instructions de cet article s’appliquent également à l’autre fonctionnalité côté client personnalisée que Microsoft Dynamics 365 Commerce n’offre pas en mode natif.

Créer un fragment réutilisable pour votre code de script

Un fragment vous permet de réutiliser un code de script externe ou en ligne sur toutes les pages de votre site, peu importe le modèle qu’elles utilisent.

Créer un fragment réutilisable pour votre code de script en ligne

Pour créer un fragment réutilisable pour votre code de script en ligne dans le générateur de site, procédez comme suit.

Accédez à Fragments, puis sélectionnez Nouveau.
Dans la boîte de dialogue Nouveau fragment, sélectionnez Script en ligne.
Sous Nom du fragment, entrez un nom pour le fragment, puis sélectionnez OK.
Sous le fragment que vous avez créé, sélectionnez le module Script en ligne par défaut.
Dans le volet des propriétés à droite, sous Script en ligne, entrez votre script côté client. Puis configurez d’autres options selon vos besoins.
Sélectionnez Enregistrer, puis Terminer la modification.
Sélectionnez Publier.

Créer un fragment réutilisable pour votre code de script externe

Pour créer un fragment réutilisable pour votre code de script externe dans le générateur de site, procédez comme suit :

Accédez à Fragments, puis sélectionnez Nouveau.
Dans la boîte de dialogue Nouveau fragment, sélectionnez Script externe.
Sous Nom du fragment, entrez un nom pour le fragment, puis sélectionnez OK.
Sous le fragment que vous avez créé, sélectionnez le module Script externe par défaut.
Dans le volet des propriétés à droite, sous Source du script, ajoutez une URL externe ou relative pour la source de script externe. Puis configurez d’autres options selon vos besoins.
Sélectionnez Enregistrer, puis Terminer la modification.
Cliquez sur Publier.

Note

Si la stratégie de stratégie de sécurité (CSP) est activée pour votre site, assurez-vous que toutes les URL externes sont ajoutées à l’instruction CSP script-src dans le générateur de site Commerce. Pour plus d’informations, voir Gérer la stratégie de sécurité du contenu (CSP).

Ajouter un fragment qui inclut le code de script à un modèle

Pour ajouter un fragment qui comprend un code de script à un modèle dans le générateur de site, procédez comme suit :

Accédez à Modèles, puis ouvrez le modèle pour les pages dans lesquelles vous souhaitez ajouter votre code de script.
Dans le volet gauche, développez la hiérarchie de modèle pour afficher l’emplacement En-tête HTML.
Dans l’emplacement En-tête HTML, sélectionnez le bouton représentant des points de suspension (…), puis Ajouter un fragment.
Sélectionnez le fragment créé pour votre code de script.
Sélectionnez Enregistrer, puis Terminer la modification.
Sélectionnez Publier.

Ajouter un script externe ou en ligne directement à un modèle

Si vous souhaitez insérer un script en ligne ou externe directement dans un ensemble de pages contrôlées par un seul modèle, vous n’avez pas à créer de fragment tout d’abord.

Ajouter un script en ligne directement à un modèle

Pour ajouter un script en ligne directement à un modèle dans le générateur de site, procédez comme suit.

Accédez à Modèles, puis ouvrez le modèle pour les pages dans lesquelles vous souhaitez ajouter votre code de script.
Dans le volet gauche, développez la hiérarchie de modèle pour afficher l’emplacement En-tête HTML.
Dans l’emplacement En-tête HTML, sélectionnez le bouton représentant des points de suspension (…), puis Ajouter un module.
Dans la boîte de dialogue Ajouter un module, sélectionnez Script en ligne.
Dans le volet des propriétés à droite, sous Script en ligne, entrez votre script côté client. Puis configurez d’autres options selon vos besoins.
Sélectionnez Enregistrer, puis Terminer la modification.
Sélectionnez Publier.

Ajouter un script externe directement à un modèle

Pour ajouter un script externe à un modèle dans le générateur de site, procédez comme suit.

Accédez à Modèles, puis ouvrez le modèle pour les pages dans lesquelles vous souhaitez ajouter votre code de script.
Dans le volet gauche, développez la hiérarchie de modèle pour afficher l’emplacement En-tête HTML.
Dans l’emplacement En-tête HTML, sélectionnez le bouton représentant des points de suspension (…), puis Ajouter un module.
Dans la boîte de dialogue Ajouter un module, sélectionnez Script externe.
Dans le volet des propriétés à droite, sous Source du script, ajoutez une URL externe ou relative pour la source de script externe. Puis configurez d’autres options selon vos besoins.
Sélectionnez Enregistrer, puis Terminer la modification.
Sélectionnez Publier.