Retorna a taxa de engajamento de um player para cada dia
Retorna a taxa de engajamento de cada dia do período, no fuso de `timezone`. Dias sem sessões vêm com 0.
Authorization
apiToken apiVersion userAgent Acesse a aplicação e copie seu token de API, em seguida, defina o cabeçalho X-Api-Token com ele.
In: header
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
É 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/times/user_engagement_by_day" \ -H "Content-Type: application/json" \ -d '{ "player_id": "64a5c8072e6fd10009828db2", "video_duration": 3600, "start_date": "2026-09-01 00:00:00", "end_date": "2026-09-30 23:59:59", "timezone": "America/Sao_Paulo" }'[ { "date": "2026-09-01", "engagement_rate": 23.4 }]Retorna até onde as sessões de um player chegaram no vídeo POST
Retorna, para cada segundo do vídeo, quantas sessões pararam ali (o ponto mais avançado a que chegaram no vídeo), com o tempo médio assistido e a taxa de engajamento. Os itens são uma distribuição, não uma contagem acumulada: para saber quantas sessões chegaram ao segundo T, some o `total_users` de todos os itens cujo `timed` seja T ou maior.
Retorna até onde as sessões chegaram, separado por um campo da sessão POST
Retorna a mesma distribuição de `POST /times/user_engagement`, separada pelo valor de um campo da sessão, como o país ou o navegador. Só contam as sessões cujo campo tem um dos `values`.