API de AnalyticsEndpoints

Retorna as conversões de um player para cada segundo do vídeo

Retorna, para cada segundo do vídeo, as conversões cujo comprador clicou naquele segundo, com totais acumulados. Uma conversão é datada pelo clique que levou a ela.

POST
/conversions/video_timed

Authorization

apiToken apiVersion userAgent
X-Api-Token<token>

Acesse a aplicação e copie seu token de API, em seguida, defina o cabeçalho X-Api-Token com ele.

In: header

X-Api-Version<token>

A versão da API a ser usada. As versões suportadas atualmente são:

  • v1: A versão estável atual

Uma requisição sem este cabeçalho, ou com qualquer outro valor, é respondida pela borda com 404 e {"error_msg":"404 Route Not Found"}.

In: header

User-Agent<token>

É obrigatório enviar um User-Agent não vazio identificando sua integração. Requisições sem ele são rejeitadas na borda antes de chegar à API.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/conversions/video_timed" \  -H "Content-Type: application/json" \  -d '{    "player_id": "64a5c8072e6fd10009828db2",    "start_date": "2026-09-01 00:00:00",    "end_date": "2026-09-30 23:59:59",    "timezone": "America/Sao_Paulo",    "pitch_time": 300,    "video_duration": 1200  }'
[  {    "timed": 300,    "timed_conversions": 2,    "cumulative_conversions": 2,    "timed_amount_usd": 0,    "cumulative_amount_usd": 0,    "timed_amount_brl": 39400,    "cumulative_amount_brl": 39400,    "timed_amount_eur": 0,    "cumulative_amount_eur": 0  },  {    "timed": 420,    "timed_conversions": 1,    "cumulative_conversions": 3,    "timed_amount_usd": 0,    "cumulative_amount_usd": 0,    "timed_amount_brl": 19700,    "cumulative_amount_brl": 59100,    "timed_amount_eur": 0,    "cumulative_amount_eur": 0  }]