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 integração da Klaviyo com o Magento 2 importa todos os dados históricos da sua loja Magento 2 com a sincronização histórica inicial. Depois de ativada, a integração também começará a sincronizar os dados de pedidos e clientes a cada 30 minutos. Exemplos desses dados incluem as informações associadas a pedidos feitos no passado, pedidos atendidos etc.

No Klaviyo, você pode navegar até a aba Análises da sua conta 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 de pedido sincronizados da sua integração com o Magento 2. Você também verá eventos de rastreamento onsite do Klaviyo com um ícone de engrenagem; eles também são rastreados pela integração.

Como a Klaviyo determina as métricas do Magento 2

Métricas do pedido

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

Sempre que um pedido for criado ou o status dele for atualizado, ele será avaliado em relação à matriz abaixo para determinar quais eventos devem ser acionados.

Status do pedido do Magento	Métrica disparada na Klaviyo
concluído	Pedido Atendido
cancelado, cancelado	Pedido Cancelado
pagamento_cancelado	Pagamento cancelado
Fechadas	Pedido Reembolsado
Todos os outros status do pedido	Pedido Realizado

Se você tiver status de pedido personalizados que não devem acionar uma métrica Pedido feito ou não se alinharem à tabela acima, avise a gente e podemos ajustar o mapeamento de status do pedido adequadamente na sua integração.

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 da criação de um "Orçamento" e de ter um endereço de e-mail associado a ele. Isso acontece depois que o cliente insere o endereço de e-mail na etapa "Informações de envio" do checkout. Se um cliente não concluir o checkout, esse orçamento é sincronizado com a Klaviyo como um evento Started Checkout.

Se o cliente continuar e concluir o pedido, esse orçamento é convertido em uma "fatura" no banco de dados do Magento. Como resultado, um evento de Iniciou o checkout não é enviado ao Klaviyo. Em vez disso, é enviado um evento de Fez um pedido. Observe que pode levar até 1 hora para que os eventos de Iniciou o checkout sejam sincronizados com o 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 cada uma das métricas do Magento 2 e os dados disponíveis para filtrar 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.
• 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 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.
• OrderedProducts Os nomes dos produtos no pedido.
• OrderedProductCount O número de produtos no pedido.
• 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

Esse evento é rastreado uma vez para cada produto que um usuário pede 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 Todos os descontos aplicados ao produto.
• Quantidade O número de produtos.
• 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.

A métrica Ordered Product tem vários outros campos de dados disponíveis para rastreamento. Ver os dados brutos de um evento Ordered Product individual para ver todos os dados disponíveis para esse evento.

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.
• OrderedProducts Os nomes dos produtos no pedido.
• OrderedProductCount O número de produtos no pedido.
• 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 um cliente reembolsa um pedido.

• Valor O valor do pedido.
• Com desconto Se o pedido tem 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 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. Em uma página de checkout padrão, esse evento é acionado quando um cliente insere as informações de contato e envio na primeira página do processo de checkout do Magento e clica em Continuar. Um evento Started Checkout não é enviado para a Klaviyo se o usuário concluir o checkout. Em vez disso, um evento Placed Order é registrado.

• Value O valor do pedido durante o checkout.
• ItemCount A quantidade de itens no pedido.
• 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).

A Klaviyo gera uma chave, a chave de reconstrução do carrinho, que permite criar um link que reconstrói o carrinho do cliente caso ele volte ao carrinho por um e-mail acionado por esse evento em outro dispositivo. Essa chave pode ser encontrada dentro da matriz de propriedades "extra". Você 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 no seu site. Você pode filtrar e segmentar métricas de Viewed Product 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 é registrada quando um cliente está com atividade no seu site. Você pode filtrar e segmentar métricas de com atividade no site com base nos seguintes critérios:

• utm_medium O meio do parâmetro de 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.
• 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 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 perfil do Klaviyo 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
• Telefone
• Conta do Magento criada (ex.: YYY-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.

O Website_ID não será coletado. As supressão não são copiadas para a Klaviyo, portanto não estarão na plataforma da Klaviyo.

A Klaviyo não consegue coletar locais de imagem personalizados.

Valor da receita

Você pode notar que o valor de receita no seu painel da Klaviyo nem sempre corresponde ao valor de receita que você vê no Magento; isso acontece porque a Klaviyo não subtrai pedidos cancelados e reembolsados do nosso cálculo de receita.