Devuelve estadísticas de todas las sesiones de un reproductor
Devuelve los totales de las sesiones de un reproductor en el periodo: views, plays, finalizaciones, clics, engagement, retención en el pitch y conversiones.
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/sessions/stats" \ -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" }'{ "total_viewed": 200, "total_viewed_session_uniq": 190, "total_viewed_device_uniq": 180, "total_started": 120, "total_started_session_uniq": 115, "total_started_device_uniq": 110, "total_finished": 40, "total_finished_session_uniq": 38, "total_finished_device_uniq": 36, "total_clicked": 50, "total_clicked_session_uniq": 45, "total_clicked_device_uniq": 44, "total_over_pitch": 30, "total_under_pitch": 10, "total_conversions": 5, "overall_conversion_rate": 4.54, "total_amount_usd": 0, "total_amount_brl": 98500, "total_amount_eur": 0, "engagement_rate": "35.27", "over_pitch_rate": "75.25", "play_rate": "61.11"}Estadísticas usadas por el panel de titulares POST
Devuelve un elemento por titular de la prueba de titulares del reproductor, con views, plays, engagement, retención en el pitch, clics y conversiones. Las fechas se leen en UTC. Si el reproductor no existe en la empresa, la respuesta es `400` con `{"error": ["Player could not be found for the current request"]}`.
Devuelve estadísticas de todas las sesiones de un reproductor por día POST
Devuelve las mismas estadísticas que `POST /sessions/stats`, un elemento por día del periodo, en la zona horaria de `timezone`. Los días sin sesiones vienen con ceros.