post http://events.plataformasocial.com.br/users/
Track do usuário na API.
ATENÇÃO!
Os nomes dos eventos DEVEM ser enviados para a Dito em letras minúsculas, sem acentuação ou caracteres especiais. Caso o nome de suas ações seja composto por mais de uma palavra, estas devem ser separadas por hífen '-'.
Exemplo:
meu-evento-1
meu-evento-2Os nomes das propriedades dos eventos enviados dentro do nó data 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
Parâmetros da URL
Parâmetro | Obrigatório | Tipo | Descrição |
---|---|---|---|
id | Sim | String | Identificador do usuário na Dito. Ex.: CPF do usuário (somente números), SHA1 do e-mail, ID do banco de dados. |
Parâmetros da requisição
Parâmetro | Obrigatório | Tipo | Descrição |
---|---|---|---|
id_type | Sim | String | Neste campo deve ser enviado uma string com o valor "id". |
sha1_signature | Sim | String | Assinatura gerada via hash SHA1 do APP_SECRET . |
platform_api_key | Sim | String | APP_KEY do aplicativo. |
network_name | Sim | String | Neste campo deve ser enviado uma string com o valor "pt". |
encoding | Não | String | Codificação utilizada para a assinatura (base64 ou nenhuma codificação se não informado). |
event | Sim | String (com formatação de JSON) | Dados do evento a ser trackeado na plataforma Dito. É informado três valores: action (Obrigatório): Nome da ação que o usuário está fazendo; revenue : Caso o evento tenha gerado uma receita para o aplicativo/ambiente trackeado essa receita/valor financeiro deve ser enviada nesse campo; created_at (Opcional): Data e hora em que o evento aconteceu. Caso não seja informado, a data/hora atual será considerada. data (Opcional): Dados do evento que devem ser armazenados, mas que não se encaixam nos outros campos. Veja os formatos de datas suportados para ver como enviar datas e horários corretamente. |
Exemplo de Retorno
{
"data": [{
"data": {
"filme_id": '59',
"filme_titulo": 'Wolverine: Imortal',
"filme_thumb": 'http://ia.media-imdb.com/images/M/MV5BNzg1MDQxMTQ2OF5BMl5BanBnXkFtZTcwMTk3MjAzOQ@@._V1_SX214_.jpg',
"year": "2013",
"rating": "PG-13"
},
"revenue": 5.99,
"feedable": true,
"shareable": true,
"referrer": "http://apps.facebook.com/ingresso_staging/",
"referral_code": null,
"reference": "XXXXXXXXXX",
"created_at": "2013-11-27T11:28:32-02:00",
"id": 27,
"action": "watch",
"utm": {
"source": "direct"
},
"origin": {
"signin_count": 2,
"signup_count": 0,
"shares_count": 1,
"revenue": 5.99,
"clicks_count": 1
},
"user": {
"picture_url": "http://graph.facebook.com/XXXXXXXXXX/picture?type=square",
"reference": "XXXXXXXXXX",
"networks": {
"facebook": {
"name": "Marcos Nogueira",
"link": "http://www.facebook.com/profile.php?id=XXXXXXXXXX",
"social_id": "XXXXXXXXXX",
"picture_url": "http://graph.facebook.com/XXXXXXXXXX/picture?type=square"
}
}
}
}]
}