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
- 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:
name | gender | birthday | location | |
---|---|---|---|---|
Bruno de Paula Dias | [email protected] | male | 1990-01-10 | Belo Horizonte |
Mariana Faria | [email protected] | female | 1980-02-15 | Sã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
telefone | endereco | newsletter | tipo_pessoa |
---|---|---|---|
+55(11)99402-9402 | Alameda Santos, 85 - Jardins | sim | Pessoa Física |
+55(31)7432-7432 | Avenida Amazonas, 1789 - Prado | nao | Pessoa 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.
id | revenue | created_at |
---|---|---|
[email protected] | 228.00 | 2015-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_transacao | id_produto | nome_produto | categoria_produto | subcategoria_produto | metodo_pagamento | preco_produto | quantidade | total_frete | total_desconto | id |
---|---|---|---|---|---|---|---|---|---|---|
100002099 | 877 | Blusa manga longa - preto | Blusa | Blusa manga longa | Boleto bancário | 100.00 | 2 | 30.00 | 2.00 | [email protected] |
Clique aqui para acessar um arquivo-padrão de exemplo.
Updated 3 months ago