productos

La variable products rastrea productos y propiedades vinculados a ellos. Esta variable se configura generalmente en páginas de productos individuales, páginas del carro de compras y páginas de confirmación de compra. Es una variable de varios valores, lo que significa que puede enviar varios productos en la misma visita y Adobe analiza el valor en elementos de dimensión independientes.

NOTA

Si esta variable se configura en una visita individual sin la variable events, la métrica Vistas del producto se incrementa en 1. Asegúrese de establecer los eventos correspondientes en cada visita con la variable products.

Productos que utilizan el SDK web

Los productos son asignado para Adobe Analytics en varios campos XDM:

  • La categoría está asignada a productListItems[].lineItemId.
  • El producto está asignado a productListItems[].name.
  • La cantidad está asignada productListItems[].quantity.
  • El precio está asignado a productListItems[].priceTotal.
  • Las eVars de comercialización están asignadas a productListItems._experience.analytics.customDimensions.eVars.eVar1 a productListItems._experience.analytics.customDimensions.eVars.eVar250, según el eVar que desee enlazar a un producto.
  • Los eventos de comercialización se asignan a productListItems[]._experience.analytics.event1to100.event1.value a productListItems._experience.analytics.event901to1000.event1000.value, según el evento que desee enlazar a un producto.
NOTA

lineItemId debe añadirse como campo personalizado, ya que no forma parte del esquema de eventos estándar de Analytics. En el futuro, agregaremos un campo "categoría" dedicado.

Productos que utilizan la extensión de Adobe Analytics

No hay un campo dedicado en la recopilación de datos de Adobe Experience Platform para establecer esta variable; sin embargo, existen varias extensiones de terceros que pueden ayudar.

  1. Iniciar sesión en Recopilación de datos de Adobe Experience Platform uso de sus credenciales de Adobe ID.
  2. Haga clic en la propiedad de etiquetas deseada.
  3. Vaya a la pestaña Extensiones y, a continuación, haga clic en Catálogo para ver todas las extensiones disponibles.
  4. Busque el término “product”, que revela varias extensiones disponibles para ayudarle a configurar esta variable.

Puede utilizar una de estas extensiones o puede utilizar el editor de código personalizado siguiendo la sintaxis de AppMeasurement a continuación.

s.products en AppMeasurement y el editor de código personalizado de la extensión de Analytics

La variable s.products es una cadena que contiene varios campos delimitados por producto. Delimite cada campo con un punto y coma (;) en la cadena.

  • Categoría (opcional): La categoría del producto. La longitud máxima de este campo es de 100 bytes.
  • Nombre del producto (obligatorio): El nombre del producto. La longitud máxima de este campo es de 100 bytes.
  • Cantidad (opcional): Cuántos de estos productos están en el carro de compras. Este campo solo se aplica a las visitas con el evento de compra.
  • Precio (opcional): El precio total del producto como decimal. Si la cantidad es mayor que 1, establezca el precio en el total y no en el precio del producto individual. Alinee la moneda de este valor para que coincida con la variable currencyCode. No incluya el símbolo de moneda en este campo. Este campo solo se aplica a las visitas con el evento de compra.
  • Eventos (opcional): Eventos asociados al producto. Delimite varios eventos con una barra vertical (|). Consulte events (eventos) para obtener más información.
  • eVars (opcional): eVars de comercialización vinculadas al producto. Delimite varias eVars de comercialización con una barra vertical (|). Consulte eVars de comercialización para obtener más información.
// 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";

Esta variable admite varios productos en la misma visita. Es útil para un carro de compras y pedidos que incluyen múltiples productos. La longitud máxima de toda la cadena products es de 64 K. Separe cada producto con una coma (,) en la cadena.

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

Elimine todos los puntos y comas, las barras de los nombres de productos y las categorías, y los valores de eVar de comercialización. Si el nombre de un producto incluye una coma, AppMeasurement la analiza como el inicio de un nuevo producto. Este error en el análisis elimina el resto de la cadena de producto, lo que provoca datos incorrectos en dimensiones e informes.

Ejemplos

La variable products es flexible cuando se omiten campos e incluyen varios productos. Esta flexibilidad puede facilitar la omisión de un delimitador, lo que hace que la implementación envíe datos incorrectos 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";

Si utiliza la digitalData capa de datos, puede iterar a través de la 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 += ",";
    }
}

En esta página