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 o senhor integra as duas plataformas. A integração do Klaviyo com o Magento extrai todos os dados históricos da sua loja Magento no momento da sincronização histórica inicial. Uma vez ativada, a integração 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 são as sincronizadas a partir da integração com o Magento.

Métricas do Magento

Pedido cancelado

Esse evento é rastreado quando um cliente cria um pedido em sua loja Magento, mas depois cancela o pedido antes do atendimento. A Klaviyo rastreia os dados associados, incluindo todas as informações do produto sobre os itens que o usuário comprou. As informações do produto incluem nomes de produtos, imagens e informações de variantes que o senhor pode usar em e-mails de acompanhamento de compras.

O senhor pode filtrar e direcionar eventos de pedidos cancelados com base nos seguintes critérios:

• Valor: Valor total do pedido (subtotal + custo de envio - quaisquer descontos).
• Itens: Os nomes dos produtos no pedido de alguém.
  Ex: camiseta ou calça. Se o pedido for feito várias vezes, serão exibidas várias unidades do mesmo item
• Categorias de itens: O conjunto completo de categorias dos itens no pedido de alguém; (por exemplo, camisetas, homens, calças e venda).
• Contagem de itens: O número 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).
• Discounted (Desconto): Se esse item específico tiver um desconto aplicado (ou seja, verdadeiro/falso).
• Cupom: O código do cupom aplicado.
• Itens exclusivos: O item individual incluído em um pedido (por exemplo, camisetas, shorts). Se vários produtos forem pedidos, o item exclusivo será exibido apenas uma vez.
• Categorias de itens exclusivos: As categorias em que os itens exclusivos são agrupados (por exemplo, masculino, venda).
• Atributos (opcional): Atributos personalizados do produto.

Checkout concluído

Esse evento é rastreado quando um cliente conclui um checkout em sua loja Magento. O evento Checkout Completed (Checkout concluído) não é sincronizado historicamente, portanto, nem sempre é uma medida precisa quando se analisam os totais de eventos ao longo do tempo. Para rastrear a receita e a segmentação, use o evento Placed Order (Pedido feito).

O senhor pode filtrar e direcionar eventos de Checkout Completed com base nos seguintes critérios:

• Valor: O valor total do pedido. 
• Códigos de desconto: Qualquer cupom ou código de desconto aplicado.
• Itens: 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 suas informações de contato e envio na primeira página do processo de checkout do Magento e, em seguida, clica em continuar. O Klaviyo rastreia os dados de produtos relacionados sobre os itens no carrinho de alguém, incluindo nomes de produtos, imagens e informações de variantes que o senhor pode usar em seus e-mails de carrinho abandonado. Esse evento tem uma propriedade de URL de checkout que vincula o carrinho exato de cada cliente e que pode ser usada para reconstruir o carrinho se um cliente abrir o e-mail em um novo dispositivo.

O senhor pode filtrar e direcionar eventos Checkout Started com base nos seguintes critérios:

• Value (Valor): O valor do carrinho no momento do checkout (subtotal + custo de envio - quaisquer descontos).
• Itens: 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): Qualquer cupom ou código de desconto aplicado.
• Total de descontos (opcional): Valor total em dólares de quaisquer cupons ou descontos.

Pedido atendido

Esse evento é rastreado quando o senhor marca um pedido em sua loja Magento como enviado. A Klaviyo rastreia informações relacionadas aos produtos que alguém comprou, incluindo nomes de produtos, imagens e informações de variantes que podem ser usadas em e-mails de acompanhamento da compra.

O senhor pode filtrar e direcionar eventos de Pedidos atendidos com base nos seguintes critérios:

• Valor: Valor total do pedido (subtotal + custo de envio - quaisquer descontos).
• Itens: Os nomes dos produtos no pedido de alguém (por exemplo, camiseta ou calça). Se o pedido for feito várias vezes, aparecerão múltiplos 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 venda).
• Contagem de itens: O número 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).
• Discounted (Desconto): Se esse item específico tiver um desconto aplicado (ou seja, verdadeiro/falso).
• Cupom: O código do cupom aplicado.
• Itens exclusivos: O item individual criado em um pedido (por exemplo, camisetas, shorts). Se vários produtos forem pedidos, o item exclusivo será exibido apenas uma vez.
• Categorias de itens exclusivos: As categorias em que os itens exclusivos são agrupados (por exemplo, masculino, venda).
• Atributos (opcional): Atributos personalizados do produto.

Produto encomendado

Esse evento é rastreado quando um cliente faz seu pedido. Um evento Ordered Product é rastreado para cada item que alguém compra. Por exemplo, se alguém compra uma camiseta e uma calça, um evento de Pedido feito é rastreado e dois eventos de 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 variantes de produtos e outras informações detalhadas que não estão disponíveis no evento Placed Order. O senhor pode filtrar e direcionar eventos Ordered Product com base nos seguintes critérios:

• Valor: Preço total do item (não inclui custos de remessa ou quaisquer descontos obtidos).
• Nome: O nome dado a esse item específico.
• SKU: A SKU específica atribuída para rastrear um item (por exemplo, REDMEDIUMTSHIRT).
• Categorias: O conjunto completo das coleções dos produtos no pedido de alguém (por exemplo, camisetas, homens, calças e venda).
• 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 paga por um item com base no país (por exemplo, USD, EUR). 
• Discounted (Desconto): Se esse item específico tiver um desconto aplicado (ou seja, verdadeiro ou falso).
• ProductID: ID de um produto específico em sua loja.
• Quantidade: Quantidade pedida.
• Atributos (opcional): Atributos personalizados do produto.

Pedido feito

Esse evento é rastreado quando um cliente conclui o processo de checkout e cria um pedido em sua loja Magento. A Klaviyo rastreia dados relacionados, inclusive informações sobre os itens que alguém comprou, incluindo nomes de produtos, imagens e informações de variantes que o senhor pode usar em e-mails de acompanhamento da compra. O senhor pode filtrar e direcionar eventos de Placed Order com base nos seguintes critérios:

• Valor: Valor total do pedido (subtotal + frete - quaisquer descontos).
• Itens: Os nomes dos produtos no pedido de alguém, por exemplo: camiseta ou calça. Se o pedido for feito várias vezes, serão exibidas 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 venda).
• Contagem de itens: O número 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).
• Discounted (Desconto): Se esse item específico tiver um desconto aplicado (ou seja, verdadeiro/falso).
• Cupom: O código do cupom aplicado.
• Itens exclusivos: O item individual criado em um pedido (por exemplo, camisetas, shorts). Se vários produtos forem pedidos, o item exclusivo será exibido apenas uma vez.
• Categorias de itens exclusivos: As categorias em que os itens exclusivos são agrupados (por exemplo, masculino, venda).
• Atributos (opcional): Até 10 atributos de produtos personalizados podem ser sincronizados para pedidos feitos. Essa sincronização precisa ser ativada antes que os dados de atributos personalizados sejam transferidos para sua conta da Klaviyo. Consulte 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 do cupom aplicado.
• Código da moeda: A moeda específica paga por um item com base no país (por exemplo, USD, EUR).
• Discounted (Desconto): Se esse item específico teve um desconto aplicado (ou seja, verdadeiro/falso).
• Categorias de itens: O conjunto completo de categorias dos itens no pedido de alguém (por exemplo, camisetas, masculino, calças e venda).
• Contagem de itens: O número de itens no pedido (por exemplo, 2).
• Itens: Os nomes dos produtos no pedido de alguém (por exemplo, camiseta ou calça). Se o pedido for feito várias vezes, serão exibidas várias unidades do mesmo item.
• Categorias de itens exclusivos: As categorias em que os itens exclusivos são agrupados (por exemplo, masculino, venda).
• 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.

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

O pagamento está disponível como uma propriedade de segundo nível no campo extra. O senhor não pode filtrar as propriedades de segundo nível para segmentação, mas pode usar esses dados como uma variável de evento em seus modelos de e-mail.

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

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

Sincronizar atributos personalizados de produtos para pedidos feitos

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

Localize os IDs de produtos personalizados no painel de administração do Magento acessando Catalog > Attributes > Manage Attributes e clicando no atributo.

O ID pode ser encontrado na url da seguinte forma: 

Verificar seus dados de pedidos sincronizados

O Klaviyo importa todos os seus dados do Magento. Para verificar isso, o senhor 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, 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 verificar a configuração do fuso horário:

1. Clique no nome da sua organização no canto inferior esquerdo.
2. Clique em Settings.
3. Selecione a organização.

O senhor pode observar que o valor Revenue no painel do Klaviyo nem sempre corresponde ao valor da receita que você vê no Magento; isso ocorre porque o Klaviyo não subtrai os pedidos cancelados e reembolsados do nosso cálculo de receita.

// 
// FEZ O PEDIDO
// ------------------------------------------

{
  "token": "PUBLIC_API_KEY",
  "service": "magento",
  "evento": "Placed Order",
  "customer_properties": {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties": {
   "$event_id": "1234",
   "$value": 29.98,
   "$extra": {},
   "Código da moeda": "USD",
   "Contagem de itens": 2,
   "Itens": ["Winnie the Pooh, "A Tale of Two Cities"], // Se um item for solicitado mais de uma vez, duplique-o. Por exemplo, se alguém encomendar duas camisetas, isso seria: ["T-Shirt", "T-Shirt"]
   "Discounted": true,
   "Cupom": "COUPON123",
   "Itens exclusivos": ["Winnie the Pooh", "A Tale of Two Cities"],
   "Categorias de item": ["Ficção", "Clássicos", "Crianças"],
   "Unique Item Categories": ["Fiction", "Classics", "Children"]
  },
  "tempo": 1387302423
}

// 
// PRODUTO ENCOMENDADO
// ------------------------------------------

{
  "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 (exclusivo)
   "$value": 9.99,
   "Código da moeda": "USD",
   "Nome": "Winnie the Pooh",
   "SKU": "WINNIEPOOH,
   "ProductID": "567",
   "Categorias": ["Ficção", "Clássicos"],
   "Preço": 9.99,
   "Desconto": verdadeiro,
   "Cost": 5.00, // (opcional),
   "Atributo: Color": "Red" // atributos do produto (opcional)
   "$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
// ------------------------------------------

{
  "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": {},
   "Código da moeda": "USD",
   "Contagem de itens": 2,
   "Itens": ["Winnie the Pooh, "A Tale of Two Cities"], // Se um item for solicitado mais de uma vez, duplique-o. Por exemplo, se alguém encomendar duas camisetas, isso seria: ["T-Shirt", "T-Shirt"]
   "Discounted": true,
   "Cupom": "COUPON123",
   "Itens exclusivos": ["Winnie the Pooh", "A Tale of Two Cities"],
   "Categorias de item": ["Fiction", "Classics", "Children"],
   "Unique Item Categories": ["Fiction", "Classics", "Children"]
  },
  "tempo": 1387302423
}

Recursos adicionais

• Como fazer a integração com o Magento 1.x (CE e EE)
• Referência dos requisitos do sistema de integração Magento