Show Menu
TÓPICOS×

Produtos

Se você tiver produtos em seu site, esse é um conjunto padrão de itens que você pode querer enviar para ativar a maioria dos recursos da Adobe. Embora esta seja uma sugestão, ela fornece um conjunto muito forte de dados diretamente do start.
Este documento usa a combinação Detalhes do Comércio de ExperienceEvent. A commerce mistura é dividida em duas partes: o commerce objeto e a productListItems matriz. O commerce objeto permite indicar quais ações estão acontecendo na productListItems matriz.

Ações relacionadas a produtos

Abaixo está uma lista de measures disponível no commerce objeto.
Medição
Recomendação
Descrição
Opcional
Um carrinho não pode mais ser acessado ou comprado pelo usuário.
Altamente recomendado
Um usuário não está mais procurando produtos, mas está comprando um produto.
Altamente recomendado
Um produto é adicionado a uma lista. Certifique-se de definir o produto ao productListItems mesmo tempo.
Opcional
Uma nova lista de produto é criada. (Por exemplo, um novo carrinho de compras é criado.)
Altamente recomendado
Um produto é removido de uma lista de produto.
Opcional
Uma lista de produto é reativada pelo usuário. Isso frequentemente acontece em campanhas de remarketing.
Altamente recomendado
Uma lista de produtos é visualizada.
Altamente recomendado
Ocorreu uma visualização de um produto. Certifique-se de definir o produto exibido no productListItems .
Altamente recomendado
Um pedido é aceito. Deve ter uma lista de produto.
Opcional
Um produto é salvo para uso futuro.
Este é um exemplo de como você pode defini-los Measures no SDK.
alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

O objeto commerce também tem um campo especial para coletar detalhes de pedidos chamados order .
Pedido
Opção
Recomendação
Descrição
A moeda ISO 4217 para o total do pedido.
A lista de pagamentos em uma ordem. Um paymentItem inclui o seguinte.
Opcional
A moeda ISO 4217 para este método de pagamento.
Altamente recomendado
O valor do pagamento no código de moeda especificado.
Altamente recomendado
O tipo de pagamento (por exemplo, credit_card , gift_card , paypal ). Consulte a lista de valores paymentitem.schema.md#xdmpaymenttype-known-values conhecidos para obter detalhes.
Opcional
Uma ID exclusiva para esta transação de pagamento.
Altamente recomendado
O total desse pedido depois que todos os descontos e impostos tiverem sido aplicados.
Altamente recomendado
O identificador exclusivo atribuído pelo vendedor para esta compra.
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 do produto 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
Opcional
Moeda ISO 4217 para o produto. Isso só é útil quando você pode ter produtos com códigos monetários diferentes e quando se aplica. Por exemplo, quando há uma compra ou adição ao carrinho.
Altamente recomendado
Só deve ser definido quando aplicável. Por exemplo, pode não ser possível partir do zero productView porque diferentes variações do produto podem ter preços diferentes, mas sim preços productListAdds .
Altamente recomendado
A ID XDM do produto.
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. Examples include add to cart button , quick add , and upsell .
Altamente recomendado
Isso é definido para o nome de exibição ou para o nome legível por humanos do produto.
Altamente recomendado
O número de unidades que o cliente indicou que necessitavam do produto. Deve ser definido como productListAdds , productListRemoves , purchases , saveForLaters , e assim por diante.
Altamente recomendado
Unidade de Manutenção de Loja. É 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
      }
    ]
  }
});