Referência de dados do Magento 1

O que você vai aprender

Saiba quais dados a sua integração existente com o Magento 1 sincroniza com o Klaviyo, incluindo pedidos históricos, registros de clientes e produtos. Após a sincronização histórica inicial, pedidos, clientes e produtos são sincronizados a cada 30 minutos.

No Klaviyo, navegue até Análises > Métricas na barra lateral esquerda para ver as métricas da sua conta. As métricas com um ícone do Magento são sincronizadas a partir das suas integrações do 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.

Esses eventos incluem os seguintes dados de pedidos. Você pode usar propriedades de nível superior para filtrar e segmentar eventos; detalhes de atributos em extra ficam disponíveis para o conteúdo das mensagens.

• Valor: O total geral do pedido no Magento, incluindo impostos e frete após os descontos.
• Itens: os nomes dos produtos de cada item de linha do pedido (por exemplo, camiseta ou calça). Um nome pode aparecer mais de uma vez se aparecer em itens de linha separados.
• Categorias de itens: As categorias dos produtos no pedido (por exemplo, camisetas, masculino, calças e promoção).
• Contagem de itens: O número de itens de linha no pedido (por exemplo, 2). Isso não é a soma das quantidades pedidas.
• Código da moeda: O código da moeda do pedido (ex.: USD ou EUR).
• Com desconto: se um desconto foi aplicado ao pedido (verdadeiro ou falso).
• Cupom: O código de cupom aplicado.
• Itens únicos: os nomes dos produtos no pedido, com duplicatas removidas (por exemplo, camisas ou shorts).
• Categorias únicas de itens: As categorias de produto no pedido, com duplicatas removidas (por exemplo, masculino ou promoção).
• Atributos (opcional): Atributos do produto nos detalhes do item em extra. Use eventos de Produto pedido para filtrar por atributos individuais do produto.

Checkout Concluído

Esse evento é rastreado quando um cliente conclui o checkout na sua loja Magento. Os eventos de Checkout concluído não são sincronizados historicamente, então os totais talvez não reflitam todos os checkouts anteriores. Use eventos Placed Order para relatórios de receita e segmentação.

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

Com os status padrão de pedidos do Magento, esse evento é rastreado quando um pedido atinge o status concluído. O Klaviyo rastreia informações de produtos relacionados sobre os itens que alguém comprou, incluindo nomes de produtos, imagens e informações de variantes que você pode usar em e-mails de acompanhamento de compra.

Esses eventos incluem os seguintes dados de pedidos. Você pode usar propriedades de nível superior para filtrar e segmentar eventos; detalhes de atributos em extra ficam disponíveis para o conteúdo das mensagens.

• Valor: O total geral do pedido no Magento, incluindo impostos e frete após os descontos.
• Itens: os nomes dos produtos de cada item de linha do pedido (por exemplo, camiseta ou calça). Um nome pode aparecer mais de uma vez se aparecer em itens de linha separados.
• Categorias de itens: As categorias dos produtos no pedido (por exemplo, camisetas, masculino, calças e promoção).
• Contagem de itens: O número de itens de linha no pedido (por exemplo, 2). Isso não é a soma das quantidades pedidas.
• Código da moeda: O código da moeda do pedido (ex.: USD ou EUR).
• Com desconto: se um desconto foi aplicado ao pedido (verdadeiro ou falso).
• Cupom: O código de cupom aplicado.
• Itens únicos: os nomes dos produtos no pedido, com duplicatas removidas (por exemplo, camisas ou shorts).
• Categorias únicas de itens: As categorias de produto no pedido, com duplicatas removidas (por exemplo, masculino ou promoção).
• Atributos (opcional): Atributos do produto nos detalhes do item em extra. Use eventos de Produto pedido para filtrar por atributos individuais do produto.

Produto Encomendado

Esse evento é rastreado quando um cliente faz um pedido. Para quantidades de números inteiros, 1 evento Ordered Product é rastreado para cada unidade comprada, até o limite de 100 eventos por item de linha do pedido. Por exemplo, se alguém compra uma camiseta e uma calça, 1 evento Placed Order e 2 eventos Ordered Product são registrados: 1 para a camiseta e 1 para a calça. Para produtos vendidos em quantidades decimais, a Klaviyo registra 1 evento para o item de linha e inclui a quantidade comprada.

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: O valor representado por este evento antes dos descontos, excluindo o frete. Para quantidades em números inteiros, esse é o total da linha do pedido dividido pela sua quantidade. Para quantidades decimais, é o total completo da linha.
• Nome: O nome dado a este item específico.
• SKU: O SKU atribuído ao item (ex.: REDMEDIUMTSHIRT).
• Categories: As categorias deste produto (por exemplo, camisetas, masculino, calças e promoção).
• Preço: O preço unitário do produto na moeda do pedido (por exemplo, camisas 25,50 ou sapatos 50,25).
• Custo (opcional): O custo do produto registrado no Magento, quando disponível (por exemplo, camisas 13,85 ou sapatos 20,00).
• Código da moeda: O código da moeda do pedido (ex.: USD ou 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.
• Quantity: A quantidade representada por esse evento: 1 para quantidades de número inteiro ou a quantidade comprada de um produto vendido em quantidades decimais.
• Atributos (opcional): Atributos de produto personalizados.

Pedido Realizado

Esse evento é rastreado quando um cliente conclui o processo de checkout e cria um pedido na sua loja Magento. A Klaviyo rastreia dados relacionados, incluindo informações de produto sobre os itens que alguém comprou, como nomes de produtos, imagens e informações de variante que você pode usar em e-mails de acompanhamento de compra. Esses eventos Placed Order incluem os seguintes dados do pedido. Você pode usar propriedades de nível superior para filtrar e segmentar eventos; os detalhes de atributos em extra estão disponíveis para o conteúdo das mensagens.

• Valor: O total geral do pedido no Magento, incluindo impostos e frete após os descontos.
• Itens: os nomes dos produtos de cada item de linha do pedido (por exemplo, camiseta ou calça). Um nome pode aparecer mais de uma vez se aparecer em itens de linha separados.
• Categorias de itens: As categorias dos produtos no pedido (por exemplo, camisetas, masculino, calças e promoção).
• Contagem de itens: O número de itens de linha no pedido (por exemplo, 2). Isso não é a soma das quantidades pedidas.
• Código da moeda: O código da moeda do pedido (ex.: USD ou EUR).
• Com desconto: se um desconto foi aplicado ao pedido (verdadeiro ou falso).
• Cupom: O código de cupom aplicado.
• Itens únicos: os nomes dos produtos no pedido, com duplicatas removidas (por exemplo, camisas ou shorts).
• Categorias únicas de itens: As categorias de produto no pedido, com duplicatas removidas (por exemplo, masculino ou promoção).
• Atributos (opcional): Atributos do produto nos detalhes do item em extra. Use eventos de Produto pedido para filtrar por atributos individuais do produto. Saiba como revisar atributos personalizados de produto.

Pedido Reembolsado

Com os status de pedidos padrão do Magento, esse evento é rastreado quando um pedido atinge o status fechado. O valor dele é o total geral do pedido original, não o valor de um reembolso individual.

• Valor: O total geral do pedido original do Magento, incluindo impostos e frete após os descontos.
• Cupom: O código de cupom aplicado.
• Código da moeda: O código da moeda do pedido (ex.: USD ou EUR).
• Com desconto: se um desconto foi aplicado ao pedido (verdadeiro ou falso).
• Categorias de itens: As categorias dos produtos no pedido (por exemplo, camisetas, masculino, calças e promoção).
• Contagem de itens: O número de itens de linha no pedido (por exemplo, 2). Isso não é a soma das quantidades pedidas.
• Itens: os nomes dos produtos de cada item de linha do pedido (por exemplo, camiseta ou calça). Um nome pode aparecer mais de uma vez se aparecer em itens de linha separados.
• Categorias únicas de itens: As categorias de produto no pedido, com duplicatas removidas (por exemplo, masculino ou promoção).
• Itens únicos: os nomes dos produtos no pedido, com duplicatas removidas (por exemplo, camisas ou shorts).

A receita de Placed Order usa o total geral do pedido do Magento, incluindo impostos e frete após os descontos. Para filtrar um segmento com base em $value, use Revenue.

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 em modelos de e-mail de fluxo acionado por métrica.

Dados sincronizados do cliente

A Klaviyo cria ou atualiza perfis a partir de pedidos sincronizados, registros de clientes e checkouts iniciados. As informações disponíveis em um perfil dependem dos dados fornecidos pela Magento. Pode incluir:

• 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
• WebsiteID do Magento (quando o registro do cliente inclui um ID da loja)

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.

Revisar atributos personalizados do produto

Atributos personalizados do produto dependem da configuração da sua integração atual. Os atributos configurados aparecem em eventos Ordered Product como propriedades chamadas Attribute:, seguidas do código do atributo. Os detalhes do atributo também são armazenados com itens individuais em extra nos eventos de pedido. O suporte da Klaviyo não atende mais a solicitações para ativar ou alterar a sincronização de atributos do Magento 1. Revise os dados de evento existentes para ver quais atributos estão presentes. Você pode encontrar informações gerais de suporte em Como entrar em contato com o suporte.

Para identificar um atributo personalizado na sua configuração atual, acesse Catálogo > Atributos > Gerenciar atributos no painel de administração do Magento e clique no atributo.

Encontre o ID do atributo na URL, como mostrado abaixo.

Verifique seus dados de pedido sincronizados

Para verificar seus pedidos sincronizados, compare o número de eventos Placed Order de um dia concluído com os pedidos no Magento para o mesmo dia e lojas. Aguarde a sincronização histórica terminar e a sincronização mais recente de 30 minutos ser concluída antes de comparar as contagens.

1. Navegue até Análises > Métricas e selecione a métrica Placed Order do Magento.
2. Defina Intervalo de datas para incluir o dia que você quer comparar. Defina Visualizar por como Diário e Medição como Total. Remova qualquer Filtro que excluiria pedidos da comparação.
3. Passe o mouse sobre o ponto de dados do dia ou leia o valor na tabela abaixo do gráfico. Compare a contagem com os pedidos do Magento no mesmo dia e nas mesmas lojas.

Se as contagens forem diferentes, verifique se ambos os relatórios usam o mesmo fuso horário e o mesmo escopo de loja, e se a sincronização foi concluída. Verifique também se há pedidos do Magento não correspondidos aguardando pagamento ou sem um endereço de e-mail de cliente válido. Para conferir o fuso horário do Klaviyo:

1. Clique no nome da sua conta no canto inferior esquerdo.
2. Clique em Configurações.
3. Selecione Geral > Conta e revise a configuração de Fuso horário.
4. Se você alterar o Fuso horário, clique em Salvar. Você precisa de permissão para editar as configurações da conta para alterar esse valor.

A receita de “Placed Order” no Klaviyo não subtrai pedidos cancelados ou reembolsados. Por isso, ela pode ser diferente de um relatório do Magento que subtrai esses pedidos.

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.

Use estes exemplos para entender os nomes das propriedades e o aninhamento de eventos sincronizados. Eles mostram o formato legado do payload de evento e não são instruções para enviar solicitações às APIs atuais da Klaviyo. Os valores de exemplo são ilustrativos; extra contém todos os detalhes do pedido para eventos no nível do pedido.

Pedido Realizado

{
  "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"
    ],
    "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

{
  "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",
    "$value": 9.99,
    "Currency Code": "USD",
    "Name": "Winnie the Pooh",
    "SKU": "WINNIEPOOH",
    "ProductID": "567",
    "Categories": [
      "Fiction",
      "Classics"
    ],
    "Price": 9.99,
    "Discounted": true,
    "Cost": 5.0,
    "Attribute: Color": "Red",
    "$extra": {
      "Product URL Key": "winnie-pooh",
      "Product URL": "https://www.store.com/winnie-pooh",
      "Image URL": "https://cnd.store.com/images/winnie-pooh.png"
    },
    "Quantity": 1
  },
  "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": {},
    "Currency Code": "USD",
    "Item Count": 2,
    "Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "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