Guias
Analytics
Consulte audiência, tempo assistido e desempenho dos seus vídeos e transmissões.
A API de analytics expõe métricas de audiência consolidadas e por recurso: visualizações, tempo assistido, dispositivos e retenção.
Visualizações de um vídeo
curl "https://api.spalla.io/v1/analytics/video-views?video_key=a1b2c3d4&from=2026-10-01&to=2026-10-31" \
-H "Authorization: Bearer <seu-token>"Resposta (resumida):
{
"total_views": 1520,
"unique_users": 831,
"watch_time_minutes": 42150,
"by_day": [
{ "date": "2026-10-01", "views": 84 },
{ "date": "2026-10-02", "views": 121 }
]
}Métricas disponíveis
Prop
Tipo
Boas práticas
- Períodos longos: prefira consultas por mês; intervalos muito longos podem levar mais tempo para agregar.
- Consolide no seu lado: armazene os resultados diários no seu back-end e construa dashboards a partir deles, em vez de chamar a API a cada renderização de tela.
- Fuso horário: as métricas diárias são agregadas no fuso UTC — ajuste na exibição se sua operação trabalha em horário local.
Dados do player
As métricas são coletadas pelo player da Spalla. Reproduções fora do player oficial (por exemplo, HLS bruto em player próprio) podem não contar nas estatísticas.