Configuration de l’extension de balise du SDK Web

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

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

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

Installation de l’extension de balise du SDK Web install

Une propriété doit être installée sur l’extension de balise SDK Web. 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 sur la barre de gauche.

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

Image présentant l’interface utilisateur des balises avec l’extension SDK Web sélectionnée

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

NOTE
L’extension de balise n’est installée qu’après l’enregistrement de la configuration. Reportez-vous aux sections suivantes pour savoir comment configurer l’extension de balise.

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 quelles configurations utiliser sur le serveur.

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

  • Nom : l’extension SDK Web de Adobe Experience Platform prend en charge plusieurs instances sur la page. Le nom est utilisé pour envoyer des données à plusieurs organisations avec une configuration de balise. Par défaut, le nom de l’instance est alloy. Vous pouvez toutefois remplacer le nom de l’instance par n’importe quel nom d’objet JavaScript valide.
  • Identifiant de l’organisation IMS : identifiant de l’organisation à laquelle vous souhaitez envoyer les données à l’Adobe. La plupart du temps, utilisez la valeur par défaut qui est renseignée automatiquement. Si la page contient plusieurs instances, renseignez ce champ avec la valeur de la deuxième organisation à laquelle vous souhaitez envoyer des données.
  • Domaine Edge : domaine à 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.

Configuration des 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 demande est envoyée à l’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 au code sur votre site web.

Consultez le guide sur datastreams 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 Entrer les valeurs et saisir un identifiant de flux de données personnalisé pour chaque environnement.

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

Configuration des paramètres de confidentialité privacy

Cette section vous permet de configurer la manière dont le SDK Web traite 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 SDK Web 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 ses préférences de consentement.
Out
Ignorer les événements qui se produisent avant que l’utilisateur ne fournisse ses préférences de consentement.
En attente
Événements de file d’attente qui se produisent avant que l’utilisateur ne fournisse ses préférences de consentement. Lorsque les préférences de consentement sont fournies, les événements sont collectés ou ignorés en fonction des 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 Out ou Pending si vous avez besoin du consentement explicite de l’utilisateur pour vos activités commerciales.

Configuration des paramètres d’identité identity

Cette section vous permet de définir le comportement du SDK Web lorsqu’il s’agit de gérer l’identification des utilisateurs.

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

  • Migrer l’ECID depuis VisitorAPI : 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 le SDK Web, car certaines pages utilisent toujours Visitor.js. Cette option permet au SDK de continuer à utiliser le même ECID afin que les utilisateurs ne soient pas identifiés comme deux utilisateurs distincts.

  • Utiliser des cookies tiers : lorsque cette option est activée, le SDK Web tente de stocker un identifiant d’utilisateur dans un cookie tiers. En cas de réussite, l’utilisateur est identifié comme un utilisateur unique lorsqu’il navigue sur plusieurs domaines, plutôt que comme un utilisateur distinct sur chaque domaine. Si cette option est activée, le SDK peut toujours ne pas pouvoir 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é d’identifiant d’appareil propriétaire du SDK Web.

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.

Configuration des paramètres de personnalisation personalization

Cette section vous permet de configurer le mode de masquage de 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 SDK Web dans l’interface utilisateur des balises

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

Style de prémasquage prehiding-style

L’éditeur de style de prémasquage 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, le SDK Web utilise ce style pour masquer les sections à personnaliser, récupère la personnalisation, puis annule le masquage des sections de page personnalisées. Ainsi, vos visiteurs voient les pages déjà personnalisées, sans voir le processus de récupération de personnalisation.

Prémasquer le fragment de code prehiding-snippet

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

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 CSS que celle utilisée par le style de masquage préalable.

Configuration des paramètres de collecte de données data-collection

Gérer 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 présentant les paramètres de collecte de données de l’extension de balise du SDK Web 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 charge utile envoyée à Adobe. Utilisez la variable content dans la fonction de rappel pour modifier la charge utile. 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 des 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 à l’Adobe dans des événements distincts. Les clics sur les liens envoyés dans des événements distincts peuvent augmenter l’utilisation contractuelle des données envoyées à Adobe Experience Platform.
    • Groupement d’é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 de pages vues sont envoyées à Adobe en même temps. Adobe recommande d’activer ce paramètre lors du suivi des liens internes.
    • Groupement 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 plus bénéfique dans le contexte des applications d’une seule page.
  • Collecter les clics sur les liens externes : une case à cocher qui permet la collecte de liens externes.

  • Collecter les clics sur les liens de téléchargement : une case à cocher qui active la collecte des liens de téléchargement.

  • Qualificateur de lien de téléchargement : expression régulière qui qualifie une URL de lien en tant que lien de téléchargement.

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

  • Paramètres contextuels : collecte automatiquement les informations sur les visiteurs, ce qui renseigne 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.
    • Placer le contexte : collecte des informations sur l’emplacement de l’utilisateur.
    • Conseils de l’agent utilisateur à forte entropie : collecte des informations plus détaillées sur l’appareil de l’utilisateur.
TIP
Le champ Avant le clic sur les liens envoyer 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 de clic pour filtrer ou ajuster les données de clic, ou utilisez le rappel d’envoi d’événement pour filtrer ou ajuster la charge utile globale envoyée à Adobe. Si le rappel Filter click properties et le rappel On before link send sont définis tous les deux, seul le rappel Filter click properties s’exécute.

Configuration des paramètres de la collection multimédia media-collection

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

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

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

  • Canal : nom du canal sur lequel se produit la collecte de médias. 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 pings 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 de ping de publicité : fréquence des pings pour le contenu de la publicité, 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 à l’Edge Network soit par le biais d’une commande SDK Web, soit à l’aide de l’extension de balise SDK Web.

Pour obtenir des instructions détaillées sur la façon de remplacer les configurations du flux de données, reportez-vous à la documentation sur le remplacement de la documentation.

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

IMPORTANT
Les remplacements de flux de données doivent être configurés par 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 le remplacement de la configuration du flux de données à l’aide de la page d’extension de balise du SDK Web.

Configuration des paramètres avancés

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

Image présentant les paramètres avancés à laide de la page dextension de balise du SDK Web.

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