La variable products
effectue le suivi des produits et des propriétés qui leur sont liées. Cette variable est généralement définie sur des pages de produit individuelles, des pages de panier d’achat et des pages de confirmation d’achat. Il s’agit d’une variable à plusieurs valeurs, ce qui signifie que vous pouvez envoyer plusieurs produits dans le même accès et qu’Adobe analyse la valeur dans des éléments de dimension distincts.
Si cette variable est définie dans un accès sans variable events
, la mesure Consultations produits est incrémentée de 1. Assurez-vous de définir les événements appropriés pour chaque accès avec la variable products
.
Les produits mappé pour Adobe Analytics sous plusieurs champs XDM :
productListItems[].productCategories[].categoryID
. Elle utilise le premier élément de la variable productCategories[]
tableau. lineItemId
mappe également correctement, mais nous vous recommandons categoryID
puisqu’il s’agit d’un XDM standard. Si les deux champs XDM sont présents lineItemId
a la priorité .productListItems[].SKU
ou productListItems[].name
. Si les deux champs XDM sont présents, productListItems[].SKU
est utilisée.productListItems[].quantity
.productListItems[].priceTotal
.productListItems._experience.analytics.customDimensions.eVars.eVar1
to productListItems._experience.analytics.customDimensions.eVars.eVar250
, selon l’eVar que vous souhaitez lier à un produit.productListItems[]._experience.analytics.event1to100.event1.value
to productListItems._experience.analytics.event901to1000.event1000.value
, selon l’événement que vous souhaitez lier à un produit. Si vous définissez un événement dans l’un de ces champs, il est automatiquement inclus dans la variable event chaîne envoyée à Adobe Analytics.lineItemId
doit être ajouté en tant que champ personnalisé, car il ne fait pas encore partie du schéma d’événement Analytics standard. Adobe prévoit d'ajouter un champ "Catégorie" dédié à l'avenir.
Il n’existe pas de champ dédié dans la collecte de données Adobe Experience Platform pour définir cette variable. Toutefois, plusieurs extensions tierces existent pour vous aider.
Vous pouvez utiliser l’une de ces extensions ou l’éditeur de code personnalisé en respectant la syntaxe AppMeasurement ci-dessous.
La variable s.products
est une chaîne qui contient plusieurs champs délimités par produit. Délimitez chaque champ par un point-virgule (;
) dans la chaîne.
currencyCode
. N’incluez pas le symbole de devise dans ce champ. Ce champ s’applique uniquement aux accès avec l’événement d’achat.|
). Voir Événements pour plus d’informations.|
). Voir eVars de marchandisage pour en savoir plus.// Set a single product using all available fields
s.products = "Example category;Example product;1;3.50;event1=4.99|event2=5.99;eVar1=Example merchandising value 1|eVar2=Example merchandising value 2";
Cette variable prend en charge plusieurs produits dans le même accès. Celle-ci est utile pour le panier et les achats contenant plusieurs produits. Longueur maximale pour l’ensemble products
string fait 64 000 octets. Séparez chaque produit par une virgule (,
) dans la chaîne.
// Set multiple products - useful for when a visitor views their shopping cart
s.products = "Example category 1;Example product 1;1;3.50,Example category 2;Example product 2;1;5.99";
Supprimez tous les points-virgules, virgules et tuyaux des noms de produits, des catégories et des valeurs d’eVar de marchandisage. Si un nom de produit comporte une virgule, AppMeasurement l’analyse comme le début d’un nouveau produit. Cette analyse incorrecte renvoie le reste de la chaîne du produit, provoquant des données incorrectes dans les dimensions et les rapports.
La variable products
est flexible lorsque vous omettez des champs et incluez plusieurs produits. Cette souplesse peut faciliter l’absence d’un délimiteur, ce qui entraîne l’envoi de données incorrectes à Adobe par votre mise en œuvre.
// Include only product and category. Common on individual product pages
s.products = "Example category;Example product";
// Include only product name
s.products = ";Example product";
// One product has a category, the other does not. Note the comma and adjacent semicolon to omit category
s.products = "Example category;Example product 1,;Example product 2";
// A visitor purchases a single product; record quantity and price
s.events = "purchase";
s.products = ";Example product;1;6.99";
// A visitor purchases multiple products with different quantities
s.events = "purchase";
s.products = ";Example product 1;9;26.91,Example category;Example product 2;4;9.96";
// Attribute currency event1 only to product 2 and not product 1
s.events = "event1";
s.products = ";Example product 1;1;1.99,Example category 2;Example product 2;1;2.69;event1=1.29";
// Use multiple numeric events in the product string
s.events = "event1,event2";
s.products = ";Example product;1;4.20;event1=2.3|event2=5";
// Use merchandising eVars without any events. Note the adjacent semicolons to skip events
s.products = ";Example product;1;6.69;;eVar1=Merchandising value";
// Use merchandising eVars without category, quantity, price, or events
s.products = ";Example product;;;;eVar1=Merchandising value";
// Multiple products using multiple different events and multiple different merchandising eVars
s.events = "event1,event2,event3,event4,purchase";
s.products = "Example category 1;Example product 1;3;12.60;event1=1.4|event2=9;eVar1=Merchandising value|eVar2=Another merchandising value,Example category 2;Example product 2;1;59.99;event3=6.99|event4=1;eVar3=Merchandising value 3|eVar4=Example value four";
Si vous utilisez la digitalData
couche de données, vous pouvez effectuer une itération dans le tableau d’objets digitalData.product
:
for(var i = 0; i < digitalData.product.length; i++) {
// Add individual product info to the product string
s.products += digitalData.product[i].category.primaryCategory + ";" + digitalData.product[i].productInfo.productName;
// If there are more products, add a comma
if(i != digitalData.product.length - 1) {
s.products += ",";
}
}