Como importar manualmente dados de eventos históricos

O que você vai aprender

Saiba como importar manualmente dados históricos de eventos para o Klaviyo. Embora recomendemos o uso de integrações criadas pelo Klaviyocom plataformas como Shopify, Magento e BigCommerce, e nosso API para integrações personalizadas, também é possível adicionar esses dados manualmente. Um exemplo comum disso é adicionar dados históricos de compras de uma plataforma de comércio eletrônico anterior para a qual a Klaviyo não tem uma integração pré-construída.

Observe que há um limite de 50 MB para uploads de CSV. 

Formatar seus dados

A primeira etapa é formatar seus dados corretamente em um arquivo CSV. Abaixo está um exemplo de dados de Placed Order, juntamente com uma descrição dos campos abaixo. Cada linha do seu arquivo CSV deve representar uma ação ou atividade realizada por alguém, como "Purchased product" ou "Signed up for webinar." Se o senhor tiver várias ações para rastrear, deve fazer o upload delas como arquivos CSV separados. Email deve vir primeiro quando o senhor fizer o upload do CSV.

Aqui estão alguns exemplos de CSVs de eventos que o senhor pode consultar ao formatar seus dados.

Campos obrigatórios

Os dois campos obrigatórios são um registro de data e hora para identificar quando o evento ocorreu e uma propriedade do cliente (um e-mail ou uma ID exclusiva) para identificar quem executou a ação.

• Carimbo de data/hora: Um registro de data e hora que mostra o dia e a hora do evento. O formato é AAAA-MM-DD HH:MM:SS. Por exemplo, 1:30pm em 14 de novembro de 2012 seria: 2012-11-14 13:30:00.

  Se dois ou mais eventos em seu arquivo CSV tiverem o mesmo carimbo de data/hora, o senhor deverá incluir um $event_id exclusivo, ou apenas um dos eventos será importado e o restante será ignorado. Consulte a seção sobre $event_id abaixo.

• Person//Email ou Person//ID: muito provavelmente, o senhor usará um e-mail para identificar seus clientes. Alguns clientes também usarão uma ID exclusiva. O senhor pode usar ambos, se desejar.

Campos opcionais

Há dois campos especiais que devem ser observados.

• $event_id: Esse é um identificador exclusivo para o evento. Na prática, o senhor deve enviar um $event_id se tiver um identificador exclusivo para cada evento (por exemplo, um ID de pedido). O senhor também deve definir o $event_id se espera que determinados eventos ocorram no mesmo momento. Isso pode acontecer quando alguém realiza uma ação que o senhor dividirá em vários eventos. Por exemplo, se alguém comprar vários itens, o senhor pode querer registrar um evento para cada item comprado.
  
  Nos dois conjuntos de dados de amostra abaixo, há um evento de pedido feito, juntamente com três eventos de produto pedido (um para cada produto no pedido feito). Todos esses eventos têm o mesmo registro de data e hora, mas todos serão importados porque cada um tem um $event_id exclusivo. Se os $event_ids forem idênticos, ou se estiverem ausentes, apenas um dos eventos será importado e os outros serão ignorados.
  
• $valor: Use esse campo se o evento que estiver sendo importado incluir um valor. Por exemplo, se o senhor estiver importando dados do evento Placed Order (Pedido feito), cada pedido terá um valor. O senhor não precisa prefixar seus valores com um $ ou outro símbolo de moeda.

Se o senhor tiver dados adicionais sobre a pessoa que fez algo, eles devem ser colocados em uma coluna cujo rótulo comece com Person// e, em seguida, o tipo de dados que a coluna contém. Por exemplo, se o senhor tivesse a empresa ou a organização a que cada pessoa pertence, deveria rotular essa coluna como Person//Organization. O prefixo especial nos permite saber que devemos associar os dados dessa coluna a cada pessoa e não à atividade. A seguir, há colunas especiais que o senhor pode usar para ajudá-lo a identificar pessoas:

• Person//First Name: primeiro nome
• Person//Last Name: sobrenome
• Pessoa// Telefone: número de telefone
• Pessoa/Organização: organização
• Pessoa/Título: cargo

Se o senhor tiver dados adicionais sobre cada ação, poderá incluí-los em colunas extras com os rótulos que desejar. Por exemplo, se alguém comprar algo e o senhor quiser incluir o item que essa pessoa comprou, poderá incluir esses dados em uma coluna denominada Item Purchased (Item comprado). Abaixo estão alguns exemplos.

• Item comprado
• Categoria do item
• Produto
• Localização

Se o senhor não tiver dados para uma coluna específica, deixe-a em branco e nós a ignoraremos. Por exemplo, se o senhor não conhece a organização de alguém, pode deixar a coluna Person//Organization em branco e deixaremos de rastrear essa propriedade para essa linha em seus dados.

Quando terminar de formatar os dados, salve-os em um arquivo CSV.

Carregar um arquivo CSV de dados

Depois que seus dados estiverem devidamente formatados, vá para o Klaviyo. 

1. Na Klaviyo, selecione a aba Integrações.
2. Selecione Manage sources (Gerenciar fontes) > importar via CSV.
3. Será solicitado que o senhor faça o upload do arquivo CSV e, em seguida, clique em Next.
4. O senhor terá a oportunidade de nomear o evento. Se o senhor estiver tentando mapear os dados importados para uma métrica de evento que já existe em sua conta, certifique-se de digitar o nome do evento exatamente como ele já aparece.
5. Depois de nomear seu evento, o senhor pode visualizar seus dados abaixo.
6. Quando estiver pronto para importar seus dados, clique em Next (Avançar). Seu arquivo começará a ser processado e o senhor poderá navegar para fora da página. 

Observação para lojas de comércio eletrônico que carregam dados de compra

Se o senhor estiver fazendo upload de dados de compra, deverá fazer upload de dois arquivos: um para o pedido geral e um segundo que inclua dados item a item.  Por exemplo, um cliente pode fazer um pedido de vários produtos. Nesse caso, haveria um evento para o pedido feito e, em seguida, eventos separados para cada um dos produtos pedidos. Veja como os cabeçalhos desses arquivos devem ser normalmente:

Pedido feito

Produto encomendado

Não usamos o $ para prefixar valores de pedidos. Use apenas números para indicar o preço ou o valor de um pedido. O uso do cabeçalho $value preencherá os dados corretamente em sua conta da Klaviyo.

O motivo para incluir duas métricas é que isso facilita o disparo posterior de e-mails a partir de um pedido geral e de categorias/itens específicos.

Para eventos Ordered Product, $event_id precisa ser um identificador exclusivo para cada combinação do pedido e do produto pedido. Uma maneira fácil de criar um identificador exclusivo é combinar o ID do pedido e o ID do produto, como no exemplo acima.

importar solução de problemas

Abaixo estão alguns problemas e resoluções comuns que o senhor pode encontrar ao importar manualmente dados de eventos históricos.

Minha importação está demorando muito

A importação pode levar de 5 minutos a 24 horas, dependendo do tamanho da sua lista. Recomendamos enfaticamente que o senhor inicie a importação de qualquer lista pelo menos 24 horas antes de precisar dela para uma determinada campanha, para garantir que o processo de importação não atrase seu envio.

Minha importação continua falhando

Se a importação falhar, é provável que isso se deva a um dos seguintes motivos:

• Seu arquivo é um arquivo .csv? Seu arquivo deve estar em .csv formato. Se o senhor tentar carregar um arquivo do Excel ou um arquivo .txt a importação falhará.
• O senhor formatou a coluna Timestamp corretamente? O senhor deve formatar a data e a hora como AAAA-MM-DD HH:MM:SS. Por exemplo, 1:30pm em 14 de novembro seria: 2012-11-14 13:30:00. Como uma segunda verificação, abra o CSV em um editor de texto para garantir que os 0s finais nos carimbos de data e hora não sejam removidos quando o senhor salvar ou exportar os arquivos CSV. Se estiver trabalhando com dados em uma planilha, verifique se as células Timestamp estão definidas para o formato correto de timestamp.
  
• Todas as colunas obrigatórias têm dados preenchidos em cada linha? O senhor deve ter uma coluna denominada Person//Email ou Person//ID. Se uma dessas colunas tiver uma linha vazia, isso pode causar falha na importação.
• Sua coluna Person//Email contém endereços de e-mail inválidos? Se o senhor tiver valores dentro de Person//Email que não tenham um formato de endereço de e-mail válido, isso pode fazer com que a importação falhe.
• Todas as colunas estão rotuladas corretamente? Há algum espaço? Certifique-se de que todos os cabeçalhos de coluna correspondam ao que está descrito neste guia. O senhor também deve se certificar de que não haja espaços nos nomes das colunas.

Recursos adicionais

• Formatos aceitáveis de data e registro de data e hora para referência de propriedades de perfil e evento
• Referência de formatação de datas para arquivos CSV
• Migrar para o Klaviyo