Solução de problemas de importações de lista

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 os cabeçalhos
• Cada linha tem um endereço de e-mail ou um número de telefone associado
• 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
• 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 de número de telefone

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 é iniciado. No entanto, uma forma de agilizar preventivamente o processo de importação é remover todos os e-mails duplicados do seu CSV antes de importar. Recomendamos fortemente que você planeje importar uma nova lista pelo menos um dia antes de quando pretende enviar e-mails aos contatos da lista.

Depois que uma importação começa, você verá inicialmente uma barra de status. Se você clicar para sair, ainda poderá acompanhar o progresso da importação observando o aumento da contagem da lista ao longo do tempo. Vamos enviar um e-mail para você assim que a importação de lista for concluída.

Solução de problemas de importação

Se sua lista não for carregada, procure os seguintes erros comuns no seu arquivo CSV que podem estar causando esse impedimento:

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:

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.

Além disso, verifique se o seu CSV está alinhado com os requisitos de formatação da Klaviyo. Se você ainda não fez isso, consulte nossa documentação sobre como formatar seus dados. Por exemplo, um dos campos obrigatórios é o de endereços de e-mail.

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 abaixo os tipos de dados, os formatos aceitos e os exemplos.

• 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: [e-mail] 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: 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"]
• Consentimento O consentimento é formatado como o canal (e-mail, SMS etc.) e o tipo de consentimento (se houver vários tipos disponíveis na Klaviyo). A única opção para e-mail é Consentimento de marketing por e-mail; para SMS, seria Consentimento de marketing por SMS ou Consentimento transacional por SMS; etc. O valor deste campo deve ser "inscrever-se," "Nunca se inscreveu," ou "cancelar inscrição." 

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.

Como resolver mensagens de erro de identificador exclusivo duplicado ou ausente

Identificadores duplicados

Registros ignorados devido a "ID único duplicado" significam que um endereço de e-mail ou número de telefone foi repetido no seu arquivo. Nesses casos, a 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 Baixar registros ignorados para ver os contatos ignorados devido a identificadores duplicados e reenvie esses registros ignorados, se necessário.

Identificadores exclusivos ausentes

Registros ignorados por “ID exclusivo ausente” 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 Baixar registros ignorados para ver os contatos ignorados devido à falta de identificadores, adicionar um endereço de e-mail ou número de telefone para cada um e reenviar seu novo arquivo.

Valor ausente em um campo obrigatório

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

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.