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.
O senhor está tendo problemas para fazer o upload de uma lista de perfis com consentimento por SMS? Confira o Guia do 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 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
- Exemplos:
- Numérico
Todos os números. Não inclua símbolos de moeda em campos numéricos. - Exemplos:
2
5.0031
130.0
- Exemplos:
- Booleano
Valores verdadeiros ou falsos.- Exemplos:
true
falso
- Exemplos:
- 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
- Exemplo:
- lista
dados devem ser formatados como uma matriz JSON. - Exemplos:
["apples","bananas","oranges"]
["maçãs"]
- Exemplos:
- Consentimento
O consentimento é formatado como o canal (E-mail, SMS, etc.) e o tipo de consentimento (se houver vários tipos disponíveis em Klaviyo). A única opção para e-mail é marketing por e-mail Consent; para SMS, seria marketing por SMS Consent ou SMS Transactional Consent; etc. O valor desse campo deve ser "inscrever-se," " Nunca se inscrever," ou "cancelar inscrição."
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.
Para manter a segurança dos seus dados, a equipe de suporte da Klaviyo não pode abrir seus arquivos CSV. Para obter mais assistência na solução de problemas de importação de lista, entre em contato com a equipe de suporte com uma descrição detalhada do problema e capturas de tela do erro encontrado.
Transferência de perfil entre contas
Ao transferir o perfil de uma conta para outra, há algumas propriedades que não podem ser carregadas para outra conta.
Por exemplo, o perfil criado em não pode ser transferido porque está definido para a data em que um perfil é criado na conta. Outro conjunto de exemplos é o First Active (Primeiro ativo ) e Last Active (Último ativo), pois são definidos automaticamente com base na atividade do perfil na conta.
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
- Como importar assinante para uma lista
Saiba como adicionar assinante a uma lista em Klaviyo. O upload de contato é fundamental quando se trata de Klaviyo, principalmente se o senhor estiver migrando de outro provedor de serviços ou obtendo informações de terceiros.
- Formatos aceitáveis de data e registro de data e hora para referência de propriedades de perfil e evento
Saiba quais formatos de data e hora a Klaviyo reconhece nos dados de eventos e perfis enviados por meio de nossas APIs ou em um upload de CSV. Observe que isso não se aplica a um registro de data e hora de evento enviado por meio da API Track, que deve ser a hora unix em segundos.