Documentation Analytics Guide de mise en œuvre

events

Dernière mise à jour : 18 juillet 2024

Rubriques :

Créé pour :

Administration
Développeur

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.

NOTE

Si un événement est défini sous 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 inclure 10 dans ce champ incrémente event1 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 variable products 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 ».

NOTE

Cette variable est sensible à la casse. Évitez de mettre en majuscules les valeurs d’événement de manière à garantir la collecte exacte des données.

// 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";

NOTE

Les événements de compteur ne prennent pas en charge les valeurs monétaires ou décimales. Utilisez des événements de devise pour la devise ou des événements numériques pour les valeurs décimales.

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";

NOTE

Si vous définissez une valeur monétaire dans la variable 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";

NOTE

Si vous définissez une valeur numérique dans la variable 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.

recommendation-more-help