Como Configurar o Rastreamento do Ecommerce

Existem dois estágios principais para configurar o rastreamento de ecommerce dentro do MVMCloud Analytics. Na primeira etapa, você precisará certificar-se de que ativou o rastreamento de ecommerce na interface do MVMCloud Analytics. Você pode configurar isso nas configurações do site. As instruções seguem abaixo.

Estágio Um: Ativando o Rastreamento de Ecommerce do Site

Se você já estiver rastreando um site dentro do MVMCloud Analytics sem o ecommerce ativado, será necessário atualizar as configurações do site para ativar o rastreamento de ecommerce. Siga os passos abaixo:

Clique no ícone de engrenagem no menu superior para carregar a página de configurações;
No menu esquerdo clique em Sites >> Gerenciar;
No painel do lado direito escolha qual site deseja gerenciar e clique no ícone de edição, conforme abaixo;
Role a página até chegar ao menu suspenso Ecommerce e selecione Ecommerce ativado;
Selecione a opção de Moeda apropriada no menu suspenso a seguir;
Role para baixo e pressione o botão Salvar para concluir o primeiro estágio de configuração do rastreamento de ecommerce;
Para confirmar se tudo está funcionando conforme o esperado, clique no link Painel de Controle no menu superior. Agora você deve ver o item de menu Ecommerce na navegação principal no lado esquerdo;

Estágio Dois: Habilitando o Rastreamento em Sua Plataforma de Ecommerce

A segunda etapa consiste em integrar o código de rastreamento do MVMCloud Analytics ao seu site. Você pode fazer isso adicionando os códigos de JavaScript necessários ao código personalizado do seu carrinho.

Estes códigos devem ser adicionados em pontos específicos do seu site, por exemplo, o código de adição ao carrinho deve ser adicionado ao clique do botão para adicionar ao carrinho, o código de compra realizada pode ser adicionado na página de obrigado ou página de confirmação de compra do seu site.

Existem três categorias de ações que você precisará integrar para uma configuração completa de rastreamento de ecommerce:

Atualizações de pedidos (obrigatório) – Este é um componente obrigatório do rastreamento de ecommerce.
Visualizações de produtos (opcional) – Isso permite calcular taxas de conversão por produto.
Atualizações do carrinho (opcional) – Isso permite rastrear as estatísticas do carrinho abandonado.

Atualizações de Pedidos (Obrigatório)

O rastreamento de pedidos é a configuração mínima necessária para uma implementação de rastreamento de ecommerce bem-sucedida. As métricas de pedidos provavelmente são as mais valiosas para qualquer loja de ecommerce, portanto, você precisa certificar-se de configurar o rastreamento de pedidos corretamente.

Existem dois elementos principais necessários para enviar uma compra de ecommerce para o MVMCloud Analytics:

Detalhes do produto para cada produto adquirido, contendo no mínimo o SKU do produto (SKU é o código de estoque do produto);
Detalhes do pedido, contendo um ID de pedido exclusivo e a receita total no mínimo.

O pedido geralmente é rastreado na página de confirmação do pedido após a confirmação do pagamento.

Observação: o ID do pedido exclusivo gerado pelo software do carrinho garante que o mesmo pedido não seja rastreado duas vezes.

Exemplo de Adição de um Produto ao Pedido

O trecho abaixo contém dados de exemplo no formato exigido pelo MVMCloud Analytics. Todos os parâmetros, que são mostrados entre aspas duplas, devem ser preenchidos dinamicamente pela sua plataforma de ecommerce.

productSKU (Obrigatório) – String – Um identificador de produto exclusivo;
productName (Recomendado) – String – O nome do produto;
productCategory (Opcional) – String/Array – Este é o nome da categoria passado como uma string ou até cinco categorias exclusivas como uma matriz, por exemplo ["Livros", "Lançamentos", "Tecnologia"];
preço (Opcional) – Inteiro/Flutuante – O custo do item;
quantidade (Opcional) – Inteiro – Quantos deste item estão no pedido. O padrão é 1.

Exemplo do código:


// Array do Produto
_paq.push(['addEcommerceItem',  
    "01234567890", // (obrigatório) SKU: Identificador único do produto  
    "Livro de Métricas do Ecommerce", // (opcional) Nome do produto  
    "Livros", // (opcional) Categoria do produto. Você também pode informar um array com até 5 categorias. ex: ["Livros", "Lançamentos", "Biografias"]  
    9.99, // (Recomendado) Preço de venda do produto  
    1 // (Opsional - O padrão é 1) Quantidade  
]);

Exemplo de Rastreamento do Pedido de Ecommerce

A segunda parte do código de atualização do pedido passado parao MVMCloud Analytics é um resumo do pedido. No mínimo, deve incluir um ID de pedido e o valor total da receita. As variáveis passadas, em ordem, são:

orderId (Obrigatório) – String – Um número de referência exclusivo para evitar duplicidade.
grandTotal (obrigatório) – Integer/Float – A receita total do pedido incluindo impostos e frete com quaisquer descontos subtraídos.
subTotal (Opcional) – Integer/Float – O total do pedido excluindo o frete.
imposto (Opcional) – Integer/Float - O valor do imposto cobrado.
frete (Opcional) – Inteiro/Flutuante – O valor cobrado pelo frete.
desconto (Opcional) – Inteiro/Flutuante/Booleano – Desconto oferecido? Padrão para false. Caso contrário, você deve incluir um valor numérico.

Exemplo do código:


// Array do Pedido - Os parâmetros devem ser gerados dinamicamente
_paq.push(['trackEcommerceOrder',
    "000123", // (Obrigatório) orderId
    10.99, // (Obrigatório) grandTotal (receita)
    9.99, // (Opcional) subTotal
    1.5, // (Opcional) Imposto
    1, // (Opcional) Frete
    false // (Opcional) Desconto
]);

Visualizações de Produtos (Opcional)

Por padrão, o MVMCloud Analytics pode informar a taxa de conversão para o seu site como um todo. Além disso, você pode acompanhar quantas pessoas visitaram uma página onde seu produto está disponível para venda. Em seguida, o MVMCloud Analytics calculará automaticamente uma taxa de conversão para cada produto.

A coleta de taxas de conversão específicas de produtos e categorias pode ser útil para identificar onde determinados produtos podem não ter informações suficientes ou onde categorias de produtos específicas estão com baixo desempenho em seu site.

Existe um método JavaScript para enviar dados de visualização de produtos e categorias para o MVMCloud Analytics, que é 'setEcommerceView'. A única diferença entre rastrear produtos e categorias é quais parâmetros são anexados à chamada. Para ambos, você também precisará certificar-se de incluir uma chamada 'trackPageView'. Você pode encontrar mais detalhes e exemplos para ambos abaixo.

Visualizações de Produto

Os seguintes parâmetros são recomendados para rastrear visualizações de produtos:

productSKU (Obrigatório) – String – Um identificador de produto exclusivo.
productName (Obrigatório) – String – O nome do produto.
categoryName (Opcional) – String/Array – Este é o nome da categoria passado como uma string ou até cinco categorias exclusivas como uma matriz, por exemplo["Livros", "Lançmentos", "Tecnologias"]
preço (Opcional) – Inteiro/Flutuante – O custo do item.

Exemplo do código de visualização de produto


// Envio dos dados de visualização de produto - Os parâmetros devem ser gerados dinamicamente
_paq.push(['setEcommerceView',
    "0123456789", // (Obrigatório) Código SKU do produto
    "Livro de Métricas de Ecommerce", // (Opcional) Nome do produto
    "Livros", // (Opcional) Nome da categoria
    9.99 // (Opcional) preço
]);
// Você também deve chamar trackPageView quando rastreando visualização de produto
_paq.push(['trackPageView']);

Visualizações de Categoria

Os seguintes parâmetros são obrigatórios e recomendados para rastrear visualizações de página de uma categoria (não uma página de produto)::

productSKU – Booleano – Deve ser igual a false.
productName – Booleano – Deve ser igual a false.
categoryName (Obrigatório) – String/Array – Este é o nome da categoria passado como uma string ou até cinco categorias exclusivas como uma matriz, por exemplo ["Livros", "Lançmentos", "Tecnologias"]

Exemplo do código de visualização de categoria


// Envio dos dados de visualização de categoria - Os parâmetros devem ser gerados dinamicamente
_paq.push(['setEcommerceView',
    false, // productName - Nome do produto não é aplicável para visualização de categoria.
    false, // ProductSKU - Código de estoque do produto não é aplicável para visualização de categoria.
    "Livros", // (Opcional) Categoria do produto ou array com até 5 categorias.
]);
// Você também deve chamar trackPageView quando rastreando visualização de categoria
_paq.push(['trackPageView']);

Atualizações do Carrinho (Opcional)

Para rastrear adições e remoções de carrinho, seu sistema de carrinho precisará enviar os detalhes de cada item que permanece no carrinho depois que um usuário adiciona ou remove um item, incluindo aqueles já enviados de cliques anteriores em Adicionar ao carrinho . Isso é importante para coletar informações precisas sobre o recurso de carrinho abandonado no MVMCloud Analytics. Os dados devem ser inseridos dentro de um “push”, que é a função que possibilita o envio de dados estruturados para o MVMCloud Analytics via JavaScript. Você também precisará fornecer o valor total de todos os itens no carrinho. Portanto, os dois elementos necessários para o rastreamento do carrinho são:

Um push de 'addEcommerceItem'para cada produto atualmente no carrinho, incluindo o nome e o SKU no mínimo.
Um push final 'trackEcommerceCartUpdate'com o total do carrinho passado como parâmetro.

Exemplo de atualização do carrinho de produtos

Cada item processado como parte da atualização do carrinho pode conter os seguintes parâmetros, mas deve incluir, no mínimo, o nome e o SKU.

productSKU (Obrigatório) – String – Um identificador de produto exclusivo.
productName (Recomendado) – String – O nome do produto.
categoryName (Opcional) – String/Array – Este é o nome da categoria passado como uma string ou até cinco categorias exclusivas como uma matriz, por exemplo ["Livros", "Lançmentos", "Tecnologias"]
preço (Opcional) – Inteiro/Flutuante – O custo do item.
quantidade (Opcional) – Inteiro – Quantos deste item estão no carrinho. O padrão é 1.

O trecho abaixo contém dados de exemplo no formato exigido pelo MVMCloud Analytics. Todos os parâmetros devem ser preenchidos dinamicamente pela sua plataforma de ecommerce.


// Um push addEcommerceItem deve ser gerado para cada item do carrinho, 
// mesmo os produtos não atualizados pelo clique atual "Adicionar ao carrinho".
_paq.push(['addEcommerceItem',
    "0123456789", // (Obrigatório) productSKU
    "Livro de Métricas de Ecommerce", // (Opcional) productName
    ["Livros", "Mais Vendidos"], // (Opcional) productCategory
    9.99, // (Recomendado) preço
    1 // (Opcional, padrão é 1) quantidade
]);
// Passe o valor total do carrinho como um parêmetro numérico
_paq.push(['trackEcommerceCartUpdate', 15.5]);

Aviso Importante Sobre Moedas

Variáveis de moeda devem ser passadas como um número inteiro ou flutuante.

Os seguintes parâmetros de moeda devem ser fornecidos como números inteiros ou flutuantes, não como strings:

Parâmetros para addEcommerceItem():
- Preço
Parâmetros para trackEcommerceOrder():
total geral (grandTotal)
subtotal
imposto
frete
desconto

Por exemplo, todos os valores a seguir não são variáveis de moeda válidas:

“5.3$”
“R$ 5,3”
“5,4”
“5.4”
“5.44”

Os seguintes valores são variáveis de moeda válidas:

5
5.3
5.44

Se o seu software de ecommerce fornecer os valores apenas como string, você poderá chamar a função Javascript parseFloat() para converter os valores em um formato válido. Primeiro, certifique-se de que a string com a qual deseja trabalhar não contém símbolos de moeda ou outros caracteres, por exemplo, “554,30” . Você pode então passar esse valor através da função como mostrado:

parseFloat("554.30");

Observação: a função JavaScript parseFloat() não oferece suporte a valores decimais separados por vírgulas “25,3”, portanto, talvez seja necessário substituir as vírgulas por pontos primeiro.

Outras Funções JavaScript que Podem Ser Úteis

As opções a seguir podem ser úteis especialmente quando sua loja de ecommerce é um aplicativo de página única:

removeEcommerceItem(productSKU) – Remove um produto do pedido por SKU. Você ainda precisa chamar trackEcommerceCartUpdate para registrar o carrinho atualizado no MVMCloud Analytics;
clearEcommerceCart() – Apaga o pedido completamente. Você ainda precisa chamar trackEcommerceCartUpdate para registrar o carrinho atualizado no MVMCloud Analytics;
getEcommerceItems() – Retorna todos os itens atualmente no pedido de ecommerce não rastreado. A matriz retornada será uma cópia, portanto, alterá-la não afetará o pedido de ecommerce. Para afetar o que é rastreado, use os métodos: addEcommerceItem(), removeEcommerceItem(), clearEcommerceCart(). Útil para ver a lista do que será rastreado antes de rastrear um pedido ou atualização do carrinho.

Lista Completa de Funções JavaScript

O MVMCloud Analytics fornece análises de ecommerce que permitem medir os itens adicionados aos carrinhos e aprender métricas detalhadas sobre carrinhos abandonados e pedidos de compra.

setEcommerceView( productSKU, productName, categoryName, price )- Defina a exibição de página atual como uma exibição de página de produto ou categoria. Quando você liga, setEcommerceViewdeve ser seguido por uma chamada para trackPageViewregistrar a visualização da página do produto ou da categoria.
addEcommerceItem( productSKU, [productName], [productCategory], [price], [quantity] )- Adicione um produto ao pedido de ecommerce. Deve ser chamado para cada produto no pedido.
removeEcommerceItem( productSKU )- Remova o produto especificado do pedido de ecommerce não rastreado.
clearEcommerceCart()- Remova todos os produtos no pedido de ecommerce não rastreado. _Nota: isso é feito automaticamente após trackEcommerceOrder()ser chamado.
getEcommerceItems()- Devolva todos os itens de ecommerce atualmente no pedido de ecommerce não rastreado. A matriz retornada será uma cópia, portanto, alterá-la não afetará o pedido de ecommerce. Para afetar o que é rastreado, use os métodos addEcommerceItem()// . Use este método para ver o que será rastreado antes de rastrear um pedido ou atualização de carrinho.removeEcommerceItem()clearEcommerceCart()
trackEcommerceCartUpdate( grandTotal )- Rastrear um carrinho de compras. Chame esta função javascript toda vez que um usuário estiver adicionando, atualizando ou excluindo um produto do carrinho.
trackEcommerceOrder( orderId, grandTotal, [subTotal], [tax], [shipping], [discount] )- Acompanhe um pedido de ecommerce, incluindo qualquer item de ecommerce adicionado anteriormente ao pedido. orderIde grandTotal(ou seja, receita) são parâmetros obrigatórios.