produits
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.
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.Produits utilisant le SDK Web
Si vous utilisez l’ objet XDM, les produits sont mappés aux variables suivantes :
- La catégorie est mappée à
xdm.productListItems[].productCategories[].categoryID. Il utilise le premier élément du tableauproductCategories[].lineItemIdmappe également correctement, mais Adobe recommandecategoryID, car il s’agit d’un XDM standard. Si les deux champs XDM sont présents,lineItemIdest prioritaire. - Le produit est mappé sur
xdm.productListItems[].SKUouxdm.productListItems[].name. Si les deux champs XDM sont présents,xdm.productListItems[].SKUest utilisé. - La quantité est mappée à
xdm.productListItems[].quantity. - Le prix est mappé sur
xdm.productListItems[].priceTotal. - Les eVars de marchandisage sont mappées sur
xdm.productListItems._experience.analytics.customDimensions.eVars.eVar1àxdm.productListItems._experience.analytics.customDimensions.eVars.eVar250, selon l’eVar que vous souhaitez lier à un produit. - Les événements de marchandisage sont mappés sur
xdm.productListItems[]._experience.analytics.event1to100.event1.valueàxdm.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 chaîne event envoyée à Adobe Analytics.
{
"xdm": {
"productListItems": [{
"productCategories": [{
"categoryID": "Men's"
}],
"name": "Hiking boot",
"quantity": 1,
"priceTotal": 49.99
},
{
"productCategories": [{
"categoryID": "Camping"
}],
"name": "Hunting blind",
"quantity": 3,
"priceTotal": 699.69
}]
}
}
Si vous utilisez l’ objet de données, la variable products utilise data.__adobe.analytics.products selon la syntaxe de l’AppMeasurement. Si vous définissez ce champ, tous les produits définis dans l’objet XDM sont remplacés et ne sont pas envoyés à Adobe Analytics.
{
"data": {
"__adobe": {
"analytics": {
"products": "Archery;Fletched arrow;12;159.99"
}
}
}
}
Produits utilisant l’extension Adobe Analytics
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.
- 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 Extensions, puis cliquez sur Catalogue pour afficher toutes les extensions disponibles.
- Recherchez le terme « produit », qui révèle plusieurs extensions disponibles pour aider à définir cette variable.
Vous pouvez utiliser l’une de ces extensions ou l’éditeur de code personnalisé en respectant la syntaxe AppMeasurement ci-dessous.
s.products dans AppMeasurement et l’éditeur de code personnalisé de l’extension Analytics
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.
- Catégorie (facultatif) : catégorie de produits. La longueur maximale de ce champ est de 100 octets.
- Nom du produit (obligatoire) : nom du produit. La longueur maximale de ce champ est de 100 octets.
- Quantité (facultatif) : quantité de ce produit dans le panier ? Ce champ s’applique uniquement aux accès avec l’événement d’achat.
- Prix (facultatif) : prix total du produit sous forme de décimale. Si la quantité est supérieure à un, définissez le prix sur le total et non sur le prix du produit individuel. Alignez la devise de cette valeur pour qu’elle corresponde à la variable
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. - Événements (facultatif) : événements liés au produit. Délimitez plusieurs événements à l’aide d’une barre verticale (
|). Voir Événements pour plus d’informations. - eVars (facultatif) : eVars de marchandisage liées au produit. Délimitez plusieurs eVars de marchandisage à l’aide d’une barre verticale (
|). 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. La longueur maximale de la chaîne products est de 64 Ko. 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";
Exemples
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 += ",";
}
}