Configuration de l’extension de balise du SDK Web
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.
Après avoir sélectionné Installer, vous devez configurer l’extension de balise du SDK Web et enregistrer la configuration.
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.
- 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.
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.
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.
-
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
ets_ecid
et définissez la variableAMCV
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.
- 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
etmboxEdgeCluster
cookies utilisés par at.js1.x
ou2.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
ou2.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.
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
.
-
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 baliseonBeforeEventSend
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.
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.
- 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 entre10
to50
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 entre1
to10
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.
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.