Solução de problemas com importações de listas

O senhor aprenderá

Saiba como solucionar os erros que ocorrem ao carregar um CSV de contatos para uma lista nova ou existente no Klaviyo. Como o senhor faz o upload de avaliações? Consulte nosso artigo sobre como importar avaliações.

Antes de começar

Quer ter certeza de que seu arquivo será importado? Verifique a lista de requisitos abaixo antes de importar sua lista.

• Arquivo CSV (não em outro formato)
• O tamanho do arquivo é de 50 MB ou menos
• A primeira linha é de cabeçalhos
• Cada linha tem um endereço de e-mail ou um número de telefone associado a ela
• Não há endereços de e-mail ou números de telefone duplicados

Nossa equipe de suporte não pode importar CSVs para a Klaviyo em seu nome. Se precisar de ajuda com uma importação, consulte a seção de solução de problemas abaixo para obter dicas sobre como solucionar problemas de importação de listas com êxito.

Índice

• Atraso na importação
• Solução de problemas de importação
• Todas as colunas importadas como um único campo 
• Mensagens de erro de formato inválido 
• Formatação incorreta de data ou carimbo de data/hora
• Mensagens de erro de identificador único duplicado ou ausente
• Valor ausente em um campo obrigatório
• Problemas de formatação do número de telefone

Atraso na importação

Se o senhor importar um arquivo grande com uma quantidade significativa de dados, o processo de importação poderá levar várias horas para ser concluído. Infelizmente, não há como acelerar esse processo depois de iniciado. No entanto, uma maneira de acelerar preventivamente o processo de importação é remover todos os e-mails duplicados do CSV antes da importação. É altamente recomendável planejar a importação de uma nova lista com pelo menos um dia de antecedência da data em que o senhor pretende enviar e-mails aos contatos da lista.

Após o início da importação, o senhor verá inicialmente uma barra de status. Se o senhor clicar fora, ainda poderá acompanhar o progresso da importação observando o aumento da contagem da lista ao longo do tempo. Enviaremos um e-mail ao senhor assim que a importação da lista for concluída.

Solução de problemas de importação

Se sua lista não conseguir carregar, procure os seguintes erros comuns no arquivo CSV que podem estar causando esse bloqueio:

Todas as colunas importadas como um único campo 

Se o senhor estiver usando uma versão do Excel que não usa o inglês como idioma padrão, o software poderá usar ponto e vírgula e não vírgulas como separador no arquivo. Se esse for o caso, seu arquivo poderá ter a seguinte aparência ao ser importado:

Para solucionar esse problema, vá até a configuração de Formato de número ou Separador de lista (ou número) do seu computador. Essa configuração provavelmente está nas configurações de Language & Region e pode estar localizada na seção Advanced Settings (Configurações avançadas ). Substitua o ponto-e-vírgula por uma vírgula e salve. Agora, quando o senhor exportar arquivos como CSV, eles usarão o formato de vírgula. Observe que o local exato dessa configuração pode variar entre os sistemas operacionais.

Além disso, verifique se o CSV está de acordo com os requisitos de formatação da Klaviyo. Se o senhor ainda não o fez, consulte nossa documentação sobre formatação de dados. Por exemplo, um dos campos obrigatórios é para endereços de e-mail. 

Solução de problemas de mensagens de erro de formato inválido 

Quando o senhor importa uma lista para o Klaviyo, a página de mapeamento de campos permite fazer a correspondência entre as propriedades e o tipo de dados correspondente no Klaviyo. Por exemplo, Email sempre tem um tipo de dados Text; por outro lado, se o senhor carregar uma propriedade personalizada para Birthday (Aniversário), deverá definir o tipo de dados como Date (Data).

Analise os tipos de dados, os formatos aceitáveis e os exemplos abaixo. 

• Texto
  Qualquer texto ou combinação de texto e números. Se o senhor não tiver certeza do formato dos dados, escolha essa opção. 
  • Exemplos: 
    email@example.com
    Olá, mundo
    $5.00
• Numérico
  Todos os números. Não inclua símbolos de moeda em campos numéricos. 
  • Exemplos:
    2
    5.0031
    130.0
• Booleano
  Valores verdadeiros ou falsos.
  • Exemplos:
    true
    falso
• Data
  Consulte nosso guia de formatos aceitáveis de data e carimbo de data/hora para propriedades de perfil e evento para saber mais sobre os formatos de data aceitos.
  • Exemplo:
    2014-09-01 13:34:08
• Lista
  Os dados devem ser formatados como uma matriz JSON. 
  • Exemplos:
    ["apples","bananas","oranges"]
    ["maçãs"]
• Consentimento
  O consentimento refere-se ao fato de um perfil ter optado por receber marketing por e-mail. Para o tipo de dados de consentimento em um upload, o valor deve ser "E-mail".

Para obter mais informações sobre o que os diferentes tipos de dados implicam e quais devem ser selecionados ao importar sua lista, consulte nosso guia sobre como entender os tipos de dados.

Para saber mais sobre as mensagens de erro "Invalid [data type] format" (por exemplo, "Invalid lista format"), consulte nosso guia de solução de problemas para mensagens de erro de formato inválido. 

Formatação incorreta de data ou carimbo de data/hora

O senhor pode estar usando o formato errado para datas ou registros de data e hora. Se o senhor tiver incluído um ou outro e não tiver certeza dos formatos aceitos pelo Klaviyo, consulte nosso guia sobre formatos aceitáveis de data e carimbo de data/hora para propriedades de perfil e evento.

Solução de problemas com mensagens de erro de identificador único duplicado ou ausente

Identificadores duplicados

Registros ignorados devido a "Duplicate Unique ID" significa que um endereço de e-mail ou número de telefone foi repetido no seu arquivo. Nesses casos, o Klaviyo processará os dados da primeira linha que contém o identificador repetido e fornecerá todos os registros não processados em um arquivo para download. 

Clique em Download Skipped Records (Baixar registros ignor ados) para ver os contatos ignorados devido a identificadores duplicados e recarregar esses registros ignorados, se necessário. 

Falta de identificadores exclusivos

Os registros ignorados devido a "Missing Unique ID" significam que as linhas ignoradas não continham um endereço de e-mail, número de telefone ou outro identificador exclusivo aceito. 

Clique em Download Skipped Records (Baixar registros ignor ados) para ver os contatos ignorados devido à falta de identificadores, adicione um endereço de e-mail ou número de telefone para cada um deles e carregue novamente o novo arquivo. 

Valor ausente em um campo obrigatório

Verifique se todos os campos obrigatórios têm valores associados a eles. Por exemplo, se um dos seus contatos listados não tiver um endereço de e-mail na coluna de e-mail, o senhor verá um erro ao fazer o upload. Verifique se cada contato que deseja carregar tem um valor para todos os campos obrigatórios. Se estiverem vazias, preencha antes de sua próxima tentativa de upload. 

Endereço de e-mail inválido ou caracteres não reconhecidos

Se o senhor receber essa mensagem de erro, verifique se há caracteres inválidos nos endereços de e-mail do seu arquivo. Os caracteres inválidos incluem ( ) , : ; [ / ], além de espaços. 

Problemas de formatação do número de telefone

Os números de telefone devem incluir um código de país ou uma coluna separada indicando o país, e devem seguir um formato de número de telefone aceito. Saiba como formatar e carregar corretamente os números de telefone. 

Recursos adicionais

• Adicionar assinantes a uma lista existente
• Criar e adicionar contatos a uma nova lista
• Formatos aceitáveis de data e carimbo de data/hora