O que você vai aprender

Saiba como solucionar erros que ocorrem ao fazer upload de um CSV de contatos para uma lista nova ou existente no Klaviyo. Fazendo upload de avaliações? Acesse nosso artigo sobre como importar avaliações.

Antes de começar

Quer garantir que seu arquivo vai importar? Confira a lista de requisitos abaixo antes de importar sua lista.

  • Arquivo CSV (não em nenhum outro formato)
  • O tamanho do arquivo é de 50 MB ou menos
  • A primeira linha contém um cabeçalho exclusivo e não vazio para cada coluna
  • Cada linha tem um identificador exclusivo válido, como um endereço de e-mail, número de telefone ou ID externo
  • Não há endereços de e-mail ou números de telefone duplicados

Nossa equipe de suporte não consegue importar CSVs para o Klaviyo em seu nome. Se você precisar de ajuda com uma importação, confira a seção de solução de problemas abaixo para ver dicas de como solucionar problemas de importação de listas com sucesso.

Está com problemas para fazer upload de uma lista de perfis com consentimento de SMS? Confira o guia da Klaviyo para fazer upload de uma lista de contatos de SMS.

Índice

Atraso na importação

Se você importar um arquivo grande com uma quantidade significativa de dados, o processo de importação pode levar várias horas para ser concluído. Infelizmente, não há como acelerar esse processo depois que ele começa. No entanto, uma forma de agilizar o processo de importação com antecedência é remover todos os e-mails duplicados do seu CSV antes de importar. Recomendamos fortemente que você planeje importar uma nova lista com pelo menos 1 dia de antecedência em relação ao momento em que pretende enviar e-mails para os contatos da lista.

Depois que uma importação começar, você verá inicialmente uma barra de status. Se você sair dessa tela, abra a lista e selecione a aba Importações para verificar o andamento e os resultados. Vamos enviar um e-mail assim que uma importação de lista for concluída.

Solução de problemas de importação

Se o upload do seu arquivo falhar ou algumas linhas forem ignoradas, confira os erros comuns abaixo. Para encontrar e corrigir as linhas ignoradas depois que uma importação terminar:

  1. Abra a lista e selecione a aba Importações.
  2. Para uma importação marcada como Concluída com erros, clique em Baixar arquivo de erro se o botão estiver disponível.
  3. Use a coluna Erros no CSV baixado para identificar e corrigir as linhas afetadas. Remova as colunas Erros e Avisos do arquivo corrigido para que elas não sejam importadas como Propriedades do perfil.
  4. Clique em Fazer upload de novo arquivo e faça upload do seu CSV corrigido. Mapeie as colunas dele, revise as configurações de consentimento e clique em Importar para iniciar a importação.

Se Baixar arquivo de erro não estiver disponível, confira o CSV original com base nas orientações de solução de problemas abaixo e corrija-o antes de fazer upload novamente.

Todas as colunas importadas como um único campo

Se você estiver usando uma versão do Excel que não usa o inglês como idioma padrão, seu software pode usar ponto e vírgula, e não vírgulas, como separador no seu arquivo. Se esse for o caso, seu arquivo pode ficar assim ao importar:

Semicolon delimiter.jpg
Semicolon delimiter.jpg

Para corrigir isso, acesse a configuração Formato de número ou Separador de lista (ou de número) do seu computador. Essa configuração provavelmente está em Idioma e região e pode ficar na seção Configurações avançadas. Substitua o ponto e vírgula por uma vírgula e salve. Agora, quando você exportar arquivos como CSV, eles vão usar o formato com vírgula. Atenção: o local exato dessa configuração pode variar de acordo com o sistema operacional.

2017-05-22_14-59-31.png
2017-05-22_14-59-31.png

Além disso, confira se o seu CSV está de acordo com os requisitos de formatação da Klaviyo. Se você ainda não fez isso, acesse nossa documentação sobre como formatar seus dados. Cada linha precisa de um identificador exclusivo válido; um endereço de e-mail não é obrigatório quando outro identificador aceito é fornecido.

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

Quando você importa uma lista para a Klaviyo, a página de mapeamento de campos permite que você associe quaisquer propriedades ao tipo de dados correspondente na Klaviyo. Por exemplo, E-mail sempre tem um tipo de dados Texto; já se você fizer upload de uma propriedade personalizada para Aniversário, convém definir o tipo de dados como Data.

Revise os tipos de dados, os formatos de propriedade de consentimento e os exemplos abaixo.

  • Texto
    Qualquer texto ou combinação de texto e números. Se você não tem certeza de qual é o formato dos seus dados, escolha esta opção.
    • Exemplos:
      exemplo@exemplo.com
      Olá, mundo
      $ 5,00
  • Número
    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:
      verdadeiro
      falso
  • Data
    Consulte nosso guia sobre formatos aceitáveis de data e hora para propriedades de perfil e eventos para saber mais sobre os formatos de data aceitos.
    • Exemplo:
      01-09-2014 13:34:08
  • Lista
    Os dados devem ser formatados como uma matriz JSON.
    • Exemplos:
      ["apples","bananas","oranges"]
      ["apples"]
  • Propriedades de consentimento
    Mapeie cada coluna de consentimento para a propriedade do respectivo canal e tipo de consentimento, como Consentimento para marketing por e-mail, Consentimento para marketing por SMS ou Consentimento transacional por SMS. Essas propriedades usam o tipo de dados Texto. Insira "inscrever-se", "Never Subscribed" ou "cancelar inscrição" como valor.

Para saber mais sobre o que envolvem os diferentes tipos de dados e qual selecionar ao importar sua lista, acesse nosso guia sobre como entender tipos de dados.

Para saber mais sobre mensagens de erro de "Formato inválido de [tipo de dados]" (por exemplo, "Formato de lista inválido"), acesse 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

Você pode estar usando o formato errado para datas ou carimbos de data/hora. Se você incluiu um deles e não tem certeza sobre os formatos aceitos pela Klaviyo, acesse nosso guia sobre formatos de data e carimbo de data/hora aceitáveis para propriedades de perfil e evento.

Se você receber um erro de carimbo de data/hora de consentimento inválido, verifique se o carimbo de data/hora corresponde ao momento em que o consentimento foi dado e se é em 01/01/1990 ou depois. Verifique também o fuso horário: um carimbo de data/hora sem um deslocamento é interpretado como UTC, o que pode fazer com que um horário local pareça estar no futuro.

Como resolver mensagens de erro de identificador exclusivo duplicado ou ausente

Identificadores duplicados

Erros de identificador duplicado significam que várias linhas usam o mesmo identificador de perfil, como um endereço de e-mail ou número de telefone. O Klaviyo pode pular linhas duplicadas, e você não deve contar que a primeira linha do seu arquivo será importada. Consolide os detalhes de cada contato em 1 linha antes de importar novamente.

Clique em Baixar arquivo de erros, se disponível, para revisar as linhas ignoradas devido a identificadores duplicados. Confira os detalhes que você quer manter antes de reenviar o arquivo, já que os valores importados podem atualizar um perfil existente.

Identificadores exclusivos ausentes

Um erro de identificador exclusivo ausente significa que uma linha ignorada não continha um endereço de e-mail, número de telefone ou outro identificador exclusivo aceito.

Clique em Baixar arquivo de erro, se disponível, para revisar as linhas ignoradas devido à falta de identificadores. Adicione um identificador válido para cada contato e garanta que a coluna dele esteja mapeada para a propriedade Klaviyo correspondente antes de reenviar o arquivo.

Valor ausente em um campo obrigatório

Verifique os campos obrigatórios para as informações que você está importando. Por exemplo, uma linha com consentimento de e-mail precisa de um endereço de e-mail, e uma linha com consentimento de SMS precisa de um número de telefone. Preencha o valor que está faltando ou remova as informações de consentimento que não se aplicam a esse contato antes de fazer o upload novamente.

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

Se você receber esta mensagem de erro, verifique se os endereços de e-mail no seu arquivo têm caracteres inválidos. Os caracteres inválidos incluem ( ) , : ; [ ], bem como espaços.

Para manter a segurança dos seus dados, a equipe de suporte da Klaviyo não pode abrir seus arquivos CSV. Para resolver problemas de importação de listas, forneça uma descrição detalhada e prints do erro à equipe de suporte.

Transferência de perfis entre contas

Ao transferir perfis de uma conta para outra, há algumas propriedades que não podem ser carregadas em outra conta.

Por exemplo, Perfil criado em não pode ser transferido porque está definido como a data em que um perfil é criado na conta. Outro conjunto de exemplos é Primeira vez com atividade e Última vez com atividade, pois eles são definidos automaticamente com base na atividade do perfil na conta.

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

Os números de telefone devem incluir um código do 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 fazer upload de números de telefone corretamente.

Recursos adicionais

Esse artigo foi útil?
Use esse formulário somente para dar feedback sobre os artigos. Saiba como entrar em contato com o suporte.

Saiba mais sobre a Klaviyo

Community
Conecte-se com colegas, parceiros e especialistas da Klaviyo para ter ideias, compartilhar insights e tirar dúvidas.
Parceiros
Contrate um especialista certificado pela Klaviyo para ajudá-lo com uma tarefa específica ou para gerenciamento contínuo de marketing.
Suporte

Acesse o suporte na sua conta.

Suporte por e-mail (teste gratuito e contas pagas) Disponível 24 horas

Chat/assistência virtual
A disponibilidade varia conforme o local e o tipo de plano