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:

nameemailgenderbirthdaylocation
Bruno de Paula Dias[email protected]male1990-01-10Belo Horizonte
Mariana Faria[email protected]female1980-02-15São Paulo

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

telefoneendereconewslettertipo_pessoa
+55(11)99402-9402Alameda Santos, 85 - JardinssimPessoa Física
+55(31)7432-7432Avenida Amazonas, 1789 - PradonaoPessoa Jurídica

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.

idrevenuecreated_at
[email protected]228.002015-12-24 19:23:15 -0300

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

id_transacaoid_produtonome_produtocategoria_produtosubcategoria_produtometodo_pagamentopreco_produtoquantidadetotal_fretetotal_descontoid
100002099877Blusa manga longa - pretoBlusaBlusa manga longaBoleto bancário100.00230.002.00[email protected]

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