Coletar informações de comércio e produto

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.

DICA

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.

Ações relacionadas a produtos

Abaixo está uma lista de measures disponível na commerce objeto.

DICA

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

Listas de produtos

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, saveForLaterse assim por diante.
SKU Altamente recomendado Armazene a unidade de manutenção. É o identificador exclusivo do produto.

Exemplos

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

Nesta página