Prise en main de l’extension de balises Web SDK
Utilisez Adobe Experience Platform balises (anciennement Launch) pour envoyer des données d’événement de votre site web aux solutions Edge Network et Adobe en aval.
Avant de suivre ces étapes, vérifiez que vous pouvez accéder aux droits de propriété suivants :
- Développer
- Gérer les extensions
Assurez-vous également de disposer de toutes les autorisations dans les catégories suivantes :
- Modélisation des données
- Identités
Créer un schéma XDM schema
Le modèle de données d’expérience (XDM) est une spécification open source qui fournit des structures et des définitions communes pour les données sous la forme de schémas. La configuration d’un schéma est vivement recommandée lors de l’envoi de données à Edge Network.
- Connectez-vous à CX Enterprise à l’aide de vos informations d’identification Adobe ID.
- Accédez à Collecte de données > Schémas.
- Sélectionnez Créer un schéma.
- Sélectionnez Événement d’expérience, puis sélectionnez Suivant.
- Attribuez un nom au schéma, puis sélectionnez Terminer.
- (Facultatif) Vous pouvez ajouter d’autres champs ou groupes de champs pour toutes les données supplémentaires que vous souhaitez collecter.
Création dʼun flux de données datastream
Un flux de données est une configuration qui indique à Edge Network comment gérer les données que vous lui envoyez. Lorsque vous configurez un flux de données pour envoyer des données à un produit donné, le flux de données transmet automatiquement les données pertinentes à chaque produit respectif d’une manière que le produit spécifique comprend.
- Accédez à Collecte de données > Flux de données.
- Sélectionnez Nouveau flux de données.
- Attribuez au flux de données le nom souhaité, puis sélectionnez le schéma récemment créé sous Schéma de mappage.
- Sélectionnez Enregistrer.
Création d’une propriété de balise
Une fois que vous avez créé un schéma et un flux de données, vous pouvez créer et configurer une propriété de balise.
- Accédez à Collecte de données > Balises.
- Sélectionnez Nouvelle propriété.
- Attribuez un nom et un domaine à la propriété de balise, puis sélectionnez Enregistrer.
Installation de l’extension de balise
L’extension de balise Web SDK est installée sur une propriété de balise donnée.
- Accédez à Collecte de données > Balises > Extensions.
- Sélectionnez l’onglet Catalogue.
- Utilisez la recherche pour localiser l’extension Adobe Experience Platform Web SDK.
- Sélectionnez la carte d’extension, puis sélectionnez Installer à droite.
Configuration de l’extension de balise
Lorsque vous installez l’extension de balise Web SDK, vous accédez automatiquement à la page Configuration.
- Sous la section Flux de données, sélectionnez le flux de données de votre choix pour chaque environnement.
Tous les autres paramètres de configuration sont renseignés pour vous ou facultatifs. Définissez les paramètres de configuration souhaités, puis sélectionnez Enregistrer.
Créer un élément de données variable
Adobe recommande d’utiliser des éléments de données Variable pour stocker la payload que vous souhaitez envoyer à Adobe. Les objets XDM sont également des éléments de données disponibles, mais ils sont plus anciens et plus limités dans les cas d’utilisation applicables.
-
Accédez à Collecte de données > Balises.
-
Sélectionnez la propriété de balise de votre choix.
-
Sélectionnez Éléments de données > Créer un élément de données.
-
Attribuez à l’élément de données les propriétés suivantes sur la gauche :
- Name : tout nom souhaité
- Extension : Adobe Experience Platform Web SDK
- Type d’élément de données : Variable
-
Définissez les propriétés suivantes sur la droite :
Type de variable : XDM
Sandbox : sandbox dans lequel vous avez créé votre schéma
Schéma : schéma souhaité -
Sélectionnez Enregistrer.
Création d’une règle
Les règles déterminent à quel moment déclencher quelque chose ou définir des variables. La création d’une règle qui s’exécute chaque fois que la bibliothèque est chargée vous permet de renseigner facilement les variables que vous souhaitez voir contenir une valeur sur chaque page.
-
Accédez à Collecte de données > Balises.
-
Sélectionnez la propriété de balise de votre choix.
-
Sélectionnez Règles > Ajouter une règle.
-
Donnez un nom à la règle.
-
Sélectionnez l’icône «
+» en regard de Événements. -
Attribuez à l’événement les paramètres suivants :
- Extension : Core
- Type d’événement : Bibliothèque chargée (en haut de la page)
-
Sélectionnez Conserver les modifications.
Les étapes ci-dessus établissent la partie critères de la règle, qui doit se déclencher une fois la bibliothèque chargée. Les étapes suivantes définissent l’action à entreprendre lorsque ce critère est rempli.
-
Sélectionnez l’icône «
+» en regard de Actions. -
Définissez l’action sur les paramètres suivants à gauche :
- Extension : Adobe Experience Platform Web SDK
- Type d’action : Envoyer l’événement
-
Définissez les champs suivants sur la droite :
- XDM : élément de données de la variable XDM
-
Sélectionnez Conserver les modifications.
Publier
La propriété de balise contient tous les composants nécessaires pour envoyer des données à Edge Network.
- Accédez à Collecte de données > Flux de publication.
- Sélectionnez Ajouter une bibliothèque.
- Attribuez un nom à la bibliothèque. Ce nom doit être similaire à un nom de validation lorsque vous utilisez un logiciel de contrôle de version.
- Définissez le menu déroulant de l’environnement sur Développement.
- Sélectionnez Ajouter toutes les ressources modifiées.
- Sélectionnez Enregistrer et créer dans le développement.
Vos modifications sont maintenant déployées dans votre environnement de développement.
- Accédez à Collecte de données > Environnements.
- Sélectionnez l’icône d’installation en regard de l’environnement de développement
- Installez le code incorporé dans une page web de test sur votre site.
Une fois que vous avez vérifié que la balise fonctionne dans votre environnement de développement, vous pouvez utiliser l’interface Flux de publication pour publier la bibliothèque dans l’environnement d’évaluation, puis dans l’environnement de production.
- Ajoutez l’extension et la règle à une bibliothèque, créez-les dans un environnement et installez le code incorporé sur votre site.
- Validez avec .
Vous disposez désormais d’une configuration allégée qui capture les événements et les envoie à Edge Network. Vous pouvez désormais développer davantage votre implémentation en ajoutant des champs à votre schéma, en ajoutant des produits à un flux de données ou en ajoutant des éléments de données à votre propriété de balise.