Retorna até onde as sessões de um player chegaram no vídeo
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.
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" \ -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" }'{ "grouped_timed": [ { "timed": 30, "total_users": 58 } ], "average_watched_time": 900.9, "engagement_rate": 38.5}Retorna rankings de players baseados em métricas de engajamento do vídeo POST
Classifica os players da empresa por quantas sessões tiveram um evento em um período. Vários rankings, cada um com seu evento, período e tamanho, podem ser pedidos em uma chamada. Os períodos são dias inteiros no fuso de `timezone`.
Retorna a taxa de engajamento de um player para cada dia POST
Retorna a taxa de engajamento de cada dia do período, no fuso de `timezone`. Dias sem sessões vêm com 0.