events
Les dimensions et les mesures sont des composants essentiels des rapports. La variable events
est responsable de la collecte de données de nombreuses mesures sur votre site. Les événements incrémentent généralement les mesures dans les rapports.
Avant d’implémenter des événements, veillez à les créer et à les configurer sous Événements de succès dans les paramètres de la suite de rapports. Si vous prévoyez d’utiliser des événements personnalisés dans les accès de suivi de liens, assurez-vous que linkTrackVars
et linkTrackEvents
sont correctement configurés.
Événements utilisant le SDK Web
Si vous utilisez l’ objet XDM, les événements personnalisés utilisent les champs XDM suivants :
- Les événements personnalisés 1 à 100 sont mappés à
xdm._experience.analytics.event1to100.event1
-xdm._experience.analytics.event1to100.event100
. - Les événements personnalisés 101 à 200 sont mappés à
xdm._experience.analytics.event101to200.event100
-xdm._experience.analytics.event101to200.event200
. - Ce modèle se répète tous les 100 événements sur
xdm._experience.analytics.event901to1000.event901
-xdm._experience.analytics.event901to1000.event1000
.eventx.value
est utilisé pour spécifier le montant à incrémenter.eventx.id
est utilisé pour la sérialisation. - Les commandes sont mappées à
xdm.commerce.purchases.value
. - Les unités sont mappées à la somme de tous les champs
productListItems[].quantity
. - Le chiffre d’affaires est mappé à la somme de tous les champs
productListItems[].priceTotal
. - Les consultations de produits sont mappées à
xdm.commerce.productViews.value
. - Les paniers sont mappés à
xdm.commerce.productListOpens.value
. - Les ajouts au panier sont mappés à
xdm.commerce.productListAdds.value
. - Les retraits du panier sont mappés à
xdm.commerce.productListRemovals.value
. - Les consultations du panier sont mappées à
xdm.commerce.productListViews.value
. - Les passages en caisse sont mappés à
xdm.commerce.checkouts.value
.
productListItems
(par exemple, productListItems._experience.analytics.event1.value
) et que cet événement ne figure pas encore dans ce champ, il est automatiquement ajouté à ce champ.Si vous utilisez l’ objet de données, tous les événements utilisent data.__adobe.analytics.events
, selon la syntaxe de chaîne d’AppMeasurement. Si vous définissez ce champ, tous les événements définis dans l’objet XDM sont remplacés et ne sont pas envoyés à Adobe Analytics.
Événements utilisant l’extension Adobe Analytics
Vous pouvez définir des événements lors de la configuration de l’extension Analytics (variables globales) ou sous des règles.
- Connectez-vous à la collecte de données Adobe Experience Platform à l’aide de vos identifiants Adobe ID.
- Cliquez sur la propriété de balise de votre choix.
- Accédez à l’onglet Règles, puis cliquez sur une règle (ou créez une règle).
- Sous Actions, cliquez sur une action existante Adobe Analytics - Définir des variables ou cliquez sur l’icône « + ».
- Définissez la liste déroulante Extension sur Adobe Analytics et le Type d’action sur Définir des variables.
- Recherchez la section Événements.
Plusieurs fonctionnalités sont disponibles :
- Liste déroulante qui vous permet de sélectionner l’événement à inclure.
- Champ de texte facultatif pour la sérialisation. Voir Sérialisation des événements pour plus d’informations.
- Champ de texte facultatif pour une valeur d’événement. Vous pouvez inclure une devise pour les événements de devise ou un entier pour les événements non monétaires afin de les incrémenter plusieurs fois. Par exemple, sélectionner
event1
dans la liste déroulante et inclure10
dans ce champ incrémenteevent1
de 10 dans les rapports. - Bouton permettant d’ajouter un autre événement. Vous pouvez ajouter autant d’événements que vous le souhaitez à une seule règle, dans la limite du raisonnable.
s.events dans AppMeasurement et l’éditeur de code personnalisé de l’extension Analytics
La variable s.events
est une chaîne qui contient une liste d’événements délimités par des virgules à inclure dans l’accès. La variable autorise jusqu’à 64 000 octets, ce qui permet d’autoriser autant d’événements qu’un accès le requiert. Les valeurs valides sont les suivantes :
event1
-event1000
: événements personnalisés, définissez la valeur souhaitée. Enregistrez la manière dont vous utilisez chaque événement dans le document de conception de solution de votre organisation. Le nombre d’événements disponibles dépend du contrat Analytics de votre organisation. La plupart des organisations utilisant des contrats non hérités disposent de 1 000 événements personnalisés. Contactez votre équipe de compte d’Adobe si vous ne savez pas combien d’événements personnalisés vous sont disponibles.purchase
: incrémente la mesure « Commandes » de 1 et prend les valeurs définies dans la variableproducts
pour calculer les « Unités » et les « Recettes ». Voir Événement d’achat pour en savoir plus.prodView
: incrémente la mesure « Consultations de produit ».scOpen
: incrémente la mesure « Paniers ».scAdd
: incrémente la mesure « Ajouts au panier ».scRemove
: incrémente la mesure « Retraits du panier ».scView
: incrémente la mesure « Consultations du panier ».scCheckout
: incrémente la mesure « Passages en caisse ».
// Set the events variable to a single value
s.events = "event1";
// Set the events variable to multiple values
s.events = "event1,event13,purchase";
Incrémenter plusieurs fois les événements de compteur
Vous pouvez comptabiliser plusieurs événements personnalisés, le cas échéant. Attribuez un entier à l’événement souhaité dans la chaîne. Les événements créés dans les paramètres de la suite de rapports sont des événements de compteur par défaut.
// Count event1 ten times
s.events = "event1=10";
// Count event1 twice and event2 once
s.events = "event1=2,event2";
Utiliser des événements de devise
Vous pouvez modifier un événement personnalisé pour utiliser une devise plutôt que des entiers. Les événements de devise sont automatiquement convertis en devise de la suite de rapports si la devise de la suite de rapports et la variable currencyCode
ne correspondent pas. Elles sont utiles pour calculer les frais d’expédition, les remises ou les remboursements. Vous pouvez définir des événements de devise dans la variable products
si vous souhaitez attribuer l’événement à ce produit uniquement.
Avant d’implémenter des événements de devise, veillez à configurer l’événement de votre choix sur « Devise » sous Événements de succès dans les paramètres de la suite de rapports.
// Send $9.99 USD in event1 using the events variable. Make sure the event type for event1 is Currency in Report suite settings
s.currencyCode = "USD";
s.events = "event1=9.99";
// Send $9.99 USD in event1 using the products variable. Make sure the event type for event1 is Currency in Report suite settings
s.currencyCode = "USD";
s.events = "event1";
s.products = "Example category;Example product;1;0;event1=9.99";
events
et la variable products
, la valeur monétaire dans events
est utilisée. Évitez de définir des valeurs de devise dans les variables events
et products
.Utiliser des événements numériques
Vous pouvez modifier un événement personnalisé en acceptant des valeurs décimales au lieu d’entiers. Les événements numériques se comportent de la même manière que les événements de devise, sauf qu’ils n’utilisent pas la conversion de devise. Vous pouvez définir des événements numériques dans la variable products
si vous souhaitez attribuer l’événement à ce produit uniquement.
Avant d’implémenter des événements numériques, veillez à configurer l’événement de votre choix sur « Numérique » sous Événements de succès dans les paramètres de la suite de rapports.
// Send 4.5 in event1 using the events variable. Make sure the event type for event1 is Numeric in Report suite settings
s.events = "event1=4.5";
// Send 4.5 in event1 using the products variable. Make sure the event type for event1 is Numeric in Report suite settings
s.events = "event1";
s.products = "Example category;Example product;1;0;event1=4.5";
events
et la variable products
, la valeur numérique events
est utilisée. Évitez de définir des valeurs numériques dans les variables events
et products
.