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 grupo de campos Detalhes de comércio do ExperienceEvent. O grupo de campos commerce é dividido em duas partes: o objeto commerce e a matriz productListItems. O objeto commerce permite indicar quais ações estão acontecendo na matriz productListItems.

DICA

Se você estiver familiarizado com o Adobe Analytics, o commerce estará mais relacionado à variável events. O productListItems está mais relacionado à variável products.

Ações relacionadas a produtos

Abaixo está uma lista de measures disponíveis no objeto commerce.

DICA

Uma medida tem dois campos: id e value. Na maioria das vezes, você usará somente o campo value (por exemplo, 'value':1). O campo id permite definir um identificador exclusivo que pode ser usado para acompanhar quando a medida foi enviada. Consulte a documentação XDM para Measure.

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ê definiria esses Measures no SDK.

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

O objeto de comércio também tem um campo especial para coletar detalhes do pedido chamado order.

Pedido Opção Recomendação Descrição
currencyCode A moeda ISO 4217 para o total do pedido.
payments[paymentItems] A lista de pagamentos em uma ordem. Um paymentItem inclui o seguinte.
currencyCode Opcional A moeda ISO 4217 para este 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 A moeda ISO 4217 para o 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 porque diferentes variações do produto podem ter preços diferentes, mas em um productListAdds.
produto Altamente recomendado A ID XDM do produto.
productAddMethod Altamente recomendado O método usado para adicionar um item de produto à lista pelo visitante. Definido com productListAdds medidas e deve ser usado somente quando um produto é 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.

Exemplos

productView evento

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

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

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

purchase 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