Création de règles de balises
Découvrez comment envoyer des événements à Adobe Experience Platform Edge Network avec votre objet XDM à l’aide de règles de balises. Une règle de balise est une combinaison d’événements, de conditions et d’actions qui indique à la propriété de balise d’effectuer une opération. Avec Platform Web SDK, les règles sont utilisées pour envoyer des événements à Platform Edge Network avec les données appropriées.
Objectifs d’apprentissage
À la fin de cette leçon, vous êtes capable de :
- Utiliser une convention de nommage pour la gestion des règles dans les balises
- Envoyer un événement avec des champs XDM à l’aide des actions Mettre à jour la variable et Envoyer l’événement
- Empilement de plusieurs ensembles de champs XDM sur plusieurs règles
- Mappez des éléments de données de tableau individuels ou entiers à l’objet XDM.
- Publication d’une règle de balise dans une bibliothèque de développement
Conditions préalables
Vous connaissez les balises de la collecte de données et le site de démonstration Luma et avez terminé les leçons précédentes du tutoriel :
Conventions de dénomination
Pour gérer les règles dans les balises, il est recommandé de suivre une convention de dénomination standard. Ce tutoriel utilise une convention de nommage en cinq parties :
- [location] - [event] - [purpose] - [order]
où ;
- emplacement est la ou les pages du site sur lesquelles la règle se déclenche
- event est le déclencheur de la règle
- objectif est la principale action effectuée par la règle
- ordre est l’ordre dans lequel la règle doit se déclencher par rapport aux autres règles
Création de règles de balises
Dans les balises, les règles sont utilisées pour exécuter des actions (appels de déclenchement) sous diverses conditions. L’extension de balises de Platform Web SDK comprend deux actions qui sont utilisées dans cette leçon :
- Mettre à jour la variable mappe les éléments de données aux propriétés dans un objet XDM
- Envoyer l’événement envoie l’objet XDM à Experience Platform Edge Network
Dans la suite de cette leçon, nous avons :
-
Créez une règle avec l’action Mettre à jour la variable pour définir une « configuration globale » des champs XDM.
-
Créez des règles supplémentaires avec l’action Mettre à jour la variable qui remplacent notre « configuration globale » et contribuent à d’autres champs XDM sous certaines conditions (par exemple, en ajoutant des détails de produit sur les pages de produit).
-
Créez une autre règle avec l’action Envoyer l’événement qui enverra l’objet XDM complet à Adobe Experience Platform Edge Network.
Toutes ces règles seront correctement séquencées à l’aide de l’option « order ».
Cette vidéo donne un aperçu du processus :
Champs de configuration globale
Pour créer une règle de balise pour les champs XDM globaux :
-
Ouvrez la propriété de balise que vous utilisez pour ce tutoriel
-
Accédez à Règles dans le volet de navigation de gauche
-
Sélectionnez le bouton Créer une règle
-
Donnez à la règle le nom
all pages - library loaded - set global variables - 1
. -
Dans la section Événements, sélectionnez Ajouter
-
Utilisez l’extension Core et sélectionnez Bibliothèque chargée (haut de page) comme Type d’événement
-
Sélectionnez la liste déroulante Avancé et saisissez
1
comme Commande.note note NOTE Plus le numéro de commande est bas, plus tôt il s’exécute. Par conséquent, nous donnons à notre « configuration globale » un numéro d’ordre faible. -
Sélectionnez Conserver les modifications pour revenir à l’écran principal des règles
-
Dans la section Actions, sélectionnez Ajouter
-
Sélectionnez Adobe Experience Platform Web SDK en tant qu’extension ****
-
Sélectionnez Type d’action, puis Mettre à jour la variable
-
En tant que Élément de données, sélectionnez le
xdm.variable.content
que vous avez créé dans la leçon Créer des éléments de données
Mappez maintenant vos éléments de données au schéma utilisé par votre objet XDM. Vous pouvez mapper des propriétés individuelles ou des objets entiers. Dans cet exemple, vous mappez à des propriétés individuelles :
-
Recherchez le champ eventType et sélectionnez-le
-
Saisir la valeur
web.webpagedetails.pageViews
note tip TIP Pour comprendre les valeurs à renseigner dans le champ de eventType
, vous devez accéder à la page du schéma et sélectionner le champ deeventType
pour afficher les valeurs suggérées dans le rail de droite. Vous pouvez également saisir une nouvelle valeur, si nécessaire.
-
Recherchez ensuite l’objet
identityMap
dans le schéma et sélectionnez-le -
Mapper à l’élément de données
identityMap.loginID
note tip TIP Les champs XDM ne sont pas inclus dans la requête réseau si l’élément de données est null. Par conséquent, lorsque l’utilisateur n’est pas authentifié et que l’élément de données identityMap.loginID
est nul, l’objetidentityMap
n’est pas envoyé. C’est pourquoi nous pouvons le définir dans notre « configuration globale ». -
Faites défiler jusqu’à atteindre l’objet
web
-
Sélectionner pour l’ouvrir
-
Mappez les éléments de données suivants aux variables XDM
web
correspondantesweb.webPageDetials.name
à%page.pageInfo.pageName%
web.webPageDetials.server
à%page.pageInfo.server%
web.webPageDetials.siteSection
à%page.pageInfo.hierarchie1%
-
Définissez
web.webPageDetials.pageViews.value
sur1
.note tip TIP Bien que ni eventType
défini surweb.webpagedetails.pageViews
niweb.webPageDetails.pageViews.value
ne soient nécessaires pour qu’Adobe Analytics traite une balise en tant que page vue, il est utile de disposer d’une méthode standard pour indiquer une page vue pour d’autres applications en aval. -
Sélectionnez Conserver les modifications puis Enregistrer dans l’écran suivant pour terminer la création de la règle
Champs de la page Produit
Commencez à présent à utiliser Mettre à jour la variable dans des règles séquencées supplémentaires pour enrichir l’objet XDM avant de l’envoyer à Platform Edge Network.
Commencez par effectuer le suivi des consultations de produit sur la page des détails du produit de Luma :
-
Sélectionnez Ajouter une règle
-
Nommez-le
ecommerce - library loaded - set product details variables - 20
-
Sélectionnez le symbole
-
Sous Extension, sélectionnez Core
-
Sous Type d’événement, sélectionnez Bibliothèque chargée (haut de page)
-
Sélectionnez pour ouvrir Options avancées, puis saisissez
20
. Cette valeur d’ordre garantit que la règle s’exécute après laall pages - library loaded - set global variables - 1
qui définit la configuration globale. -
Sélectionnez Conserver les modifications
-
Sous Conditions, sélectionnez pour Ajouter
-
Laissez Type logique sur Standard
-
Laisser Extension comme Core
-
Sélectionnez Type de condition comme Chemin sans chaîne de requête
-
À droite, activez le bouton bascule Expression régulière
-
Sous chemin égal à définissez
/products/
. Pour le site de démonstration Luma, cela garantit que la règle ne se déclenche que sur les pages de produits -
Sélectionnez Conserver les modifications
-
Sous Actions sélectionnez Ajouter
-
Sélectionner l’extension Adobe Experience Platform Web SDK
-
Sélectionnez Type d’action comme Variable de mise à jour
-
Sélectionnez
xdm.variable.content
comme Élément de données -
Faites défiler l’écran jusqu’à l’objet
commerce
-
Ouvrez l’objet productViews et définissez value sur
1
note tip TIP La définition de commerce.productViews.value=1 dans XDM mappe automatiquement à l’événement prodView
dans Analytics -
Faites défiler jusqu’à
eventType
et définissez-le surcommerce.productViews
note note NOTE Comme cette règle présente un ordre supérieur, elle remplacera le jeu de eventType
défini dans la règle « Configuration globale ».eventType
ne peut contenir qu’une seule valeur et nous vous recommandons de la définir avec l’événement le plus important. -
Faites défiler jusqu’à et sélectionnez
productListItems
tableau -
Sélectionnez Fournir des éléments individuels
-
Sélectionnez Ajouter un élément
note caution CAUTION Le productListItems
est un type de donnéesarray
. Il s’attend donc à ce que les données soient transmises sous la forme d’une collection d’éléments. En raison de la structure de couche de données du site de démonstration Luma et du fait qu’il n’est possible d’afficher qu’un seul produit à la fois sur le site Luma, vous ajoutez des éléments individuellement. Lors de l’implémentation de sur votre propre site web, en fonction de la structure de votre couche de données, vous pouvez fournir un tableau entier. -
Sélectionner pour ouvrir Élément 1
-
Mapper des
productListItems.item1.SKU
à des%product.productInfo.sku%
-
Sélectionnez Conserver les modifications
-
Sélectionnez Enregistrer pour enregistrer la règle
Champs Panier
Vous pouvez mapper un tableau entier à un objet XDM, à condition que le tableau corresponde au format du schéma XDM. L’élément de données de code personnalisé cart.productInfo
vous avez créé précédemment effectue une boucle sur l’objet de couche de données digitalData.cart.cartEntries
sur Luma et le traduit au format requis de l’objet productListItems
du schéma XDM.
Pour illustrer cette situation, reportez-vous à la comparaison ci-dessous de la couche de données de site Luma (à gauche) avec l’élément de données traduit (à droite) :
Comparez l’élément de données à la structure productListItems
(conseil, il doit correspondre).
price
et qty
reformatées en nombres dans l’élément de données. Ces exigences de format sont importantes pour l’intégrité des données dans Platform et sont déterminées lors de l’étape configurer les schémas. Dans l’exemple, quantity utilise le type de données Integer.
Maintenant, mappons notre tableau à l’objet XDM :
-
Créez une règle nommée
ecommerce - library loaded - set shopping cart variables - 20
-
Sélectionnez le symbole
-
Sous Extension, sélectionnez Core
-
Sous Type d’événement, sélectionnez Bibliothèque chargée (haut de page)
-
Sélectionnez pour ouvrir Options avancées, puis saisissez
20
-
Sélectionnez Conserver les modifications
-
Sous Conditions, sélectionnez pour Ajouter
-
Laissez Type logique sur Standard
-
Laisser Extensions comme Core
-
Sélectionnez Type de condition comme Chemin sans chaîne de requête
-
À droite, ne pas activer activez le bouton bascule Expression régulière
-
Sous chemin égal à définissez
/content/luma/us/en/user/cart.html
. Pour le site de démonstration Luma, cela garantit que la règle ne se déclenche que sur la page du panier -
Sélectionnez Conserver les modifications
-
Sous Actions sélectionnez Ajouter
-
Sélectionner l’extension Adobe Experience Platform Web SDK
-
Sélectionnez Type d’action comme Variable de mise à jour
-
Sélectionnez
xdm.variable.content
comme Élément de données -
Faites défiler l’écran jusqu’à l’objet
commerce
et sélectionnez-le pour l’ouvrir. -
Ouvrez l’objet productListViews et définissez value sur
1
note tip TIP La définition de commerce.productListViews.value=1 dans XDM mappe automatiquement à l’événement scView
dans Analytics -
Sélectionnez
eventType
et définissez surcommerce.productListViews
-
Faites défiler jusqu’à et sélectionnez le tableau productListItems
-
Sélectionnez Fournir un tableau entier
-
Mapper à
cart.productInfo
élément de données -
Sélectionnez Conserver les modifications
-
Sélectionnez Enregistrer pour enregistrer la règle
Créez deux autres règles pour le passage en caisse et l’achat selon le même modèle avec les différences ci-dessous :
Nom de la règle : ecommerce - library loaded - set checkout variables - 20
-
Condition : /content/luma/us/en/user/checkout.html
-
Définissez
eventType
surcommerce.checkouts
. -
Définissez
commerce.checkout.value
sur1
.note tip TIP Cela revient à définir scCheckout
événement dans Analytics
Nom de la règle : ecommerce - library loaded - set purchase variables - 20
-
Condition : /content/luma/us/en/user/checkout/order/thank-you.html
-
Définissez
eventType
surcommerce.purchases
. -
Définissez
commerce.purchases.value
sur1
.note tip TIP Cela revient à définir purchase
événement dans Analytics -
commerce.order.purchaseID
à l’élément de donnéescart.orderId
-
Définissez
commerce.order.currencyCode
sur la valeur codée en durUSD
note tip TIP Cela revient à définir des variables s.purchaseID
ets.currencyCode
dans Analytics -
Faites défiler jusqu’à et sélectionnez le tableau productListItems
-
Sélectionnez Fournir un tableau entier
-
Mapper à
cart.productInfo.purchase
élément de données -
Sélectionnez Conserver les modifications
-
Sélectionnez Enregistrer
Lorsque vous avez terminé, vous devriez voir les règles suivantes créées.
Règle d’événement d’envoi
Maintenant que vous avez défini les variables, vous pouvez créer la règle pour envoyer l’objet XDM complet à Platform Edge Network avec l’action Envoyer l’événement.
-
Sur la droite, sélectionnez Ajouter une règle pour créer une autre règle
-
Donnez à la règle le nom
all pages - library loaded - send event - 50
. -
Dans la section Événements, sélectionnez Ajouter
-
Utilisez l’extension Core et sélectionnez
Library Loaded (Page Top)
comme type d’événement. -
Sélectionnez la liste déroulante Avancé et saisissez
50
dans Ordre. Cela permet de s’assurer que cette règle se déclenche après toutes les autres règles que vous avez configurées (dont le Ordre était1
ou20
). -
Sélectionnez Conserver les modifications pour revenir à l’écran principal des règles
-
Dans la section Actions, sélectionnez Ajouter
-
Sélectionnez Adobe Experience Platform Web SDK en tant qu’extension ****
-
Sélectionnez Type d’action, Envoyer l’événement
-
En tant que XDM, sélectionnez l’élément de données
xdm.variable.content
créé dans la leçon précédente -
Sélectionnez Conserver les modifications pour revenir à l’écran principal des règles
-
Sélectionnez Enregistrer pour enregistrer la règle
Publication des règles dans une bibliothèque
Publiez ensuite la règle dans votre environnement de développement afin de vérifier qu’elle fonctionne.
Pour créer une bibliothèque, procédez comme suit :
-
Accédez à Flux de publication dans le volet de navigation de gauche
-
Sélectionnez Ajouter une bibliothèque
-
Pour le Nom, saisissez
Luma Web SDK Tutorial
-
Pour le Environnement, sélectionnez
Development
-
Sélectionnez Ajouter toutes les ressources modifiées
note note NOTE Vous devriez voir tous les composants de balise créés dans les leçons précédentes. L’extension Core contient le JavaScript de base requis par toutes les propriétés de balise web. -
Sélectionnez Enregistrer et créer pour le développement
La création de la bibliothèque peut prendre quelques minutes et, lorsqu’elle est terminée, un point vert s’affiche à gauche du nom de la bibliothèque :
Comme vous pouvez le voir dans l’écran Flux de publication, le processus de publication ne se limite pas au contenu de ce tutoriel. Ce tutoriel utilise uniquement une bibliothèque dans votre environnement de développement.
Vous êtes maintenant prêt à valider les données de la requête à l’aide d’Adobe Experience Platform Debugger.