DocumentaciónExperience PlatformGuía del SDK web

Recopilar información comercial, de productos y de pedidos

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Developer

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.
TIP
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 commerce-object

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

TIP
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:

code language-javascript 
alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

El order objeto order-object

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:

code language-javascript 
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 product-list-object

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:

code language-javascript 
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:

code language-javascript 
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:

code language-javascript 
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
      }
    ]
  }
});
recommendation-more-help
def05a9c-d048-422c-a3a1-88b2de863f4f