DocumentationExperience PlatformBalises

Configuration de l’extension de balise du SDK Web

Last update: Wed Mar 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur

L’extension de balise Web SDK envoie des données à Adobe Experience Cloud à partir des propriétés web via Experience Platform Edge Network.

L’extension vous permet de diffuser des données dans Platform, de synchroniser les identités, de traiter les signaux de consentement des clients et de collecter automatiquement des données contextuelles.

Ce document explique comment configurer l’extension de balise dans l’interface utilisateur des balises.

Installation de l’extension de balise Web SDK install

L’extension de balise Web SDK nécessite l’installation d’une propriété sur . Si vous ne l’avez pas déjà fait, consultez la documentation sur la création d’une propriété de balise.

Après avoir créé une propriété, ouvrez-la et sélectionnez l’onglet Extensions dans la barre latérale gauche.

Sélectionnez l’onglet Catalogue. Dans la liste des extensions disponibles, recherchez l’extension Web SDK et sélectionnez Installer.

Image illustrant l’interface utilisateur Balises avec l’extension Web SDK sélectionnée

Après avoir sélectionné Installer, vous devez configurer l’extension de balise Web SDK et enregistrer la configuration.

NOTE
L’extension de balise n’est installée qu’après avoir enregistré la configuration. Consultez les sections suivantes pour savoir comment configurer l’extension de balise.

Création d’une version de Web SDK personnalisée custom-build

La bibliothèque Web SDK comprend plusieurs modules pour différentes fonctionnalités telles que la personnalisation, l’identité, le suivi des liens, etc. Selon vos cas d’utilisation, il se peut que vous n’ayez besoin que de fonctionnalités spécifiques au lieu de l’ensemble de la bibliothèque. La création d’une version Web SDK personnalisée vous permet de sélectionner uniquement les modules dont vous avez besoin, ce qui réduit la taille de la bibliothèque et améliore les performances.

Lorsque vous créez une version de Web SDK personnalisée, elle est utilisée par toutes vos instances de Web SDK.

IMPORTANT
La désactivation des composants Web SDK peut interrompre votre implémentation existante. Chaque fois que vous désactivez un composant, veillez à tester minutieusement votre implémentation pour vous assurer que toutes les fonctionnalités dont vous avez besoin fonctionnent comme prévu.
Lorsque vous désactivez un composant, vous ne pouvez plus modifier les paramètres de ce composant.

Pour créer une version Web SDK personnalisée à l’aide de l’extension de balise Web SDK, procédez comme suit.

  1. Sur la page de configuration de l’extension de balise, développez la section Composants de version personnalisés.

  2. Activez ou désactivez les composants en fonction de vos besoins. Vous pouvez sélectionner l’un des composants suivants :

    • Collecteur d’activités : ce composant permet la collecte automatique de liens et le suivi d’Activity Map.

    • Audiences : ce composant permet l’intégration d’Audience Manager, y compris les destinations d’URL et basées sur des cookies, ainsi que la synchronisation des identifiants.

    • Consentement : ce composant permet les intégrations de consentement. La désactivation de ce composant désactive les éléments suivants :

    • Context : ce composant permet la collecte automatique des données contextuelles.

    • Fusion d’événements : obsolète. La désactivation de ce composant désactive les éléments suivants :

    • Pont Media Analytics : ce composant active Edge Network Streaming Media à l’aide de l’interface Media Analytics. La désactivation de ce composant désactive les éléments suivants :

    • Personalization : ce composant active les intégrations Adobe Target et Adobe Journey Optimizer. La désactivation de ce composant désactive les éléments suivants :

    • Moteur de règles : ce composant active la prise de décision Adobe Journey Optimizer sur l’appareil. La désactivation de ce composant désactive les éléments suivants :

    • Streaming Media : ce composant active le streaming multimédia Edge Network. La désactivation de ce composant désactive les éléments suivants :

Configuration des paramètres d’instance general

Les options de configuration en haut de la page indiquent à Adobe Experience Platform où acheminer les données et les configurations à utiliser sur le serveur.

Image montrant les paramètres généraux de l’extension de balise Web SDK dans l’interface utilisateur des balises

  • Name : l’extension Adobe Experience Platform Web SDK prend en charge plusieurs instances sur la page. Le nom est utilisé pour envoyer des données à plusieurs organisations avec une configuration de balises. Le nom d’instance par défaut est alloy. Cependant, vous pouvez remplacer le nom de l’instance par n’importe quel nom d’objet JavaScript valide.
  • Identifiant de l’organisation IMS : l’identifiant de l’organisation à laquelle vous souhaitez que les données soient envoyées chez Adobe. La plupart du temps, utilisez la valeur par défaut qui est automatiquement renseignée. Lorsque la page comporte plusieurs instances, renseignez ce champ avec la valeur de la deuxième organisation à laquelle vous souhaitez envoyer des données.
  • domaine Edge : domaine vers lequel/à partir duquel l’extension envoie et reçoit des données. Adobe recommande d’utiliser un domaine propriétaire (CNAME) pour cette extension. Le domaine tiers par défaut fonctionne pour les environnements de développement, mais ne convient pas aux environnements de production. Les instructions de configuration d’un CNAME propriétaire sont répertoriées ici.

Configurer les paramètres du flux de données datastreams

Cette section vous permet de sélectionner les flux de données à utiliser pour chacun des trois environnements disponibles (production, évaluation et développement).

Lorsqu’une requête est envoyée à Edge Network, un identifiant de flux de données est utilisé pour référencer la configuration côté serveur. Vous pouvez mettre à jour la configuration sans avoir à apporter de modifications de code sur votre site web.

Consultez le guide sur les flux de données pour savoir comment configurer un flux de données.

Vous pouvez choisir un flux de données dans les menus déroulants disponibles ou sélectionner Saisir des valeurs et saisir un identifiant de flux de données personnalisé pour chaque environnement.

Image montrant les paramètres de train de données de l’extension de balise Web SDK dans l’interface utilisateur des balises

Configurer les paramètres de confidentialité privacy

Cette section vous permet de configurer la manière dont Web SDK gère les signaux de consentement des utilisateurs de votre site web. Plus précisément, il vous permet de sélectionner le niveau de consentement par défaut supposé d’un utilisateur si aucune autre préférence de consentement explicite n’a été fournie.

Le niveau de consentement par défaut n’est pas enregistré dans le profil utilisateur.

Image montrant les paramètres de confidentialité de l’extension de balise Web SDK dans l’interface utilisateur des balises

Niveau de consentement par défaut
Description
In
Collectez les événements qui se produisent avant que l’utilisateur ne fournisse des préférences de consentement.
Sortie
Ignorer les événements qui se produisent avant que l’utilisateur ne fournisse des préférences de consentement.
En attente
Événements de file d’attente qui se produisent avant que l’utilisateur ne fournisse des préférences de consentement. Lorsque des préférences de consentement sont fournies, les événements sont collectés ou ignorés selon les préférences fournies.
Fourni par l’élément de données
Le niveau de consentement par défaut est déterminé par un élément de données distinct que vous définissez. Lorsque vous utilisez cette option, vous devez spécifier l’élément de données à l’aide du menu déroulant fourni.
TIP
Utilisez Sortant ou En attente si vous avez besoin du consentement explicite de l’utilisateur pour vos opérations commerciales.

Configurer les paramètres d’identité identity

Cette section vous permet de définir le comportement du SDK web en ce qui concerne la gestion de l’identification des utilisateurs.

Image montrant les paramètres d’identité de l’extension de balise Web SDK dans l’interface utilisateur des balises

  • Migrer l’ECID depuis l’API Visiteur : cette option est activée par défaut. Lorsque cette fonction est activée, le SDK peut lire les cookies AMCV et s_ecid et définir le cookie AMCV utilisé par Visitor.js. Cette fonctionnalité est importante lors de la migration vers Web SDK, car certaines pages peuvent encore utiliser Visitor.js. Cette option permet au SDK de continuer à utiliser le même ECID, de sorte que les utilisateurs ne soient pas identifiés comme deux utilisateurs distincts.

  • Utiliser des cookies tiers : lorsque cette option est activée, Web SDK tente de stocker un identifiant utilisateur dans un cookie tiers. En cas de réussite, l’utilisateur est identifié comme un seul utilisateur lorsqu’il navigue sur plusieurs domaines, plutôt que comme un utilisateur distinct sur chaque domaine. Si cette option est activée, il se peut que le SDK ne puisse pas stocker l’identifiant de l’utilisateur dans un cookie tiers si le navigateur ne prend pas en charge les cookies tiers ou s’il a été configuré par l’utilisateur pour ne pas autoriser les cookies tiers. Dans ce cas, le SDK stocke uniquement l’identifiant dans le domaine propriétaire.

    note important
    IMPORTANT
    ​>Les cookies tiers ne sont pas compatibles avec la fonctionnalité Identifiant d’appareil interne de Web SDK.

Vous pouvez utiliser des identifiants d’appareil propriétaires ou des cookies tiers, mais vous ne pouvez pas utiliser les deux fonctionnalités simultanément.

Configurer les paramètres de personnalisation personalization

Cette section vous permet de configurer la manière dont vous souhaitez masquer certaines parties d’une page lors du chargement du contenu personnalisé. Cela garantit que vos visiteurs ne voient que la page personnalisée.

Image montrant les paramètres de personnalisation de l’extension de balise Web SDK dans l’interface utilisateur des balises

  • Migration de Target d’at.js vers Web SDK : utilisez cette option pour permettre aux Web SDK de lire et d’écrire les mbox hérités et les cookies mboxEdgeCluster utilisés par les bibliothèques at.js 1.x ou 2.x. Cela vous permet de conserver le profil du visiteur lors du passage d’une page qui utilise Web SDK à une page qui utilise at.js 1.x ou des bibliothèques 2.x et vice versa.

Style de masquage préalable prehiding-style

L’éditeur de style de masquage préalable vous permet de définir des règles CSS personnalisées pour masquer des sections spécifiques d’une page. Lorsque la page est chargée, Web SDK utilise ce style pour masquer les sections à personnaliser, récupérer la personnalisation, puis annuler le masquage des sections de page personnalisées. Ainsi, vos visiteurs verront les pages déjà personnalisées, sans voir le processus de récupération de la personnalisation.

Fragment de code de masquage préalable prehiding-snippet

Le fragment de code de masquage préalable est utile lorsque la bibliothèque Web SDK est chargée de manière asynchrone. Dans ce cas, pour éviter le scintillement, il est recommandé de masquer le contenu avant le chargement de la bibliothèque Web SDK.

Pour utiliser le fragment de code de masquage préalable, copiez-le et collez-le dans l’élément <head> de votre page.

IMPORTANT
Lors de l’utilisation du fragment de code de masquage préalable, Adobe recommande d’utiliser la même règle de CSS que celle utilisée par le style de masquage préalable.

Configurer les paramètres de collecte de données data-collection

Gérez les paramètres de configuration de la collecte de données. Des paramètres similaires dans la bibliothèque JavaScript sont disponibles à l’aide de la commande configure.

Image montrant les paramètres de collecte de données de l’extension de balise Web SDK dans l’interface utilisateur des balises.

  • Activé avant le rappel d’envoi d’événement : fonction de rappel permettant d’évaluer et de modifier la payload envoyée à Adobe. Utilisez la variable content dans la fonction de rappel pour modifier la payload. Ce rappel est la balise équivalente à onBeforeEventSend dans la bibliothèque JavaScript.

  • Collecter les clics sur les liens internes : une case à cocher qui permet la collecte de données de suivi des liens internes à votre site ou propriété. Lorsque vous activez cette case à cocher, les options de regroupement d'événements s'affichent :

    • Aucun regroupement d’événements : les données de suivi des liens sont envoyées à Adobe dans des événements distincts. Les clics sur les liens envoyés dans des événements distincts peuvent accroître l’utilisation contractuelle des données envoyées à Adobe Experience Platform.
    • Regroupement des événements à l’aide de l’enregistrement de session : stockez les données de suivi des liens dans l’enregistrement de session jusqu’à l’événement de page suivant. Sur la page suivante, les données de suivi des liens stockées et les données des pages vues sont envoyées simultanément à Adobe. Adobe recommande d’activer ce paramètre lors du suivi des liens internes.
    • Regroupement d’événements à l’aide de l’objet local : stockez les données de suivi des liens dans un objet local jusqu’à l’événement de page suivant. Si un visiteur accède à une nouvelle page, les données de suivi des liens sont perdues. Ce paramètre est particulièrement utile dans le contexte des applications monopages.

  • Collecter les clics sur les liens externes : une case à cocher qui permet de collecter les liens externes.

  • Collecter les clics sur les liens de téléchargement : une case à cocher qui permet de collecter les liens de téléchargement.

  • Qualificateur de lien de téléchargement : expression régulière qui qualifie une URL de lien comme un lien de téléchargement.

  • Propriétés des clics de filtre : fonction de rappel permettant d’évaluer et de modifier les propriétés associées aux clics avant la collection. Cette fonction s’exécute avant le rappel d’envoi d’événement ​ On before ​.

  • Paramètres de contexte : collecte automatiquement les informations sur les visiteurs, qui renseignent des champs XDM spécifiques pour vous. Vous pouvez choisir Toutes les informations contextuelles par défaut ou Informations contextuelles spécifiques. Il s’agit de la balise équivalente à context dans la bibliothèque JavaScript.

    • Web : collecte des informations sur la page active.
    • Appareil : collecte des informations sur l’appareil de l’utilisateur.
    • Environnement : collecte des informations sur le navigateur de l’utilisateur.
    • Contexte d’emplacement : collecte des informations sur l’emplacement de l’utilisateur.
    • Indications agent-utilisateur à entropie élevée : collecte des informations plus détaillées sur l’appareil de l’utilisateur.
TIP
Le champ Activé avant l’envoi du clic sur le lien est un rappel obsolète qui n’est visible que pour les propriétés qui l’ont déjà configuré. Il s’agit de la balise équivalente à onBeforeLinkClickSend dans la bibliothèque JavaScript. Utilisez le rappel Filtrer les propriétés des clics pour filtrer ou ajuster les données de clics, ou utilisez le rappel Activé avant l’envoi de l’événement pour filtrer ou ajuster la payload globale envoyée à Adobe. Si les rappels Filtrer les propriétés des clics et Activer avant l’envoi du clic sur les liens sont définis, seul le rappel Filtrer les propriétés des clics s’exécute.

Configurer les paramètres de collecte de médias media-collection

La fonctionnalité de collecte de médias vous permet de collecter des données relatives aux sessions multimédia sur votre site web.

Les données collectées peuvent inclure des informations sur les lectures de médias, les pauses, les terminaisons et d’autres événements associés. Une fois collectées, vous pouvez envoyer ces données à Adobe Experience Platform et/ou Adobe Analytics pour générer des rapports. Cette fonctionnalité fournit une solution complète pour suivre et comprendre le comportement de consommation des médias sur votre site web.

Image montrant les paramètres de collection de médias de l’extension de balise Web SDK dans l’interface utilisateur des balises

  • Canal : nom du canal sur lequel la collecte de médias a lieu. Exemple : Video channel.
  • Nom du lecteur : nom du lecteur multimédia.
  • Version de l’application : version de l’application du lecteur multimédia.
  • Intervalle de ping principal : fréquence des ping pour le contenu principal, en secondes. La valeur par défaut est 10. Les valeurs peuvent aller de 10 à 50 secondes. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée lors de l’utilisation de sessions suivies automatiquement.
  • Intervalle des ping des annonces : fréquence des ping pour le contenu des annonces, en secondes. La valeur par défaut est 10. Les valeurs peuvent aller de 1 à 10 secondes. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée lors de l’utilisation de sessions suivies automatiquement

Configurer les remplacements de trains de données datastream-overrides

Les remplacements de trains de données vous permettent de définir des configurations supplémentaires pour vos trains de données, qui sont transmises au réseau Edge via le SDK Web.

Vous pouvez ainsi déclencher des comportements de trains de données différents de ceux par défaut, sans créer de train de données ni modifier vos paramètres existants.

Le remplacement de la configuration du train de données comporte deux étapes :

  1. Tout d’abord, vous devez définir vos remplacements de configuration de trains de données sur la page de configuration des trains de données.
  2. Ensuite, vous devez envoyer les remplacements à Edge Network par le biais d’une commande Web SDK ou à l’aide de l’extension de balise Web SDK.

Consultez la documentation sur les remplacements de configuration du train de données documentation sur les remplacements de configuration pour obtenir des instructions détaillées sur le remplacement des configurations de train de données.

Au lieu de transmettre les remplacements par le biais d’une commande Web SDK, vous pouvez les configurer dans l’écran d’extension de balise illustré ci-dessous.

IMPORTANT
Les remplacements de flux de données doivent être configurés pour chaque environnement. Les environnements de développement, d’évaluation et de production ont tous des remplacements distincts. Vous pouvez copier les paramètres entre eux à l’aide des options dédiées affichées dans l’écran ci-dessous.

Image montrant les remplacements de la configuration du train de données à l’aide de la page d’extension de balise Web SDK.

Par défaut, le remplacement de la configuration du train de données est désactivé. L’option Correspondre à la configuration du flux de données est sélectionnée par défaut.

L’interface utilisateur de l’extension de balise Web SDK affichant la configuration du flux de données remplace le paramètre par défaut.

Pour activer les remplacements de train de données dans l’extension de balise, sélectionnez Activé dans le menu déroulant.

L’interface utilisateur de l’extension de balise Web SDK affiche le paramètre Remplacements de la configuration des trains de données activés.

Après avoir activé les remplacements de la configuration du train de données, vous pouvez configurer les remplacements pour chaque service décrit ci-dessous.

Les paramètres de remplacement du flux de données ci-dessous remplacent toutes les configurations et règles de flux de données côté serveur pour l’environnement sélectionné.

Adobe Analytics analytics

Utilisez les paramètres de cette section pour remplacer le routage des données par le service Adobe Analytics.

Image de l’interface utilisateur de l’extension de balise Web SDK montrant les paramètres de remplacement du flux de données Adobe Analytics.

  • Activé / Désactivé : utilisez ce menu déroulant pour activer ou désactiver le routage des données vers le service Adobe Analytics.
  • Suites de rapports : identifiants des suites de rapports de destination dans Adobe Analytics. La valeur doit être une suite de rapports de remplacement préconfigurée (ou une liste de suites de rapports séparées par des virgules) de votre configuration de train de données. Ce paramètre remplace les suites de rapports principales.
  • Ajouter une suite de rapports : sélectionnez cette option pour ajouter des suites de rapports supplémentaires.

Adobe Audience Manager audience-manager

Utilisez les paramètres de cette section pour remplacer le routage des données par le service Adobe Audience Manager.

Image de l’interface utilisateur de l’extension de balise Web SDK montrant les paramètres de remplacement du flux de données Adobe Audience Manager.

  • Activé / Désactivé : utilisez ce menu déroulant pour activer ou désactiver le routage des données vers le service Adobe Audience Manager.
  • Conteneur de synchronisation des identifiants tiers : identifiant du conteneur de synchronisation des identifiants tiers de destination dans Audience Manager. La valeur doit être un conteneur secondaire préconfiguré de votre configuration de train de données et remplace le conteneur principal.

Adobe Experience Platform experience-platform

Utilisez les paramètres de cette section pour remplacer le routage des données par le service Adobe Experience Platform.

Image de l’interface utilisateur de l’extension de balise Web SDK montrant les paramètres de remplacement du flux de données Adobe Experience Platform.

  • Activé / Désactivé : utilisez ce menu déroulant pour activer ou désactiver le routage des données vers le service Adobe Experience Platform.
  • Jeu de données d’événement : identifiant du jeu de données d’événement de destination dans le Adobe Experience Platform. La valeur doit être un jeu de données secondaire préconfiguré de votre configuration de train de données.
  • Offer Decisioning : utilisez ce menu déroulant pour activer ou désactiver le routage des données vers le service Offer Decisioning.
  • Segmentation Edge : utilisez ce menu déroulant pour activer ou désactiver le routage des données vers le service Edge Segmentation.
  • Destinations Personalization : utilisez ce menu déroulant pour activer ou désactiver le routage des données vers les destinations de personnalisation.
  • Adobe Journey Optimizer : utilisez ce menu déroulant pour activer ou désactiver le routage des données vers le service Adobe Journey Optimizer.

Transfert d’événement côté serveur Adobe ssf

Utilisez les paramètres de cette section pour remplacer le routage des données par le service de transfert d’événement côté serveur d’Adobe.

Image de l’interface utilisateur de l’extension de balise Web SDK montrant les paramètres de remplacement du flux de données de transfert d’événement côté serveur Adobe.

  • Activé / Désactivé : utilisez ce menu déroulant pour activer ou désactiver le routage des données vers le service de transfert d’événement côté serveur d’Adobe.

Adobe Target target

Utilisez les paramètres de cette section pour remplacer le routage des données par le service Adobe Target.

Image de l’interface utilisateur de l’extension de balise Web SDK montrant les paramètres de remplacement du flux de données Adobe Target.

  • Activé / Désactivé : utilisez ce menu déroulant pour activer ou désactiver le routage des données vers le service Adobe Target.

Configurer les paramètres avancés

Utilisez le champ Chemin de base Edge si vous devez modifier le chemin de base utilisé pour interagir avec Edge Network. Cela ne devrait pas nécessiter de mise à jour, mais dans le cas où vous participez à une version bêta ou alpha, Adobe peut vous demander de modifier ce champ.

Image montrant les paramètres avancés à l’aide de la page d’extension de balise Web SDK.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743