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 par le biais du réseau Edge 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 au réseau Edge, 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

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

  • Fonction de rappel: la fonction de rappel fournie dans l’extension est également appelée onBeforeEventSend function dans la bibliothèque. Cette fonction vous permet de modifier les événements de manière globale avant qu’ils ne soient envoyés au réseau Edge.
  • Activer la collecte de données de clic: le SDK Web peut automatiquement collecter des informations sur les clics sur les liens. Cette fonctionnalité est activée par défaut, mais elle peut être désactivée à l’aide de cette option. Les liens sont également étiquetés comme liens de téléchargement s’ils contiennent l’une des expressions de téléchargement répertoriées dans la variable Télécharger le qualificateur de lien textbox. Adobe vous fournit quelques qualificateurs de lien de téléchargement par défaut. Vous pouvez les modifier en fonction de vos besoins.
  • Données contextuelles collectées automatiquement: par défaut, le SDK Web collecte certaines données contextuelles concernant l’appareil, le web, l’environnement et le contexte de lieu. Si vous ne souhaitez pas que ces données soient collectées ou que certaines catégories de données soient uniquement collectées, sélectionnez Informations contextuelles spécifiques et sélectionnez les données à collecter. Voir context pour plus d’informations.

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 au réseau Edge par le biais d’une commande de SDK Web ou à l’aide de l’extension de balise du 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 de base Edge si vous devez modifier le chemin de base utilisé pour interagir avec le réseau Edge. 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