Devuelve la tasa de engagement de un reproductor de cada día
Devuelve la tasa de engagement de cada día del periodo, en la zona horaria de `timezone`. Los días sin sesiones vienen con 0.
Authorization
apiToken apiVersion userAgent Accede a la aplicación y copia tu token de API; luego, solo tienes que definir el encabezado X-Api-Token con él.
In: header
La versión de la API que se usará. Las versiones compatibles actualmente son:
- v1: La versión estable actual
Una solicitud sin este encabezado, o con cualquier otro valor, la responde el edge con 404 y {"error_msg":"404 Route Not Found"}.
In: header
Se requiere un User-Agent no vacío que identifique tu integración.
Las solicitudes sin él se rechazan en el edge antes de llegar a la 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 }]Devuelve hasta dónde llegaron en el vídeo las sesiones de un reproductor POST
Devuelve, para cada segundo del vídeo, cuántas sesiones se detuvieron allí (el punto más avanzado al que llegaron en el vídeo), con el tiempo promedio visto y la tasa de engagement. Los elementos son una distribución, no un conteo acumulado: para saber cuántas sesiones llegaron al segundo T, suma el `total_users` de todos los elementos cuyo `timed` sea T o mayor.
Devuelve hasta dónde llegaron las sesiones, separado por un campo de la sesión POST
Devuelve la misma distribución que `POST /times/user_engagement`, separada por el valor de un campo de la sesión, como el país o el navegador. Solo cuentan las sesiones cuyo campo tiene uno de los `values`.