Referência de dados do Magento 2

O que você vai aprender

Saiba quais dados a Klaviyo importa da sua loja Magento 2 quando o senhor integra as duas plataformas. A integração do Klaviyo com o Magento 2 extrai todos os dados históricos da sua loja Magento 2 com a sincronização histórica inicial. Uma vez ativada, a integração também começará a sincronizar métricas e dados de clientes quase em tempo real. Exemplos desses dados incluem as informações associadas a pedidos feitos anteriormente, pedidos atendidos, etc.

No Klaviyo, o senhor pode navegar até a guia Analytics da sua conta na barra lateral esquerda para visualizar todas as métricas da sua conta; as métricas com um ícone do Magento 2 são as sincronizadas a partir da integração com o Magento 2.

Como a Klaviyo determina as métricas do Magento 2

Métricas de pedidos

As métricas de pedidos do Magento 2 são determinadas pelo campo Status em um pedido em sua loja do Magento 2.

Toda vez que um pedido for criado ou seu status for atualizado, ele será avaliado de acordo com a matriz abaixo para determinar quais eventos devem ser acionados.

Se o senhor tiver status de pedido personalizados que não devam acionar uma métrica de pedido colocado ou que não estejam alinhados com a tabela acima, informe-nos e poderemos ajustar o mapeamento do status do pedido de acordo com sua integração.

Os pedidos com status "pending_payment" serão ignorados.

Métrica de checkout iniciada

Com um checkout padrão do Magento, esse evento é acionado quando um cliente insere suas informações de contato e de envio na primeira página do processo de checkout do Magento e clica em Continue (Continuar). 

O evento Started Checkout depende da criação de uma "Cotação" e de um endereço de e-mail associado a ela. Isso acontece depois que o cliente insere seu endereço de e-mail na etapa "Shipping Information" (Informações de remessa) do checkout. Se um cliente não concluir o checkout, essa cotação será sincronizada com o Klaviyo como um evento Started Checkout.

Se o cliente continuar a concluir o pedido, essa cotação será convertida em uma "fatura" no banco de dados do Magento. Como resultado, um evento Started Checkout não é enviado ao Klaviyo. Em vez disso, é enviado um evento Placed Order. Observe que pode levar até 1 hora para que os eventos do Started Checkout sejam sincronizados com o Klaviyo.

Métrica de remessa cumprida

Essa métrica é acionada quando uma nova remessa é criada em sua loja do Magento 2.

Métricas do Magento 2

Esta seção aborda cada uma das métricas do Magento 2 e os dados que estão disponíveis para filtragem ao criar segmentos e fluxos.

Pedido cancelado

Esse evento é acionado quando o status de um pedido é alterado para cancelado ou cancelado em sua loja do Magento 2.

• ProductCategories: As categorias dos produtos no pedido cancelado.
• Valor: O valor do pedido cancelado.
• Discounted: (True or False) O estado de desconto do pedido cancelado.
• OrderedProducts: Os nomes dos produtos no pedido cancelado.
• OrderedProductCount: O número de produtos no pedido cancelado.
• OrderCurrencyCode: O código da moeda usado com o pedido cancelado.
• CartPriceRuleIDs: Uma matriz de IDs de regras de preço de carrinho (cadeias de caracteres de identificação numérica) que inclui regras aplicadas automaticamente e a regra para um cupom aplicado.

Pedido atendido

Esse evento é rastreado quando o senhor define o status de um pedido como concluído em sua loja do Magento 2.

• ProductCategories: As categorias dos produtos no pedido.
• Valor: O valor do pedido.
• Discounted (com desconto): Se o pedido está com desconto ou não.
• OrderedProducts:Os nomes dos produtos no pedido.
• OrderedProductCount: O número de produtos no pedido.
• OrderCurrencyCode: O código de moeda usado com o pedido.

Remessa cumprida

Esse evento é rastreado quando uma nova remessa é criada em sua loja do Magento 2.

• StoreName: O nome da loja onde o pedido foi feito.
• StoreID: O ID da loja onde o pedido foi feito.
• BillingAddress: O endereço de faturamento do pedido.
• Rastreamento: Informações sobre o rastreamento de remessas.

Produto encomendado

Esse evento é rastreado uma vez para cada produto que um usuário encomenda quando faz um pedido.

• SKU: O SKU do produto.
• OrderCurrencyCode:O código da moeda do produto.
• Preço: O valor do produto.
• Categorias: A categoria do produto.
• Com desconto: Quaisquer descontos aplicados ao produto.
• Quantidade: O número de produtos.
• Valor: O valor do produto.
• ProductID: A ID do produto.

Pedido feito

Esse evento é rastreado quando um usuário faz um pedido.

• ProductCategories: As categorias dos produtos no pedido.
• Valor: O valor do pedido.
• Discounted (com desconto): Se o pedido está com desconto ou não.
• OrderedProducts:Os nomes dos produtos no pedido.
• OrderedProductCount: O número de produtos no pedido.
• OrderCurrencyCode: O código de moeda usado com o pedido.
• CartPriceRuleIDs: Uma matriz de IDs de regras de preço de carrinho (cadeias de caracteres de identificação numérica) que inclui regras aplicadas automaticamente e a regra para um cupom aplicado.

Pedido reembolsado

Esse evento é acionado quando um cliente reembolsa um pedido. 

• Valor: O valor do pedido.
• Discounted (com desconto): Se o pedido está com desconto ou não. 
• OrderedProducts: Os nomes de todos os produtos no pedido.
• OrderedProductCount: O número de produtos no pedido. 
• OrderCurrencyCode: O código de moeda usado com o pedido. 
• ProductCategories: As categorias dos produtos no pedido. 
• CartPriceRuleIDs: Uma matriz de IDs de regras de preço de carrinho (cadeias de caracteres de identificação numérica) que inclui regras aplicadas automaticamente e a regra para um cupom aplicado.

Início do checkout

Esse evento é acionado quando um cliente com um endereço de e-mail conhecido inicia um checkout. Em uma página de checkout padrão, esse evento é acionado quando um cliente insere suas informações de contato e envio na primeira página do processo de checkout do Magento e clica em Continue (Continuar). Um evento Started Checkout não é enviado ao Klaviyo se o usuário concluir o checkout. Em vez disso, um evento Placed Order é registrado.

• Valor: O valor do pedido durante o checkout.
• ItemCount: O número de itens no pedido. 
• Itens: Os itens no pedido. 
• ProductCategories: As categorias dos produtos no pedido. 
• ProductNames: Os nomes dos produtos no pedido. 
• StoreName: O nome da loja em que o pedido foi iniciado.
• StoreID: O ID da loja onde o pedido foi iniciado.

Adicionado ao carrinho

Observe que essa métrica só é rastreada se o senhor estiver usando a extensão Klaviyo versão 4.0.0 e superior. Essa métrica é rastreada quando um cliente que foi cookieado pela Klaviyo adiciona um item ao carrinho.

Ele inclui informações detalhadas sobre o item que foi adicionado. Isso é útil ao criar segmentos com base em quais produtos os usuários adicionaram ao carrinho ou ao criar um fluxo de carrinho abandonado. O senhor pode filtrar e direcionar as métricas de Added to Cart com base nos seguintes critérios:

• MaskedQuoteId: MaskedQuoteId ou identificador exclusivo para clientes conectados.
• AddedItemCategories: As categorias às quais o item pertence.
• AddedItemProductName: O nome do produto em sua loja, por exemplo, Red T-shirt (camiseta vermelha).
• AddedItemDescription: A descrição do item.
• AddedItemImageURLKey: O URL da imagem do item.
• AddedItemPrice: O preço do item.
• AddedItemProductID: o ID personalizado do produto em sua loja do Magento 2, por exemplo, 1234.
• AddedItemSKU: O SKU do item em sua loja, por exemplo, REDMEDIUMTSHIRT.
• AddedItemURL: O URL do item.

A Klaviyo gera uma chave, a chave de reconstrução do carrinho, que permite que o senhor crie um link que reconstrua o carrinho do cliente caso ele retorne ao carrinho por meio de um e-mail acionado por esse evento em outro dispositivo. Essa chave pode ser encontrada na matriz da propriedade 'extra'. O senhor pode criar esse link usando o seguinte URL:

{{ organization.url|trim_slash }}reclaim/checkout/cart?quote_id={{ event.MaskedQuoteId }}

Dados de clientes sincronizados

A Klaviyo cria um contato a partir da criação de um pedido existente, de um registro de cliente existente ou quando um checkout é iniciado. A Klaviyo criará um novo Klaviyo Profile para cada contato sincronizado e preencherá esse perfil com as seguintes informações:

• E-mail
• Nome e sobrenome
• Cidade, Estado/Região, CEP, País
• Número de telefone
• Conta Magento criada (por exemplo, AAAA-mm-dd hh:mm:ss; 2015-05-21 13:04:00)
• Grupo de clientes Magento (por exemplo, atacado)
• Loja Magento (por exemplo, loja dos EUA)
• Data de nascimento (por exemplo, AAAA-mm-dd; 1990-03-25)
• Gênero

Se o senhor atualizar o grupo de clientes no Magento 2, mesmo depois de o perfil original ter sido criado no Klaviyo, o grupo de clientes será atualizado no Klaviyo.

Verificar seus dados de pedidos sincronizados

O Klaviyo importa todos os seus dados do Magento 2. Para verificar isso, o senhor pode comparar o número de pedidos em um determinado dia com o que está na interface do Magento 2 e confirmar se eles correspondem. Clique em Analytics na barra lateral esquerda, localize a métrica Placed Order (Pedido feito) e clique nela. Isso o levará à página do gráfico de métricas e mostrará os últimos 30 dias de dados por padrão. O senhor pode ver um exemplo do gráfico de métricas exibido abaixo.

Passe o mouse sobre o ponto de dados de ontem ou examine a tabela de dados abaixo do gráfico para ver quantas ordens o senhor teve ontem. Compare esse número com o que está armazenado no Magento e o senhor verá que eles são exatamente iguais. Se isso não acontecer, o problema mais provável é que o fuso horário da sua conta Klaviyo não corresponde ao fuso horário do Magento.

Para conferir ou atualizar o fuso horário da sua conta:

1. Clique no nome da sua organização no canto inferior esquerdo.
2. Selecione Settings.
3. Vá para a guia Organização . 

É possível que o valor da receita no painel do Klaviyo nem sempre corresponda ao valor da receita que o senhor vê no Magento; isso ocorre porque o Klaviyo não subtrai os pedidos cancelados e reembolsados do cálculo da receita.

Recursos adicionais

• Como fazer a integração com o Magento 2.x (CE e EE)
• Solução de problemas de integração com o Magento 2