CSV, importando Usuarios e Eventos

Disposições Gerais

O cadastro de usuários e eventos na plataforma da Dito podem ser feitos através da leitura de arquivos de extensão .CSV. Este recurso é útil quando deseja-se importar dados retroativos à data do tracking do site. Este documento visa estabelecer o padrão em que os arquivos .csv devem ser enviados, para que os usuários e eventos sejam enviados para a plataforma em até 24h.

Gerando seu arquivo CSV

Abra seu arquivo XLS no excel.
Clique na opção File -> salvar como.
Escolha o formato Windows Comma Separated Values (.csv)

Após ter salvo seu arquivo como CSV, abra seu arquivo no Bloco de Notas e novamente
escolha a opção Salvar Como.

Quando a tela de salvar abrir há um campo select na parte inferior chamado Codificação,
escolha UTF-8 nesse campo e salve novamente seu arquivo.

Envio de Usuários

Por padrão, a Dito aceita uma determinada lista de informações pessoais sobre seus usuários. São elas:

• Nome
• E-mail
• Sexo
• Data de nascimento
• Cidade

Estes campos, se disponíveis, devem estar presentes no cabeçalho do arquivo em língua inglesa conforme a imagem abaixo:

Dados Customizados de Usuários

Além destas informações, quaisquer outros dados que caracterizem seus usuários podem ser cadastrados na plataforma. Estes serão enviados como “dados customizados” e poderão ser utilizados nas criações de filtros e outras opções de segmentação. Abaixo, exemplos de dados que podem ser enviados como dados customizados:

• Telefone
• Endereço
• Newsletter

Os dados customizados podem ser enviados em língua portuguesa, porém, DEVEM estar em letras minúsculas, sem acentuação ou caracteres especiais. Caso o nome de suas propriedades seja composto por mais de uma palavra, estas devem ser separadas por underscore '_' no padrão snake case.

Exemplo:
minha_propriedade_1
minha_propriedade_2

Clique aqui para acessar um arquivo-padrão de exemplo.

Validações

Seguem abaixo considerações acerca das validações feitas em cada campo. Qualquer valor fora dos padrões estipulados NÃO SERÁ IMPORTADO.

name: O campo nome não deve possuir valores numéricos [0~9]. Apenas as primeiras letras de cada nome serão maiúsculas.
email: O campo e-mail passa por validação de formato apenas. Nenhum web-service é acionado para validação dos e-mails. Os e-mails serão importados com todas as letras minúsculas.
gender: O campo gender aceita apenas ‘male’ para masculino e ‘female’ para feminino.
birthday: Deve estar em um dos formatos de data válidos, descritos na documentação específica. Recomenda-se AAAA-MM-DD (Ano-Mês-Dia) para este campo.
location: Não possui nenhuma validação.

Campos de “dados_customizados” não são validados, exceto:

telefone: Deve ser informado o DDD do número. O código +55 será adotado sempre que o DDI não for informado.
cpf: Validação do dígito verificador (verifica se o CPF é válido).

Envio de Eventos

Também e possivel realizar o envio de eventos através da leitura de arquivos extensão .CSV. Os campos padrão de criação de eventos devem ser enviados em língua inglesa conforme descrito abaixo:

• id: Identificador do usuário que realizou determinado evento. Deve ser enviado o mesmo identificador utilizado no cadastro do usuario na plataforma.(Ex: E-mail).
• *revenue: Receita gerada pelo evento. (Ex: valor total da compra).
• *created_at: Data em que o evento ocorreu. Deve estar em um dos formatos de data válidos, descritos na documentação específica. Recomenda-se o seguinte formato para data/hora: AAAA-MM-DD HH:MM:SS -0300

🚧

Atenção

A operação de upload de dados de eventos é realizada pela equipe da Dito pontualmente e não está disponível na interface da plataforma da Dito.

Acerca dos Campos Obrigatórios

• O campo revenue não é obrigatório. Eventos sem revenue não irão contabilizar receita.
• O campo created_at não é obrigatorio. Porém, ao enviar dados retroativos é muito importante ter a data exata em que os eventos ocorreram para efeitos de segmentação.
• Todos os eventos enviados sem a data de ocorrência serão aceitos pela plataforma, que irá atribuir automaticamente a data do dia do envio para cada evento.

Dados Customizados de Eventos

Assim como os usuários, os eventos também podem possuir dados customizados. Quaisquer informações que complementem o evento podem ser enviadas. Exemplos:

• Id da compra
• Id do produto
• Descrição do produto
• Valor do produto
• Imposto
• Frete
• Forma de Pagamento

As propriedades customizadas de eventos também DEVEM estar em letras minúsculas, sem acentuação ou caracteres especiais. Caso o nome de suas propriedades seja composto por mais de uma palavra, estas devem ser separadas por underscore '_' no padrão snake case.

Exemplo:
minha_propriedade_1
minha_propriedade_2

Clique aqui para acessar um arquivo-padrão de exemplo.