Se você tiver produtos no seu site, esse é um conjunto padrão de itens que você pode enviar para habilitar a maioria dos recursos do Adobe. Embora esta seja uma sugestão, ela fornece um conjunto de dados muito forte desde o início.
Este documento usa o Detalhes de comércio do ExperienceEvent grupo de campos do esquema. O commerce
grupo de campos é dividido em duas partes: o commerce
e o productListItems
matriz. O commerce
permite indicar quais ações estão acontecendo no objeto productListItems
matriz.
Se você estiver familiarizado com o Adobe Analytics, a variável commerce
está mais intimamente relacionada ao events
variável. O productListItems
está mais estreitamente relacionada com a products
variável.
Abaixo está uma lista de measures
disponível na commerce
objeto.
Uma medida tem dois campos: id
e value
. Na maioria das vezes, você usará o value
somente campo (por exemplo, 'value':1
). O id
permite definir um identificador exclusivo que pode ser usado para acompanhar quando a medida foi enviada. Consulte a documentação do XDM para Medição.
Medição | Recomendação | Descrição |
---|---|---|
cartAbandons | Opcional | Um carrinho não pode mais ser acessado ou comprado pelo usuário. |
check-outs | Altamente recomendado | Um usuário não está mais procurando produtos, mas está comprando um produto. |
productListAdds | Altamente recomendado | Um produto é adicionado a uma lista. Certifique-se de definir o produto no productListItems ao mesmo tempo. |
productListOpens | Opcional | Uma nova lista de produtos é criada. (Por exemplo, um novo carrinho de compras é criado.) |
productListRemoments | Altamente recomendado | Um produto é removido de uma lista de produtos. |
productListReopens | Opcional | Uma lista de produtos é reativada pelo usuário. Isso geralmente acontece em campanhas de remarketing. |
productListViews | Altamente recomendado | Uma lista de produtos é exibida. |
productViews | Altamente recomendado | Ocorreu uma visualização de um produto. Certifique-se de definir o produto exibido no productListItems . |
compras | Altamente recomendado | Um pedido é aceito. Deve ter uma lista de produtos. |
saveForLaters | Opcional | Um produto é salvo para uso futuro. |
Este é um exemplo de como você define esses itens Measures
no SDK.
alloy("sendEvent", {
"xdm":{
"commerce":{
"productViews":{
"value":1
}
}
}
});
O objeto de comércio também tem um campo especial para coletar detalhes de pedidos chamado order
.
Pedido | Opção | Recomendação | Descrição |
---|---|---|---|
currencyCode | O ISO 4217 moeda do total do pedido. | ||
payments[paymentItems] | A lista de pagamentos em uma ordem. A paymentItem inclui o seguinte. | ||
currencyCode | Opcional | O ISO 4217 moeda deste método de pagamento. | |
paymentAmount | Altamente recomendado | O valor do pagamento no código de moeda especificado. | |
paymentType | Altamente recomendado | O tipo de pagamento (por exemplo, credit_card , gift_card , paypal ). Consulte a lista de valores conhecidos para obter detalhes. |
|
transactionID | Opcional | Uma ID exclusiva para esta transação de pagamento. | |
priceTotal | Altamente recomendado | O total deste pedido após todos os descontos e impostos terem sido aplicados. | |
purchaseID | Altamente recomendado | O identificador exclusivo atribuído pelo vendedor para esta compra. | |
purchaseOrderNumber | Opcional | Um identificador exclusivo atribuído pelo comprador para esta compra. |
Este é um exemplo de uma compra típica no 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
}
]
}
});
A lista de produtos indica quais produtos estão relacionados à ação correspondente. É uma lista de productListItems. Cada produto tem vários campos opcionais.
Campo | Recomendação | Descrição |
---|---|---|
currencyCode | Opcional | O ISO 4217 moeda do produto. Isso só é útil quando você pode ter produtos com códigos de moeda diferentes e quando ele se aplica. Por exemplo, quando há uma compra ou adição ao carrinho. |
priceTotal | Altamente recomendado | Só deve ser definido quando aplicável. Por exemplo, talvez não seja possível definir em productView uma vez que diferentes variações do produto podem ter preços diferentes, mas com uma variação productListAdds evento. |
produto | Altamente recomendado | A ID XDM do produto. |
productAddMethod | Altamente recomendado | O método usado para adicionar um item de produto à lista pelo visitante. Defina com productListAdds , e só devem ser usadas quando um produto for adicionado à lista. Os exemplos incluem add to cart button , quick add e upsell . |
productName | Altamente recomendado | Isso é definido como o nome de exibição ou o nome legível do produto. |
quantidade | Altamente recomendado | O número de unidades que o cliente indicou que necessita do produto. Deve ser definido em productListAdds , productListRemoves , purchases , saveForLaters e assim por diante. |
SKU | Altamente recomendado | Armazene a unidade de manutenção. É o identificador exclusivo do produto. |
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
}
]
}
});