Como Importar uma Base de Consumidores no app.dito

Modificado em Qui, 18 Dez na (o) 12:13 PM

O importador de bases da Dito serve para cadastrar ou atualizar características de clientes de forma prática, permitindo unificar dados já existentes, enriquecer os perfis e garantir que a base fique organizada para que as segmentações e campanhas funcionem de maneira mais precisa.

Para quem é este artigo?

Nível de Acesso: Administrador e editor
Indicado para: Analistas de CRM, Marketing, E-commerce e profissionais que gerenciam a base de consumidores.

Veja os Assuntos abordados nesse artigo:

Como selecionar e enviar o arquivo no App. Dito:
Explica o processo inicial de upload do arquivo de dados para a plataforma Dito, mostrando como o sistema valida o carregamento.
Como configurar o arquivo após envio:
Detalha como definir o formato do arquivo.
Como configurar o ID:
Descreve a etapa crucial de definir um identificador único para cada consumidor, como CPF, e-mail ou telefone, garantindo que não haja perfis duplicados na base de dados.
Como mapear os campos:
Explica o processo de "ligar" as colunas do seu arquivo de importação às características existentes na Dito.
Como criar uma nova característica extra:
Ensina como adicionar campos personalizados ao seu perfil de consumidor.
Veja os campos que não podem ser enviados ou atualizados via importação de base
Mostra os dados que não podem ser alterados ou criados por importação de base.
Como adicionar característica de Custom Data:
Mostra como atribuir um valor fixo a uma nova ou a uma característica já existente, o que facilita a segmentação e identificação de grupos de consumidores na base importada.
Como Remover valor de características:
Descreve a funcionalidade de apagar valores de características já existentes nos perfis dos consumidores, de forma opcional e em massa, sem a necessidade de editar cada perfil individualmente.
Como finalizar a importação de base e acompanhar sua validação:
Explica o processo final de revisão e envio da base, além de como monitorar o status da importação.

Veja o passo a passo para o envio de base:

O novo processo de importação de bases no App.dito foi reformulado em quatro etapas: [

Selecionar arquivo
Configurar arquivo
Configurar ID
Mapear campos.

Com esse processo, é possível validar arquivos, mapear dados, criar ou atualizar características e acompanhar todo o fluxo de forma simplificada.

Como selecionar e enviar o arquivo no App. Dito:

Depois, clique na aba Lista de importações e clique no botão importação de base:

Selecione um arquivo de acordo com o formato padrão:300mb e CSV. Para inserir o arquivo, é possível arrastar o arquivo ou selecionar clicando no botão "Selecionar arquivo".

Observações:

Só é possível concluir as etapas em ordem, por isso a etapa só ficará ativa após completar a etapa anterior.
O botão "Continuar" só ficará ativo para finalização da importação após as 4 etapas estarem completas.
Caso o usuário saia antes de salvar, irá perder o arquivo carregado e a etapa não será completa.

Após selecionar e enviar o arquivo, o sistema mostrará o Status do carregamento. Enquanto o arquivo estiver carregando, ainda é possível apagar o envio clicando no símbolo de lixeira.

Ao término do carregamento, o mesmo poderá ficará verde ao indicar sucesso no uplood. Somente após término do carregamento, o botão "Salvar" ficará disponível.

Ou vermelho indicando Erro no upload. No caso de erro, o usuário tem a opção de tentar novamente ou apagar o arquivo. O usuário pode clicar no botão ”Selecionar outro arquivo” para escolher outro, ou arrastar novamente.

Durante a verificação automática e carregamento do arquivo, podem ser identificadas algumas inconsistências no envio, como por exemplo: arquivo maior que 300MB, extensão inválida ou tentativa de enviar mais de um arquivo ao mesmo tempo. Quando isso acontecer, o sistema exibirá um alerta em vermelho na tela para sinalizar o problema conforme imagens a seguir.

Observação: Encoding do arquivo (Conjunto de caracteres) São suportados:

Unicode (UTF-8)
Europa ocidental (ISO-8859-1)
Europa ocidental (WINDOWS-1252)

Como configurar o arquivo após envio:

Nessa etapa, será necessário configurar o separador e o campo que identificará os consumidores.

As duas opções são:

1 - Separar colunas por virgula "," ou ponto e virgula ";"

2 - Delimitar texto por aspas duplas (”) ou aspas simples (‘).

Deve ser escolhida a opção conforme o arquivo foi gerado.

Exemplo: uso do separador de colunas e do delimitador de texto.

Após a configuração completa, o botão ”continuar” fica ativo.

Importante: A configuração do arquivo pode levar algum tempo para salvar as informações.

Como configurar o ID:

O ID é o identificador único de cada consumidor dentro da Dito. Ele garante que os dados sejam unificados corretamente e que não haja duplicidade de perfis. Por isso, é fundamental entender qual dado a marca utiliza por padrão em suas integrações antes de definir a opção mais adequada. Essa informação pode ser vista no plano de Tracking da marca.

As opções são:

CPF/CNPJ - São válidos apenas números (11 caracteres para CPF e 14 pra CNPJ)
E-mail - Devem estar no formato nome@exemplo.com.br
Telefone - São validados apenas números (no mínimo 10 caracteres, incluindo DDD)
SHA1 (hash) do telefone - Devem estar no formato SHA1
ID customizado - O campo não pode conter caracteres especiais
User ID (Exportado da Dito) - exatamente o mesmo dado exportado, contendo o prefixo “ID=”

Após selecionar o ID, defina qual a coluna do arquivo que enviou, será considerado como o ID do usuário.

Preview:

Depois que o usuário selecionar a Coluna, ela ficará em destaque na Tabela de preview
A coluna selecionada fica em destaque no canto esquerdo da tabela, fixada e separada por sombreamento.
Caso o usuário altere a coluna, a preview será alterada.

Após clicar em continuar, aparecerá uma mensagem de confirmação informando sobre a duplicação de fichas caso o ID escolhido não seja compatível com os já existentes para sua marca.

Como mapear os campos:

No processo de importação de bases na Dito, depois de definir o ID do consumidor, é hora de mapear as demais informações que vão enriquecer os perfis dos clientes. Esse passo é chamado de mapeamento de características. O mapeamento nada mais é do que “ligar” as colunas do seu arquivo às características existentes dentro da Dito. Assim, o sistema sabe exatamente onde cada informação deve ser registrada no perfil do consumidor.

Exemplo:

Se o seu arquivo tem uma coluna chamada Nome Completo, você pode associá-la à característica Nome da Dito.
Se houver uma coluna chamada Data de Nascimento, pode ser mapeada para Birthday.
Da mesma forma, uma coluna Cidade pode ser ligada à característica City.

A Dito já possui algumas características padrão, como Nome, E-mail, Telefone, Data de Nascimento, Gênero e Endereço. No entanto, se a marca tiver necessidades específicas, é possível criar características personalizadas e também incluí-las nesse mapeamento.
Esse cuidado é fundamental para que as informações da base fiquem organizadas, completas e prontas para serem usadas em segmentações, campanhas e análises. Quanto mais bem mapeados os dados, mais eficientes serão as estratégias de CRM. Veja o passo a passo a seguir:

Ao clicar em Mapear características:

É possível buscar a característica por campo do CSV, essa opção é ótima para arquivos grandes, ou com muitas colunas:

Ou fazer as associações de características direto na tela:

Na coluna "Campos do CSV" aparecerá todos os títulos das colunas inseridas no arquivo CSV carregado na importação:

Você irá associar cada coluna do seu arquivo a uma característica correspondente na Dito.
Ao clicar em “Selecionar” ou “Criar opção”, será exibida uma lista de opções. Nela, você poderá

selecionar uma característica padrão na Dito, ou seja, aquelas já pré-definidas pelo sistema ou adicionar uma característica extra já existente.

Como criar uma nova característica extra:

Em vez de escolher uma característica já existente (tanto padrão quanto extra) na Dito, você também pode criar uma nova característica extra diretamente no momento da importação.
Para isso, basta digitar no campo "selecione ou crie opção" o nome desejado para a nova característica. Se esse nome ainda não existir na lista, o sistema exibirá a opção com o texto digitado seguido da palavra “novo”. Isso indica que será criada uma nova característica com o nome informado, pronta para receber os dados daquela coluna do CSV.

Regras para criação de novas características:

Use apenas letras minúsculas;
Não utilize números, acentos, cedilha ou caracteres especiais;
Caso a palavra seja composta, use hífen (-) ou underline (_).

Após digitar a nova característica extra, o usuário precisa definir o tipo do campo: formato texto ou formato data.

Ao escolher o formato texto, nada mais precisa ser feito. Mas se escolher o formato data, é preciso definir o formato que este dado será inserido como padrão. Os formatos disponíveis são:

YYYY-MM-DD
YYYY/MM/DD
DD-MM-YYYY
DD/MM/YYYY
MM-DD-YYYY
MM/DD/YYYY

Veja os campos que não podem ser enviados ou atualizados via importação de base:

Algumas características não podem ser criadas, atualizadas ou importadas, pois são geradas automaticamente pela Dito. Veja abaixo a lista de quais são elas:

propensao_compra
propensao_compra_migracao
propensao_compra_pontos
rfm_category
rfm_segment
rfm_frequency
rfm_recency
rfm_monetary
rfm_aov
rfm_segment previous month
rfm_segment previous year
rfm_flg year group change
loja_preferencia
vendedor_preferencia

Caso o usuário tente criar uma nova característica repetida (já existente anteriormente ou criada recentemente), o nome ficará no modo "bloqueado" com uma caixa de aviso:

Caso o usuário digite algum caractere não permitido, o nome ficará no modo "bloqueado" e mostraremos as regras:

Após concluir a associação de todos os campos, os ícones centrais ficarão verdes, indicando que cada campo foi mapeado corretamente. Nesse momento, o botão “Continuar” será habilitado para que você prossiga com a importação.

No mapeamento de características, é possível ignorar campos específicos, mas não é permitido ignorar todos - pelo menos um deles precisa ser associado. Quando o usuário clica no ícone “Ignorar”, o campo correspondente fica desabilitado.

Quando ignorado, o campo do meio fica com o ícone ”Ignorado".

Depois que todos os campos da linha ficam desabilitados, é possível clicar no botão de ”Editar” para voltar a ação e selecionar o campo.

Como adicionar característica de Custom Data:

É possível atribuir um valor tanto a uma nova característica quanto a uma característica já existente na Dito para customizar uma segmentação. Esse valor será aplicado automaticamente a todas as linhas da coluna selecionada da base importada ou, caso seja criada uma nova coluna, será replicado em todas as linhas da base.

A interface exibirá o mesmo campo de seleção (Select) utilizado no mapeamento dos campos obrigatórios, o que torna a configuração simples e intuitiva. Essa personalização é especialmente útil porque permite identificar facilmente as fichas importadas na base, é uma customização que facilita a segmentação de dados. Assim, você consegue localizar os consumidores de forma mais rápida e direcionar campanhas de maneira mais estratégica e específica.

Caso o usuário opte por criar uma nova característica, será necessário definir também o formato do campo. Após concluir a seleção, o ícone central será exibido como um “check”, indicando que o mapeamento foi realizado com sucesso. É possível adicionar várias características em uma mesma importação, bem como excluir qualquer característica criada antes de salvar a sub-etapa, garantindo flexibilidade no processo de configuração.

Como Remover valor de características:

O usuário também tem a opção de “Remover valores de características (opcional)”. Para isso, basta clicar no Multiselect e escolher, entre as características já existentes na Dito, quais terão seus valores apagados.

É importante destacar:

Não é possível criar novas características nessa etapa;
A remoção só pode ser feita em características já existentes na Dito, não em dados do CSV que está sendo carregado;
Não é permitido apagar valores de características geradas automaticamente pela Dito.

Como finalizar a importação de base e acompanhar sua validação:

Após completar as quatro etapas de configuração da base importada na Dito, o botão salvar ficará disponível. Antes de clicar nele, ainda é possível clicar em uma das fases e editar algum dado.

Ao salvar, você terá uma pré visualização dos dados antes de finalizar e enviar. O previw da planilha é de até cinco linhas e é o mesmo mostrado na Etapa ”Configurar ID”, onde mostra uma tabela com todas as colunas e com a Coluna do ID fixa do lado esquerdo.

Após finalizar o envio da base, abrirá uma página com a lista de todas as importações já realizadas na marca e seus respectivos status.

Validando: o sistema está processando o arquivo e conferindo se os dados estão de acordo com as configurações definidas.

Concluído: o processamento terminou com sucesso e todos os dados do arquivo foram inseridos corretamente na plataforma.

Parcialmente concluído: o processamento foi realizado, mas algumas linhas do arquivo apresentaram inconsistências. Isso pode ocorrer, por exemplo, quando existem informações em formato diferente do padrão configurado ou registros duplicados.

Inválido: todas as linhas do arquivo apresentaram inconsistências em relação às configurações feitas. Nesse caso, nenhum dado é inserido, e o arquivo é considerado inválido.

A Dito disponibiliza um log de verificação da base, onde você pode conferir quais linhas foram importadas corretamente e quais apresentaram alguma divergência. Para acessar, basta ir até a lista de importações e clicar em “Baixar arquivo com log”, conforme mostrado na imagem a seguir:

Materiais de Apoio

Artigo Relacionado:
Validando erros na importação de base
Como validar sua base para importação

O artigo "Importando uma base no app.dito" detalha o novo processo de importação de dados na plataforma Dito, visando aprimorar a experiência do usuário. Ele descreve as quatro etapas do processo: selecionar o arquivo CSV, configurar o arquivo (definindo separador e delimitador de texto), configurar o identificador único dos consumidores (ID) e mapear os campos do arquivo para as características na Dito. Além disso, destaca melhorias como validação do arquivo e do mapeamento, visualização prévia da tabela, possibilidade de edição durante a importação e flexibilidade para criar ou remover características. Essas melhorias visam tornar o processo mais eficiente e organizado, permitindo que os dados sejam importados de forma estruturada e consistente, facilitando segmentações e campanhas mais precisas.

Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs)

Gostou, mas acha que algo pode melhorar?

Sua opinião é muito importante para nós! Se você tem alguma sugestão ou sentiu falta de algo neste módulo, queremos ouvir você.

Compartilhe suas ideias diretamente com nosso time de Produto através do link abaixo.

➡️ Acesse aqui o Portal de Ideias

FAQ – Perguntas Frequentes sobre a importação de base

1. Pergunta: Qual o prazo para a base ser aprovada?
Resposta: Após a configuração das etapas e finalização do processo, o sistema irá processar as informações e validar o carregamento de dados no app.dito. Esse processo demora alguns instantes pois entra em uma fila de carregamento de dados, o tamanho do arquivo e volumetria de informações também podem contribuir para que a base seja concluída mais ou menos rápida.

2. Pergunta: Minha base não foi 100% concluída, por que isso acontece?

Resposta: O sistema valida as células da planilha conforme a configuração feita e, se foi identificado dadas repetidos na planilha, ele não importa todas as linhas com esses dados para não gerar duplicidade de fichas. Outro ponto é que dados como e-mail ou telefone podem estar inválidos na planilha e por isso não serem importados.

3.Pergunta: Posso importar um arquivo que mistura CPF e e-mail como IDs na mesma coluna? Resposta: Não. A coluna definida como ID deve ter um formato único e consistente. Se você escolher CPF, todas as linhas devem conter apenas CPFs válidos. Se houver dados de e-mail na mesma coluna, o sistema não conseguirá processar a importação corretamente.

4.Pergunta: Após a importação, o que devo fazer se eu perceber que os dados foram mapeados de forma errada?
Resposta: Se os dados foram mapeados incorretamente, é necessário realizar uma nova importação com o mapeamento correto. Não há como "desfazer" uma importação ou reverter o mapeamento na plataforma. Por isso, a etapa de visualização prévia e a validação são tão importantes.