Documentation Experience Platform Balises

Configuration de l’extension de balise du SDK Web

Last update: Thu Jul 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Développeur

La variable Web SDK l’extension de balise 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 création d’une propriété de balise.

Après avoir créé une propriété, ouvrez-la et sélectionnez l’option Extensions de la barre de gauche.

Sélectionnez la variable Catalogue . Recherchez le composant Web SDK extension et sélectionner Installer.

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

Après avoir sélectionné Installer, 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. Le nom de l’instance est défini par défaut sur 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 dans 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 la 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 Saisir des valeurs et saisissez un identifiant de flux de données personnalisé pour chaque environnement.

Image montrant les paramètres de flux 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

Dans

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

Utilisation Out ou En attente si vous avez besoin d’un 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 présentant les paramètres d’identité de l’extension de balise SDK Web dans l’interface utilisateur des balises

Migration de l’ECID depuis VisitorAPI: cette option est activée par défaut. Lorsque cette fonction est activée, le SDK peut lire la variable AMCV et s_ecid et définissez la variable AMCV cookie 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 la même ECID afin que les utilisateurs ne soient pas identifiés comme deux utilisateurs distincts.

Utilisation de 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 variable identifiant d’appareil propriétaire dans le 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

Migration de Target depuis at.js vers le SDK Web: utilisez cette option pour activer Web SDK pour lire et écrire l’héritage mbox et mboxEdgeCluster cookies utilisés par at.js 1.x ou 2.x bibliothèques. Vous pouvez ainsi conserver le profil du visiteur lors du passage d’une page qui utilise le SDK Web à une page qui utilise 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 le <head> de votre page.

IMPORTANT

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

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 de la bibliothèque JavaScript sont disponibles à l’aide de la variable configure .

Image présentant les paramètres de collecte de données de l’extension de balise 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 équivaut à la balise 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.
- Regroupement d’événements à l’aide du stockage 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.
- Regroupement d’événements à l’aide d’un objet local: stocke 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 active 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 qualifiant une URL de lien en tant que lien de téléchargement.
Filtrer les propriétés de clic: fonction de rappel permettant d’évaluer et de modifier les propriétés liées aux clics avant la collecte. Cette fonction s’exécute avant la fonction Activé avant le rappel d’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.
- Contexte de l’emplacement: collecte des informations sur l’emplacement de l’utilisateur.
- Conseils d’agent-utilisateur à forte entropie: collecte des informations plus détaillées sur l’appareil de l’utilisateur.

TIP

La variable Avant l’envoi du lien, cliquez sur 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 la variable Filtrer les propriétés de clic rappel pour filtrer ou ajuster les données de clics ou utiliser la fonction Activé avant le rappel d’envoi d’événement pour filtrer ou ajuster la payload globale envoyée à Adobe. Si la variable Filtrer les propriétés de clic rappel et Avant l’envoi du lien, cliquez sur sont définies, seule la fonction Filtrer les propriétés de clic 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 de 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 être comprises entre 10 to 50 secondes. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée lors de l’utilisation de la variable sessions suivies automatiquement.
Intervalle de ping publicitaire: fréquence des pings pour le contenu de la publicité, en secondes. La valeur par défaut est 10. Les valeurs peuvent être comprises entre 1 to 10 secondes. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée lors de l’utilisation de la variable 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 :

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.
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.

Voir la structure de données la documentation de remplacement de configuration pour obtenir des instructions détaillées sur la façon de remplacer les configurations datastream.

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 de la banque de données à l’aide de la page de l’extension de balise SDK Web.

Configuration des paramètres avancés

Utilisez la variable 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 à l’aide de la page de l’extension de balise SDK Web.

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743