Recopilar información comercial, de productos y de pedidos

Última actualización: 2023-10-31
  • Temas:
  • Web SDK
    Ver más sobre este tema
  • Creado para:
  • Developer
    User
    Admin
    Leader

Si su organización vende productos o servicios, puede utilizar esta página como guía sobre cómo rastrear esos productos y servicios.

Esta página utiliza el XDM Esquema de Commerce grupo de campos.

Este grupo de campos consta de dos partes principales:

  • El commerce objeto. Este objeto permite indicar qué acciones se producen en el productListItems matriz.
  • El productListItems matriz.
SUGERENCIA

Si está familiarizado con Adobe Analytics, la variable commerce contiene datos similares a eventos de comercio en el events variable. El productListItems la matriz de objetos contiene datos similares a los de products variable.

El commerce objeto

Esta sección describe los campos disponibles en la variable commerce objeto.

SUGERENCIA

Una medida tiene dos campos: id y value. La mayoría de las veces, solo se utiliza el value field (por ejemplo, 'value':1). El id Este campo permite establecer un identificador único para el seguimiento del envío de la medida. Consulte la documentación de XDM para Medida para obtener más información.

Medida Recomendación Descripción
cartAbandons Opcional El usuario ya no puede comprar ni acceder al carro de compras.
checkouts Muy recomendado Un usuario ya no está buscando productos, pero está en el proceso de comprar un producto.
productListAdds Muy recomendado Se agrega un producto a una lista. Asegúrese de configurar el producto en la 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 Los productos se eliminan de las listas de productos.
productListReopens Opcional El usuario reactiva una lista de productos. Esta acción suele ocurrir en campañas de remarketing.
productListViews Muy recomendado Se muestra una lista de productos.
productViews Muy recomendado Se produjo una vista de un producto. Asegúrese de configurar el producto visualizado en la productListItems.
purchases Muy recomendado Se acepta una solicitud. Debe tener una lista de productos.
saveForLaters Opcional Se ha guardado un producto para uso futuro.

Commerce ejemplos de objeto

Expanda la sección siguiente para ver un ejemplo de un comando del SDK web que utiliza un campo del commerce objeto.

 productViews

Un SDK web básico sendEvent llamada configurar el productViews field a 1:

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

El order objeto

El commerce contiene un objeto dedicado para recopilar detalles de pedidos. Esto se denomina order objeto.

En esta sección se describen todos los campos admitidos por la variable order objeto.

Campo Opción Recomendación Descripción
currencyCode El ISO 4217 divisa del total del pedido.
payments[] La lista de pagos de un pedido. A paymentItem incluye lo siguiente.
currencyCode Opcional El ISO 4217 divisa de esta forma de pago.
paymentAmount Muy recomendado El valor del pago en el código de divisa 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 único 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 El identificador único asignado por el vendedor a esta compra.
purchaseOrderNumber Opcional Un identificador único asignado por el comprador a esta compra.

Ejemplos de objetos de pedidos

Expanda la sección siguiente para ver un ejemplo de un comando del SDK web que utiliza el commerce objeto.

 Order ejemplo de objeto

Un SDK web sendEvent llamada configurar el order que se aplica a varios productos de la productListItems matriz:

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
      }
    ]
  }
});

El objeto de lista 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 varios campos opcionales.

Campo Recomendación Descripción
currencyCode Opcional El ISO 4217 la moneda del producto. Por lo general, este campo solo se aplica cuando hay varios productos en la lista de productos con códigos de moneda diferentes.
priceTotal Muy recomendado Establezca este campo solo cuando corresponda. Por ejemplo, es posible que no se pueda establecer en productView debido a que diferentes variaciones del producto pueden tener diferentes precios, pero en un productListAdds evento.
product Muy recomendado ID de XDM para el producto.
productAddMethod Muy recomendado El método que el visitante utilizó para agregar un producto a la lista. Configurado con productListAdds y solo se utiliza cuando se añade un producto a la lista. Los ejemplos incluyen add to cart button, quick add y upsell.
productName Muy recomendado El nombre para mostrar o el nombre en lenguaje natural del producto.
quantity Muy recomendado El número de unidades que el cliente ha indicado que necesita del producto. Debe configurarse en productListAdds, productListRemoves, purchases, saveForLaters, etc.
SKU Muy recomendado Almacén de la unidad. Es el identificador único del producto.

Ejemplos de listas de productos

Expanda las secciones siguientes para ver ejemplos de comandos del SDK web que utilizan productListItems objeto.

 productListItems ejemplo

Un SDK web sendEvent llamada configurar el productViews para varios productos en la productListItems matriz:

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

Un SDK web sendEvent llamada configurar el productListAdds evento para varios productos en la productListItems matriz:

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 ejemplo

Un SDK web sendEvent llamada configurar el checkouts evento para varios productos en la productListItems matriz:

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
      }
    ]
  }
});

En esta página