Datos particulares para interacciones de órdenes de compra (pedidos)

En caso que se quieran registrar interacciones de pedidos (ordenes de compra y/o ventas) realizados por los clientes, el campo customProps debe tener la siguiente estructura

{

"externalId": "42523452345",

"creationDate": 1604616638839,

"referral": "https://google.com/",

"utmCampaign": "summer_promotion",

"utmContent": "textlink",

"utmMedium": "cpc",

"utmSource": "google",

"utmTerm": "fast+food+mexico",

"currency": "MXN",

"total": 230,

"itemsCost": 200,

"feesCost": 30,

"items": [

{

"externalId": "123",

"name": "hamburguer",

"category": "fast-food",

"quantity": 2,

"price": 75,

"total": 150

},

{

"externalId": "345",

"name": "coca-cola",

"category": "drinks",

"quantity": 1,

"price": 50,

"total": 50

}

]

}

Los campos marcados en negrita son obligatorios.

Los parámetros UTM son estándar, para mas detalles: https://en.wikipedia.org/wiki/UTM_parameters

type

PURCHASE

subType

Alguno de estos valores (dependiendo que estados del ciclo de vida quieran registrarse):

  • PURCHASE_NEW

  • PURCHASE_WAIT_FOR_PAYMENT

  • PURCHASE_IN_PROGRESS

  • PURCHASE_READY

  • PURCHASE_PAID

  • PURCHASE_DONE

  • PURCHASE_CANCELED_CUSTOMER

  • PURCHASE_CANCELED_MERCHANT

customProps.externalId

Id único del pedido en el sistema externo

customProps.creationDate

Fecha de creación del pedido en formato timestamp milisegundos

customProps.referral

Quién estimuló el pedido (x ej: google, facebook, etc)

customProps.utmCampaign

Promoción o campaña que estimuló el pedido

customProps. utmContent

Elemento visual con el que interactuó el usuario para realizar el pedido

customProps.utmMedium

Tipo de link utilizado

customProps.utmSource

Sitio que estimuló el pedido

customProps.utmTerm

Términos de búsqueda que llevaron a encontrar el producto y/o servicio

customProps.currency

Moneda del pedido, estándar ISO 4217 https://es.wikipedia.org/wiki/ISO_4217

customProps.total

Monto total del pedido expresado en la moneda del mismo

customProps.itemsCost

Costo de los productos y/o servicios expresado en la moneda del pedido

customProps.feesCost

Costo de impuestos, cargos fijos, comisiones, etc (agregados al costo del producto y/o servicio)

customProps.items

Lista de ítems del pedido

customProps.items.externalId

Id único del ítem en el sistema cliente.

customProps.items.name

Nombre del ítem

customProps.items.category

Categoría del ítem. Este dato no es obligatorio, pero de disponerlo BotBit tiene la capacidad de segmentar clientes por este discriminador.

customProps.items.quantity

Cantidad de ítems del pedido

customProps.items.price

Precio unitario de cada ítem expresado en la moneda del pedido

customProps.items.total

Precio total expresado en la moneda del pedido

¿Encontró su respuesta?