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 :
- Develop
- Manage 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 à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
- Accédez à Data Collection > Schemas.
- Sélectionnez Create schema.
- Sélectionnez Experience Event, puis sélectionnez Next.
- Attribuez un nom au schéma, puis sélectionnez Finish.
- (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 à Data Collection > Datastreams.
- Sélectionnez New datastream.
- Attribuez le nom souhaité au flux de données, puis sélectionnez le schéma récemment créé sous Mapping schema.
- Sélectionnez Save.
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 à Data Collection > Tags.
- Sélectionnez New property.
- Attribuez un nom et un domaine à la propriété de balise, puis sélectionnez Save.
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 à Data Collection > Tags > Extensions.
- Sélectionnez l’onglet Catalog .
- Utilisez la recherche pour localiser l’extension Adobe Experience Platform Web SDK.
- Sélectionnez la carte d’extension, puis sélectionnez Install à 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 Save.
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 à Data Collection > Tags.
-
Sélectionnez la propriété de balise de votre choix.
-
Sélectionnez Data elements > Create new data element.
-
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
- Data element type : 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
Schema : schéma souhaité -
Sélectionnez Save.
Créer 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 à Data Collection > Tags.
-
Sélectionnez la propriété de balise de votre choix.
-
Sélectionnez Rules > Add rule.
-
Donnez un nom à la règle.
-
Sélectionnez l’icône «
+» en regard de Events. -
Attribuez à l’événement les paramètres suivants :
- Extension : Core
- Event type : Library loaded (page top)
-
Sélectionnez Keep changes.
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
- Action type : Send event
-
Définissez les champs suivants sur la droite :
- XDM : élément de données de la variable XDM
-
Sélectionnez Keep changes.
Publier
La propriété de balise contient tous les composants nécessaires pour envoyer des données à Edge Network.
- Accédez à Data Collection > Publishing flow.
- Sélectionnez Add library.
- 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 Development.
- Sélectionnez Add all changed resources.
- Sélectionnez Save & build to Development.
Vos modifications sont maintenant déployées dans votre environnement de développement.
- Accédez à Data Collection > Environments.
- 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 Publishing flow pour publier la bibliothèque vers l’environnement d’évaluation, puis éventuellement vers 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 Adobe Experience Platform Debugger.
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.