Retorna até onde as sessões chegaram, separado por um campo da sessão
Retorna a mesma distribuição de `POST /times/user_engagement`, separada pelo valor de um campo da sessão, como o país ou o navegador. Só contam as sessões cujo campo tem um dos `values`.
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_by_field" \ -H "Content-Type: application/json" \ -d '{ "player_id": "64a5c8072e6fd10009828db2", "field": "country", "values": [ "Brazil" ], "start_date": "2026-09-01 00:00:00", "end_date": "2026-09-30 23:59:59", "timezone": "America/Sao_Paulo" }'[ { "grouped_key": "Brazil", "grouped_values": [ { "timed": 30, "total_users": 58 } ] }]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.
Retorna até onde as sessões chegaram, separado por um parâmetro de consulta da página POST
Retorna a mesma distribuição de `POST /times/user_engagement`, separada pelo valor de um parâmetro de consulta da URL da página, como `utm_source`. Só contam as sessões cujo parâmetro tem um dos `values`.