Referência de dados do Magento 1

O que você vai aprender

Saiba quais dados do Magento 1 são importados para o Klaviyo quando você integra as duas plataformas. A integração do Klaviyo com o Magento traz todos os dados históricos da sua loja Magento no momento da sua sincronização histórica inicial. Depois de ativada, a integração começará a sincronizar métricas e dados do cliente quase em tempo real. Exemplos desses dados incluem as informações associadas a pedidos feitos no passado, pedidos atendidos etc.

Na Klaviyo, você pode acessar a guia Análises da sua conta na barra lateral esquerda para ver todas as métricas na sua conta; as métricas com um ícone da Magento são as que são sincronizadas a partir da sua integração com a Magento.

Métricas do Magento

Pedido Cancelado

Esse evento é rastreado quando um cliente cria um pedido na sua loja Magento, mas depois cancela o pedido antes do cumprimento. A Klaviyo rastreia os dados associados, incluindo todas as informações do produto sobre os itens que alguém comprou. As informações do produto incluem nomes de produtos, imagens e informações de variante que você pode usar em e-mails de acompanhamento de compra.

Você pode filtrar e segmentar eventos de Pedido Cancelado com base nos seguintes critérios:

• Valor: Valor total do pedido (subtotal + custo de frete - quaisquer descontos).
• Items: Os nomes dos produtos no pedido de alguém.
  ex: camiseta ou calça. Se for pedido várias vezes, vai mostrar vários do mesmo item
• Categorias de itens: O conjunto completo de categorias dos itens no pedido de alguém (por exemplo, camisetas, masculino, calças e promoção).
• Contagem de itens: o número de itens no pedido (por exemplo, 2).
• Código da moeda: a moeda específica usada no pagamento de um item com base no país (ex.: USD, EUR).
• Com desconto: se este item específico tem um desconto aplicado (ou seja, verdadeiro/falso).
• Cupom: O código de cupom aplicado.
• Itens únicos: O item individual incluído em um pedido (por exemplo, camisetas, shorts). Se vários produtos forem pedidos, o item único será exibido apenas uma vez.
• Categorias únicas de itens: As categorias em que os itens únicos são agrupados (ex.: masculino, promoção).
• Atributos (opcional): Atributos de produto personalizados.

Checkout Concluído

Esse evento é rastreado quando um cliente conclui um checkout na sua loja Magento. O evento Checkout Completed não é sincronizado historicamente, por isso nem sempre é uma medida precisa ao analisar o total de eventos ao longo do tempo. Para rastreamento de receita e segmentação, use o evento Placed Order.

Você pode filtrar e segmentar eventos de Checkout Concluído com base nos seguintes critérios:

• Valor: O valor total do pedido.
• Códigos de desconto: quaisquer cupons ou códigos de desconto aplicados.
• Items: Os nomes dos produtos no carrinho de alguém (por exemplo, camiseta ou calça).
• Contagem de itens: A quantidade total de itens no carrinho de alguém.
• Total de descontos (opcional): Valor total em dólares de quaisquer cupons ou descontos.

Checkout Iniciado

Esse evento é rastreado quando um cliente insere as informações de contato e envio na primeira página do processo de checkout da Magento e então clica em continuar. A Klaviyo rastreia dados de produtos relacionados sobre itens no carrinho de uma pessoa, incluindo nomes de produtos, imagens e informações de variante, que você pode usar nos seus e-mails de carrinho abandonado. Esse evento tem uma propriedade de URL de checkout que leva de volta ao carrinho exato de cada cliente e pode ser usada para recriar o carrinho caso um cliente abra o e-mail em um novo dispositivo.

Você pode filtrar e segmentar eventos de Checkout Iniciado com base nos seguintes critérios:

• Valor: o valor do carrinho no momento do checkout (subtotal + custo de frete - quaisquer descontos).
• Items: Os nomes dos produtos no carrinho de alguém (por exemplo, camiseta ou calça).
• Contagem de itens: A quantidade total de itens no carrinho de alguém.
• Códigos de desconto (opcional): quaisquer cupons ou códigos de desconto aplicados.
• Total de descontos (opcional): Valor total em dólares de quaisquer cupons ou descontos.

Pedido Atendido

Esse evento é rastreado quando você marca um pedido na sua loja Magento como enviado. O Klaviyo rastreia informações de produtos relacionadas aos itens que alguém comprou, incluindo nomes de produtos, imagens e informações de variante que podem ser usadas em e-mails de acompanhamento pós-compra.

Você pode filtrar e segmentar eventos de Pedido Cumprido com base nos seguintes critérios:

• Valor: Valor total do pedido (subtotal + custo de frete - quaisquer descontos).
• Items: Os nomes dos produtos no pedido de alguém (por exemplo, t-shirt ou pants). Se o item for pedido várias vezes, aparecerão várias unidades do mesmo item.
• Categorias de itens: O conjunto completo de categorias dos itens no pedido de alguém (por exemplo, camisetas, masculino, calças e promoção).
• Quantidade de itens: a quantidade de itens no pedido. (por exemplo, 2).
• Código da moeda: A moeda específica paga por um item com base no país (por exemplo, USD, EUR).
• Com desconto: se este item específico tem um desconto aplicado (ou seja, verdadeiro/falso).
• Cupom: O código de cupom aplicado.
• Itens exclusivos: O item individual criado em um pedido (por exemplo, camisas, shorts). Se vários produtos forem pedidos, o item exclusivo será exibido apenas uma vez.
• Categorias únicas de itens: As categorias em que os itens únicos são agrupados (ex.: masculino, promoção).
• Atributos (opcional): Atributos de produto personalizados.

Produto Encomendado

Esse evento é rastreado quando um cliente faz um pedido. Um evento Produto pedido é rastreado para cada item que alguém compra. Por exemplo, se alguém compra uma camiseta e uma calça, um evento Pedido realizado é rastreado e dois eventos Produto pedido são registrados: um evento para a camiseta e um evento para a calça.

O evento Ordered Product inclui informações detalhadas sobre cada produto que alguém compra. Isso é útil ao criar segmentos comportamentais com base em opções de variante do produto e outras informações detalhadas que não estão disponíveis no evento Pedido Realizado. Você pode filtrar e segmentar eventos de Pedido Realizado com base nos seguintes critérios:

• Valor: preço total do item (não inclui custos de envio nem descontos aplicados).
• Nome: O nome dado a este item específico.
• SKU: o SKU específico atribuído para rastrear um item (por exemplo, REDMEDIUMTSHIRT).
• Categories: Todas as coleções de produtos no pedido de alguém (por exemplo, camisetas, masculino, calças e promoção).
• Preço: O valor em dólares do produto específico (por exemplo, camisas 25,50, sapatos 50,25).
• Custo: O custo para fabricar um produto (por exemplo, camisas 13,85, sapatos 20,00).
• Código da moeda: A moeda específica usada para pagar um item com base no país (por exemplo, USD, EUR).
• Com desconto: Se este item específico tem um desconto aplicado (ou seja, verdadeiro ou falso).
• ProductID: ID de um produto específico na sua loja.
• Quantidade: Quantidade solicitada.
• Atributos (opcional): Atributos de produto personalizados.

Pedido Realizado

Este evento é rastreado quando um cliente conclui o processo de checkout e cria um pedido na sua loja na Magento. O Klaviyo rastreia dados relacionados, incluindo informações do produto sobre os itens que alguém comprou, incluindo nomes de produtos, imagens e informações de variante, que você pode usar em e-mails de acompanhamento de compra. Você pode filtrar e segmentar eventos de Placed Order com base nos seguintes critérios:

• Valor: valor total do pedido (subtotal + frete - quaisquer descontos).
• Items: Os nomes dos produtos no pedido de alguém, por exemplo, camiseta ou calça. Se for pedido várias vezes, mostrará vários do mesmo item.
• Categorias do item: Todas as categorias dos itens no pedido de alguém (por exemplo, camisetas, masculino, calças e promoção).
• Item Count: A quantidade de itens no pedido (por exemplo, 2).
• Código da moeda: a moeda específica paga por um item com base no país (ex.: USD, EUR).
• Com desconto: se este item específico tem um desconto aplicado (ou seja, verdadeiro/falso).
• Cupom: O código de cupom aplicado.
• Itens únicos: o item individual criado em um pedido (por exemplo, camisas, shorts). Se vários produtos forem pedidos, o item exclusivo será exibido apenas uma vez.
• Categorias Exclusivas de Itens: As categorias nas quais os itens exclusivos são agrupados (por exemplo, masculino, liquidação).
• Atributos (opcional): até 10 atributos personalizados de produto podem ser sincronizados para pedidos realizados. Essa sincronização precisa ser ativada antes que os dados de atributos personalizados sejam enviados para a sua conta do Klaviyo. Veja a seção abaixo sobre como configurar isso.

Pedido Reembolsado

Esse evento é rastreado quando um pedido é reembolsado no Magento.

• Valor: valor total do pedido (subtotal + frete - quaisquer descontos).
• Cupom: O código de cupom aplicado.
• Código da moeda: a moeda específica paga por um item com base no país (ex.: USD, EUR).
• Com desconto: se este item específico teve um desconto aplicado (ou seja, verdadeiro/falso).
• Categorias do item: Todas as categorias dos itens no pedido de alguém (por exemplo, camisetas, masculino, calças e promoção).
• Contagem de itens: O número de itens no pedido (por exemplo, 2).
• Items: Os nomes dos produtos no pedido de alguém (por exemplo, t-shirt ou pants). Se for pedido várias vezes, mostrará vários do mesmo item.
• Categorias exclusivas de itens: as categorias nas quais itens exclusivos são agrupados (por exemplo, masculino, promoção).
• Itens únicos: O item individual criado em um pedido, por exemplo: camisetas, shorts. Se vários produtos forem solicitados, o item único será exibido apenas uma vez.

A receita, ou valor de Placed Order, é calculada da seguinte forma: (preço dos pedidos + frete - descontos). Para filtrar um segmento com base em $value, filtre o segmento usando Receita.

Payment está disponível como uma propriedade de segundo nível no campo extra. Você não pode filtrar propriedades de segundo nível para segmentação, mas pode usar esses dados como uma variável de evento nos seus modelos de e-mail.

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 (por exemplo, 2015-05-01 00:00:00)
• Grupo de clientes do Magento (ex.: atacado)
• Loja Magento (por exemplo, Loja dos EUA)
• Data de nascimento (ex.: 1990-01-01)
• Gênero
• website_ID não será extraído
• As supressões não são copiadas para a Klaviyo, portanto, não estarão na plataforma Klaviyo

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

Sincronize atributos personalizados do produto para pedidos feitos

O Klaviyo pode sincronizar até 10 atributos personalizados do produto para a métrica Placed Order. Os atributos personalizados do produto não serão inseridos automaticamente no Klaviyo; no entanto, você pode solicitar que o Klaviyo os importe. Para fazer isso, você deve coletar o ID do atributo personalizado (instruções abaixo) e enviar uma solicitação para nossa equipe de suporte.

Encontre os IDs de produto personalizados no painel de Administrador do Magento acessando Catalog > Attributes > Manage Attributes e clicando no atributo.

O ID pode ser encontrado na URL assim:

Verifique seus dados de pedido sincronizados

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

Passe o mouse sobre o ponto de dados de ontem ou consulte a tabela de dados abaixo do gráfico para ver quantos pedidos você teve ontem. Compare esse número com o que está armazenado no Magento e você verá que eles correspondem exatamente. Se não corresponderem, o problema mais provável é que o fuso horário da sua conta da Klaviyo não corresponde ao fuso horário do Magento. Para verificar sua configuração de fuso horário:

1. Clique no nome da sua organização no canto inferior esquerdo.
2. Clique em Configurações.
3. Selecione Organização.

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.

Propriedades para pedidos do magento sincronizados

Abaixo estão exemplos de payloads JSON para as métricas Pedido realizado, Produto pedido e Pedido atendido que correspondem às propriedades que armazenamos para pedidos sincronizados pela API SOAP do Magento.

Isso é útil para enviar as propriedades corretas de pedidos que serão combinadas com os dados de pedidos do Magento.

Pedido Realizado

// 
// PLACED ORDER
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Placed Order",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "1234",
    "$value" : 29.98,
    "$extra" : {},
    "Currency Code" : "USD",
    "Item Count" : 2,
    "Items" : ["Winnie the Pooh", "A Tale of Two Cities"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "Discounted" : true,
    "Coupon" : "COUPON123",
    "Unique Items" : ["Winnie the Pooh", "A Tale of Two Cities"],
    "Item Categories" : ["Fiction", "Classics", "Children"],
    "Unique Item Categories" : ["Fiction", "Classics", "Children"]
  },
  "time" : 1387302423
}

Produto Encomendado

// 
// ORDERED PRODUCT
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Ordered Product",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "123456789", // LineId (unique)
    "$value" : 9.99,
    "Currency Code" : "USD",
    "Name" : "Winnie the Pooh",
    "SKU" : "WINNIEPOOH",
    "ProductID" : "567",
    "Categories" : ["Fiction", "Classics"],
    "Price" : 9.99,
    "Discounted" : true,
    "Cost" : 5.00, // (optional),
    "Attribute: Color" : "Red" // product attributes (optional)
    "$extra" : {
        "Product URL Key" : "winnie-pooh",
        "Product URL" : "https://www.store.com/winnie-pooh",
        "Image URL" : "https://cnd.store.com/images/winnie-pooh.png",
    }
  },
  "time" : 1387302423
}

Pedido Atendido

// 
// FULFILLED ORDER
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Fulfilled Order",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "1234",
    "$value" : 29.98,
    "$extra" : {},
    "Currency Code" : "USD",
    "Item Count" : 2,
    "Items" : ["Winnie the Pooh", "A Tale of Two Cities"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "Discounted" : true,
    "Coupon" : "COUPON123",
    "Unique Items" : ["Winnie the Pooh", "A Tale of Two Cities"],
    "Item Categories" : ["Fiction", "Classics", "Children"],
    "Unique Item Categories" : ["Fiction", "Classics", "Children"]
  },
  "time" : 1387302423
}

Recursos adicionais