InicioGuíasReferencia de la API
API de AnalyticsEndpoints

Devuelve estadísticas de todas las sesiones de un reproductor por día

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.

POST
/sessions/stats_by_day

Authorization

apiToken apiVersion userAgent
X-Api-Token<token>

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

X-Api-Version<token>

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

User-Agent<token>

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_by_day" \  -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"  }'
[  {    "date_key": "2026-09-01",    "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"  }]

Devuelve estadísticas de todas las sesiones de un reproductor POST

Devuelve los totales de las sesiones de un reproductor en el periodo: views, plays, finalizaciones, clics, engagement, retención en el pitch y conversiones.

Devuelve estadísticas agrupadas por un campo especificado POST

Devuelve las mismas estadísticas que `POST /sessions/stats`, un elemento por valor de un campo de la sesión, como el navegador o el país.