Show Menu
TÓPICOS×

Produtos (Beta)

O SDK da Web da plataforma Adobe Experience está atualmente em beta e não está disponível para todos os usuários. A documentação e a funcionalidade estão sujeitas a alterações.
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 desde o início.
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íveis no commerce objeto.
Medida
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 produtos é criada. (Por exemplo, um novo carrinho de compras é criado.)
Altamente recomendado
Um produto é removido de uma lista de produtos.
Opcional
Uma lista de produtos é reativada pelo usuário. Isso geralmente acontece em campanhas de remarketing.
Altamente recomendado
Uma lista de produtos é exibida.
Altamente recomendado
Ocorreu uma exibição de um produto. Certifique-se de definir o produto exibido no productListItems .
Altamente recomendado
Um pedido é aceito. Deve ter uma lista de produtos.
Opcional
Um produto é salvo para uso futuro.
Este é um exemplo de como você pode defini-los Measures no SDK.
alloy("event", {
  "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("event",{
  "xdm":{
    "commerce":{
      "order":{
        "purchaseID":"123456789",
        "currenceCode":"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,
        "qauntity":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
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. Os exemplos incluem add to cart button , quick add e 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("event",{
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
      }
    ]
  }
});

productView evento
alloy("event",{
  "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("event",{
  "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("event",{
  "xdm":{
    "commerce":{
      "order":{
        "purchaseID":"123456789",
        "currenceCode":"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,
        "qauntity":1
      }
    ]
  }
});