Recopilar información comercial y de producto

Si tiene productos en el sitio, este es un conjunto predeterminado de cosas que puede querer enviar para habilitar el máximo número de funcionalidades desde el Adobe. Aunque se trata de una sugerencia, proporciona un conjunto de datos muy sólido desde el principio.

Este documento utiliza la variable Detalles comerciales de ExperienceEvent grupo de campos de esquema. La variable commerce el grupo de campos se divide en dos partes: el commerce y productListItems matriz. La variable commerce El objeto permite indicar qué acciones están sucediendo con el productListItems matriz.

SUGERENCIA

Si está familiarizado con Adobe Analytics, la variable commerce está más estrechamente relacionado con el events variable. La variable productListItems está más estrechamente relacionado con el products variable.

Acciones relacionadas con los productos

A continuación se muestra una lista de measures disponible en el commerce objeto.

SUGERENCIA

Una medida tiene dos campos: id y value. La mayoría de las veces, utilizará la variable value solo campo (por ejemplo, 'value':1). La variable id permite establecer un identificador único que se puede utilizar para realizar un seguimiento del momento en que se envió la medida. Consulte la documentación de XDM para Medida.

Medida Recomendación Descripción
cartAbandons Opcional El usuario ya no puede acceder ni comprar un carro de compras.
cierres de compra Muy recomendado Un usuario ya no está buscando productos, pero está en proceso de adquirir un producto.
productListAdd Muy recomendado Un producto se añade a una lista. Asegúrese de establecer el producto en la variable productListItems al mismo tiempo.
productListOpens Opcional Se crea una nueva lista de productos. (Por ejemplo, se crea un nuevo carro de compras).
productListRemovals Muy recomendado Un producto se elimina de una lista de productos.
productListReopens Opcional El usuario reactiva una lista de productos. Esto suele ocurrir en campañas de remarketing.
productListViews Muy recomendado Se ve una lista de productos.
productViews Muy recomendado Se ha producido una vista de un producto. Asegúrese de establecer el producto visualizado en la variable productListItems.
compras Muy recomendado Se acepta un pedido. Debe tener una lista de productos.
saveForLaters Opcional Un producto se guarda para uso futuro.

A continuación, se muestra un ejemplo de cómo configurar estas Measures en el SDK.

alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

El objeto commerce también tiene un campo especial para recopilar detalles de pedidos llamados order.

Pedido Opción Recomendación Descripción
currencyCode La variable ISO 4217 moneda para el total del pedido.
payments[paymentItems] La lista de pagos de un pedido. A paymentItem incluye lo siguiente:
currencyCode Opcional La variable ISO 4217 para este método de pago.
paymentAmount Muy recomendado El valor del pago en el código de moneda especificado.
paymentType Muy recomendado El tipo de pago (por ejemplo, credit_card, gift_card, paypal). Consulte la lista de valores conocidos para obtener más información.
transactionID Opcional Un ID exclusivo para esta transacción de pago.
priceTotal Muy recomendado El total de este pedido después de aplicar todos los descuentos e impuestos.
purchaseID Muy recomendado Identificador único asignado por el vendedor para esta compra.
purchaseOrderNumber Opcional Identificador único asignado por el comprador para esta compra.

A continuación, se muestra un ejemplo de una compra típica en el SDK.

alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "order":{
        "purchaseID":"123456789",
        "currencyCode":"USD",
        "priceTotal":39.98,
        "payments":[
          {
            "transactionID":"amx12345",
            "paymentAmount":39.98,
            "paymentType":"credit_card",
            "currencyCode":"USD"
          }
        ]
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "priceTotal":29.99,
        "quantity":1
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "priceTotal":9.99,
        "quantity":1
      }
    ]
  }
});

Listas de productos

La lista de productos indica qué productos están relacionados con la acción correspondiente. Es una lista de productListItems. Cada producto tiene una serie de campos opcionales.

Campo Recomendación Descripción
currencyCode Opcional La variable ISO 4217 moneda para el producto. Esto solo es útil cuando se pueden tener productos con diferentes códigos de moneda y cuando se aplican. Por ejemplo, cuando hay una compra o un anuncio al carro de compras.
priceTotal Muy recomendado Solo debe configurarse cuando corresponda. Por ejemplo, es posible que no sea posible establecer en productView porque las diferentes variaciones del producto pueden tener precios diferentes pero en un productListAdds evento.
producto Muy recomendado ID XDM para el producto.
productAddMethod Muy recomendado Método que el visitante utilizó para agregar un elemento de producto a la lista. Configure con productListAdds y solo debe usarse cuando se agrega un producto a la lista. Los ejemplos incluyen add to cart button, quick add y upsell.
productName Muy recomendado Se establece en el nombre para mostrar o en el nombre legible en lenguaje natural del producto.
cantidad Muy recomendado Número de unidades que el cliente ha indicado que requiere del producto. Debe configurarse en productListAdds, productListRemoves, purchases, saveForLaters, etc.
SKU Muy recomendado Conservar unidad de mantenimiento. Es el identificador único del producto.

Ejemplos

productViews evento

alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
      }
    ]
  }
});

productListAdds evento

alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productListAdds":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "quantity":1,
        "priceTotal":29.99,
        "productAddMethod":"Add to Cart Button"
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "quantity":1,
        "priceTotal":9.99,
        "productAddMethod":"Add-on"
      }
    ]
  }
});

checkouts evento

alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "checkouts":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "quantity":1,
        "priceTotal":29.99
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "quantity":1,
        "priceTotal":9.99
      }
    ]
  }
});

order evento

alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "order":{
        "purchaseID":"123456789",
        "currencyCode":"USD",
        "priceTotal":39.98,
        "payments":[
          {
            "transactionID":"amx12345",
            "paymentAmount":39.98,
            "paymentType":"credit_card",
            "currencyCode":"USD"
          }
        ]
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "priceTotal":29.99,
        "quantity":1
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "priceTotal":9.99,
        "quantity":1
      }
    ]
  }
});

En esta página