Referência de dados do Magento 2

Saiba quais dados a Klaviyo importa da sua loja Magento 2 quando você integra as duas plataformas. A sincronização histórica inicial importa até 5 anos de dados de pedidos e clientes, incluindo informações associadas a pedidos feitos e atendidos no passado. Depois de ativada, a integração também sincroniza os dados de pedidos e clientes a cada 30 minutos.

No Klaviyo, navegue até Análises > Métricas na barra lateral esquerda para ver todas as métricas da sua conta; as métricas com um ícone do Magento 2 são os eventos sincronizados da sua integração do Magento 2. Você também verá eventos de rastreamento no site do Klaviyo com um ícone de engrenagem; eles também são rastreados por meio da integração.

Como a Klaviyo determina as métricas do Magento 2

Métricas do pedido

A Klaviyo registra um evento de Pedido realizado para cada pedido que ela sincroniza. Ela também usa o Status atual do pedido e o histórico de status no Magento 2 para registrar métricas adicionais do pedido.

Quando um pedido é criado ou atualizado, a Klaviyo verifica o status atual e o histórico de status. A tabela abaixo mostra os mapeamentos padrão. Pedidos com pending_payment ou um status personalizado configurado para ser ignorado são excluídos.

Se você tiver status de pedido personalizados que não devem acionar a métrica Pedido feito ou não estiverem alinhados com a tabela acima, conte para a gente para que possamos configurar os status personalizados para ignorar ou mapear para eventos de pedido adicionais.

Pedidos com o status de "pending_payment" serão ignorados.

Métrica Checkout iniciado

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

O evento Started Checkout depende de um carrinho (chamado de orçamento no Magento) com um endereço de e-mail associado. A Klaviyo sincroniza isso apenas se o carrinho ainda estiver com atividade e contiver itens quando a sincronização for executada.

Se o cliente concluir o pedido antes de o carrinho sincronizar, o carrinho não fica mais com atividade e a Klaviyo o ignora. Um evento Placed Order é registrado quando o pedido sincroniza, a menos que o status dele seja ignorado. Um evento Started Checkout que já foi sincronizado permanece na Klaviyo. Observe que pode levar até 1 hora para os eventos Started Checkout sincronizarem com a Klaviyo.

Métrica Remessa Atendida

Essa métrica é acionada quando uma nova Remessa é criada na sua loja do Magento 2.

Dados de métrica do Magento 2

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

Pedido Cancelado

Este evento é acionado quando o status de um pedido é alterado para cancelado ou cancelado na sua loja da Magento 2.

• Categorias do produto
  As categorias dos produtos no pedido cancelado.
• Valor
  O valor do pedido cancelado.
• Com desconto
  (Verdadeiro ou falso) O status do desconto do pedido cancelado.
• ProductNames
  Os nomes dos produtos no pedido cancelado.
• ItemCount
  O número de itens de linha no pedido, não a quantidade total de unidades.
• OrderCurrencyCode
  O código da moeda usado com o pedido cancelado.
• CartPriceRuleIDs
  Uma matriz de IDs de regra de preço do carrinho (strings de IDs numéricos) que incluem regras aplicadas automaticamente e a regra de um cupom aplicado.
• external_catalog_id
  Utilizado na organização do catálogo na Klaviyo.

Pedido Atendido

Esse evento é rastreado quando você define o status de um pedido como concluído na sua loja da Magento 2.

• Categorias de produtos
  As categorias dos produtos no pedido.
• Valor
  O valor do pedido.
• Com desconto
  Se o pedido tem desconto ou não.
• ProductNames
  Os nomes dos produtos no pedido.
• ItemCount
  O número de itens de linha no pedido, não a quantidade total de unidades.
• OrderCurrencyCode
  O código da moeda usado com o pedido.
• external_catalog_id
  Utilizado na organização do catálogo na Klaviyo.

Remessa Atendida

Esse evento é rastreado quando uma nova Remessa é criada na sua loja da Magento 2.

• StoreName
  O nome da loja em que o pedido foi feito.
• ID da loja
  O ID da loja em que o pedido foi feito.
• BillingAddress
  O endereço de cobrança do pedido.
• Rastreamento
  Informações sobre rastreamento de envios.
• external_catalog_id
  Utilizado na organização do catálogo na Klaviyo.

Produto Encomendado

A Klaviyo registra 1 evento Ordered Product por unidade solicitada, até 100 eventos por item de linha. Por exemplo, um pedido de 3 unidades da mesma camiseta gera 3 eventos Ordered Product, cada um com uma Quantity de 1. Para produtos vendidos em quantidades fracionárias, a Klaviyo registra 1 evento com a quantidade solicitada.

• 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
  (Verdadeiro ou falso) Se um desconto foi aplicado ao produto.
• Quantidade
  A quantidade representada por este evento: 1 para compras de unidades inteiras ou a quantidade pedida para produtos vendidos em quantidades fracionárias.
• Valor
  O valor do produto.
• ProductID
  A ID do produto.
• RootProductID
  O ID do produto pai.
• external_catalog_id
  Utilizado na organização do catálogo na Klaviyo.

Pedido Realizado

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

• Categorias de produtos
  As categorias dos produtos no pedido.
• Valor
  O valor do pedido.
• Com desconto
  Se o pedido tem desconto ou não.
• ProductNames
  Os nomes dos produtos no pedido.
• ItemCount
  O número de itens de linha no pedido, não a quantidade total de unidades.
• OrderCurrencyCode
  O código da moeda usado com o pedido.
• CartPriceRuleIDs
  Uma matriz de IDs de regra de preço do carrinho (strings de IDs numéricos) que incluem regras aplicadas automaticamente e a regra de um cupom aplicado.
• external_catalog_id
  Utilizado na organização do catálogo na Klaviyo.

Pedido Reembolsado

Este evento é acionado quando o status de um pedido é fechado no Magento 2. Um reembolso parcial que deixa o pedido em outro status não aciona o evento Pedido reembolsado por meio do mapeamento de status padrão.

• Valor
  O valor do pedido.
• Com desconto
  Se o pedido tem desconto ou não.
• Nomes dos produtos
  Os nomes de todos os produtos no pedido.
• ItemCount
  O número de itens de linha no pedido, não a quantidade total de unidades.
• OrderCurrencyCode
  O código da moeda usado com o pedido.
• Categorias de produtos
  As categorias dos produtos no pedido.
• CartPriceRuleIDs
  Uma matriz de IDs de regra de preço do carrinho (strings de IDs numéricos) que incluem regras aplicadas automaticamente e a regra de um cupom aplicado.
• external_catalog_id
  Utilizado na organização do catálogo na Klaviyo.

Checkout Iniciado

Este evento é acionado quando um cliente com um endereço de e-mail conhecido inicia um checkout e o carrinho ainda está com atividade, com itens, quando a Klaviyo o sincroniza. Em uma página de checkout padrão, o cliente insere as informações de contato e envio e clica em Continuar. Se ele concluir o checkout antes de o carrinho ser sincronizado, a Klaviyo ignora Started Checkout e registra Placed Order quando o pedido é sincronizado, a menos que o status dele seja ignorado. Concluir um pedido não remove um evento Started Checkout que já foi sincronizado.

• Value
  O valor do pedido durante o checkout.
• ItemCount
  Quantidade de itens de linha no carrinho, não a quantidade total de unidades.
• Itens
  Os itens no pedido.
• Categorias de produtos
  As categorias dos produtos no pedido.
• ProductNames
  Os nomes dos produtos no pedido.
• StoreName
  O nome da loja onde o pedido foi iniciado.
• StoreID
  O ID da loja em que o pedido foi iniciado.
• external_catalog_id
  Utilizado na organização do catálogo na Klaviyo.

Adicionado ao Carrinho

Observe que essa métrica só é rastreada se você estiver usando a versão 4.0.0 ou superior da extensão da Klaviyo. Essa métrica é rastreada quando um cliente que recebeu cookie da Klaviyo adiciona um item ao carrinho.

Ela inclui informações detalhadas sobre o item que foi adicionado. Isso é útil ao criar segmentos com base nos produtos que os usuários adicionaram ao carrinho ou ao criar um fluxo de carrinho abandonado. Você pode filtrar e segmentar métricas de Adicionado ao carrinho com base nos seguintes critérios:

• MaskedQuoteId
  MaskedQuoteId ou identificador único para clientes conectados.
• AddedItemCategories
  As categorias às quais o item pertence.
• AddedItemProductName
  O nome do produto na sua loja (por exemplo, camiseta vermelha).
• AddedItemDescription
  A descrição do item.
• AddedItemImageURLKey
  A URL da imagem do item.
• AddedItemPrice
  O preço do item.
• AddedItemProductID
  O ID personalizado na sua loja Magento 2 do produto, por exemplo, 1234.
• AddedItemSKU
  O SKU do item na sua loja (por exemplo, REDMEDIUMTSHIRT).
• AddedItemURL
  O URL do item.
• external_catalog_id
  Utilizado na organização do catálogo na Klaviyo.
• chave_de_integração
  Sua plataforma de e-commerce (Magento 2).

Use o valor MaskedQuoteId do evento Added To Cart para criar um link que recria o carrinho do cliente quando ele voltar de um e-mail em outro dispositivo. Use o seguinte URL:

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

Produto Visualizado

Essa métrica é registrada quando um cliente visualiza um produto no seu site e a Klaviyo consegue identificar essa visualização. Você pode filtrar e segmentar métricas de Produto Visualizado com base nos seguintes critérios:

• ProductID
  A ID do produto.
• Nome
  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 contendo as categorias às quais o produto pertence.
• ImageURL
  A URL da imagem do produto.
• external_catalog_id
  Utilizado na organização do catálogo na Klaviyo.
• chave_de_integração
  Sua plataforma de e-commerce (Magento 2).

Ativo no Site

Essa métrica é rastreada quando um cliente que a Klaviyo consegue identificar está com atividade no seu site. Você pode usar a atividade Com atividade no site em segmentos e fluxos, mas as propriedades de evento abaixo não estão disponíveis para filtros de segmento ou de fluxo. Você pode inspecioná-las nos dados brutos do evento:

• utm_medium
  O meio do parâmetro de rastreamento de UTM (por exemplo, campanha).
• kx_present
  Verdadeiro quando o parâmetro kx está presente no URL. O campo é omitido quando o parâmetro está ausente.
• 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.
• browser
  O tipo de navegador do usuário.
• página
  O URL da página em que o usuário esteve com atividade.
• utm_campaign
  O parâmetro de Rastreamento de UTM da campanha.
• utm_source
  A origem da UTM (por exemplo, Klaviyo).

Dados sincronizados do cliente

A Klaviyo cria ou atualiza perfis a partir de pedidos sincronizados, registros de clientes e checkouts iniciados. As informações a seguir são adicionadas quando estiverem disponíveis nos dados de origem:

• E-mail
• Nome e sobrenome
• Cidade, estado/região, CEP, país
• Telefone
• Conta do Magento criada (ex.: YYYY-MM+-dd hh:mm:ss; 2015-05-21 13:04:00)
• Grupo de clientes do Magento (ex.: atacado)
• Loja Magento (por exemplo, Loja dos EUA)
• Data de nascimento (por exemplo, YYYY-mm-dd; 1990-03-25)
• Gênero

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

Valor da receita

Quando você usa a métrica Placed Order do Magento 2 para medir a receita, os pedidos cancelados e reembolsados não são subtraídos automaticamente. Isso pode fazer com que a receita mostrada no Klaviyo seja diferente da receita mostrada no Magento.

Recursos adicionais