Referência de dados do Magento 2

Saiba quais dados Klaviyo importar de seu Magento 2 armazenar quando o senhor integra as duas plataformas. Klaviyo's integrações com Magento 2 puxa todos os dados históricos em seu Magento 2 armazenar com a sincronização histórica inicial. Depois de habilitar as integrações, o senhor também começará a sincronizar pedidos e dados do cliente a cada 30 minutos. Exemplos desses dados incluem as informações associadas a pedidos feitos anteriormente, pedidos atendidos, etc.

Em Klaviyo, o senhor pode navegar até a guia métricas de sua conta na barra lateral esquerda para visualizar todas as métricas em sua conta; as métricas com um ícone Magento 2 são os eventos de ordem sincronizados de suas integrações Magento 2. O senhor também verá Klaviyo eventos de rastreamento no local com um ícone de engrenagem; eles também são rastreados por meio das integrações.

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.
• Value
  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 de moeda usado com o pedido cancelado.
• CartPriceRuleIDs
  Um array de IDs de regras de preço de carrinho (numérico id strings) 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.
• Value
  O valor do pedido.
• Discounted
  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 do armazém onde o pedido foi feito.
• StoreID
  O ID do armazenar onde o pedido foi feito.
• BillingAddress
  O endereço de cobrança do pedido.
• Tracks
  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.
• Categories
  A categoria do produto.
• Discounted
  Quaisquer descontos aplicados ao produto.
• Quantidade
  O número de produtos.
• Value
  O valor do produto.
• ProductID
  O ID do produto.
• RootProductID
  O ID do produto pai.

Pedido feito

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

• ProductCategories
  As categorias dos produtos no pedido.
• Value
  O valor do pedido.
• Discounted
  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
  Um array de IDs de regras de preço de carrinho (numérico id strings) que inclui regras aplicadas automaticamente e a regra para um cupom aplicado.

Pedido reembolsado

Esse evento é acionado quando um cliente reembolsa um pedido. 

• Value
  O valor do pedido.
• Discounted
  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
  Um array de IDs de regras de preço de carrinho (numérico id strings) 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. 
• Items
  Os itens do pedido. 
• ProductCategories
  As categorias dos produtos no pedido. 
• ProductNames
  Os nomes dos produtos no pedido. 
• StoreName
  O nome do armazém onde o pedido foi iniciado.
• StoreID
  O ID do armazenar 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 entrar no cliente.
• AddedItemCategories
  As categorias às quais o item pertence.
• AddedItemProductName
  O nome do produto em seu armazenar (por exemplo, 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 em seu Magento 2 armazenar do produto, por exemplo, 1234.
• AddedItemSKU
  O SKU do item em seu armazém (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 }}

Produto Visualizado

Essa métrica é rastreada quando um cliente visualiza um produto em seu site. O senhor pode filtrar e direcionar o Viewed Product métrica com base nos seguintes critérios:

• ID do produto
  O ID do produto.
• Nome do produto
  O nome do produto.
• SKU
  O SKU do produto.
• URL
  O URL do produto.
• Preço
  O preço do produto.
• FinalPrice
  O preço final após quaisquer descontos.
• Categorias
  Uma matriz que contém as categorias às quais o produto pertence.
• ImageURL
  O URL da imagem do produto.

Ativo no Site

Essa métrica é rastreada quando um cliente está ativo em seu site. O senhor pode filtrar e direcionar o Active on Site métrica com base nos seguintes critérios:

• utm_medium
  O meio para o parâmetro Rastreamento de UTM (por exemplo, Campanha).
• kx_present
  (True ou False) Se o parâmetro kx está presente.
• os
  O sistema operacional do dispositivo do usuário.
• initial_page_path
  O caminho do URL da página inicial em que o usuário chegou.
• navegador
  O tipo de navegador do usuário.
• página
  O URL da página em que o usuário estava ativo.
• campanhas
  O parâmetro Rastreamento de UTM para a Campanha.
• utm_source
  A fonte UTM (por exemplo, Klaviyo).

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.

Valor da receita

É 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