produtos
A variável products rastreia produtos e propriedades associadas a eles. Normalmente, essa variável é definida em páginas de produto individuais, em páginas de carrinho de compras e em páginas de confirmação de compra. É uma variável de muitos valores, o que significa que você pode enviar vários produtos na mesma ocorrência e a Adobe analisa o valor e o divide em itens de dimensão separados.
events variável, a métrica Visualizações de produto será incrementada em 1. Defina os eventos apropriados em cada ocorrência com a variável products.Produtos que usam o SDK da Web
Se estiver usando o objeto XDM, os produtos serão mapeados para as seguintes variáveis:
- Categoria mapeada para
xdm.productListItems[].productCategories[].categoryID. Ele usa o primeiro item na matrizproductCategories[].lineItemIdtambém mapeia corretamente, mas o Adobe recomendacategoryID, pois é XDM padrão. Se ambos os campos XDM estiverem presentes,lineItemIdterá prioridade. - Produto mapeado para
xdm.productListItems[].SKUouxdm.productListItems[].name. Se ambos os campos XDM estiverem presentes,xdm.productListItems[].SKUserá usado. - A quantidade está mapeada para
xdm.productListItems[].quantity. - Preço mapeado para
xdm.productListItems[].priceTotal. - As eVars de merchandising são mapeadas de
xdm.productListItems._experience.analytics.customDimensions.eVars.eVar1axdm.productListItems._experience.analytics.customDimensions.eVars.eVar250, dependendo do eVar que você deseja vincular a um produto. - Os eventos de merchandising são mapeados de
xdm.productListItems[]._experience.analytics.event1to100.event1.valueaxdm.productListItems._experience.analytics.event901to1000.event1000.value, dependendo do evento que você deseja vincular a um produto. Se você definir um evento em um desses campos, ele será automaticamente incluído na sequência de caracteres event enviada ao 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
}]
}
}
Se estiver usando o objeto de dados, a variável products usará data.__adobe.analytics.products após a sintaxe do AppMeasurement. Se você definir esse campo, quaisquer produtos definidos no objeto XDM serão substituídos e não enviados para o Adobe Analytics.
{
"data": {
"__adobe": {
"analytics": {
"products": "Archery;Fletched arrow;12;159.99"
}
}
}
}
Produtos que usam a extensão Adobe Analytics
Não há um campo dedicado na Coleção de dados da Adobe Experience Platform para definir essa variável; no entanto, várias extensões de terceiros podem ajudar.
- Faça logon na Coleção de dados da Adobe Experience Platform usando suas credenciais da Adobe ID.
- Clique na propriedade de tag desejada.
- Vá até a guia Extensões e clique em Catálogo para ver todas as extensões disponíveis.
- Pesquise usando o termo "produto", que revela várias extensões disponíveis para ajudar a definir essa variável.
Você pode usar uma dessas extensões ou usar o editor de código personalizado abaixo, que está após a sintaxe do AppMeasurement.
s.products no AppMeasurement e no editor de código personalizado da extensão do Analytics
A variável s.products é uma string que contém vários campos delimitados por produto. Delimite cada campo com um ponto e vírgula (;) na sequência de caracteres.
- Categoria (opcional): a categoria do produto. O comprimento máximo deste campo é de 100 bytes.
- Nome do produto (obrigatório): o nome do produto. O comprimento máximo deste campo é de 100 bytes.
- Quantidade (opcional): a quantidade de produtos como esse que estão no carrinho. Esse campo se aplica somente às ocorrências com o evento de compra.
- Preço (opcional): o preço total do produto em formato decimal. Se a quantidade for superior a um, defina o preço total e não o preço individual do produto. Ajuste a moeda desse valor para corresponder ao da variável
currencyCode. Não inclua o símbolo da moeda nesse campo. Esse campo se aplica somente às ocorrências com o evento de compra. - Eventos (opcional): eventos vinculados ao produto. Delimite vários eventos usando uma barra vertical (
|). Consulte Eventos para obter mais informações. - eVars (opcional): eVars de merchandising ligadas ao produto. Delimite várias eVars de merchandising usando uma barra vertical (
|). Consulte eVar de merchandising para obter mais informações.
// 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";
Essa variável suporta vários produtos na mesma ocorrência. Ela é valiosa para carrinhos de compras e compras que contêm vários produtos. O comprimento máximo para toda a cadeia de caracteres products é de 64k bytes. Separe cada produto usando uma vírgula (,) na string.
// 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";
Exemplos
A variável products é flexível ao omitir campos e incluir vários produtos. Essa flexibilidade pode facilitar a perda de um delimitador, o que faz com que sua implementação envie dados incorretos para a Adobe.
// 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";
Se estiver usando a digitalData camada de dados, você poderá iterar através da matriz de objetos 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 += ",";
}
}