Consulte os usuários conectados do Live Ingest
Consulte o dataset connectedUsersMetrics da GraphQL API para ler as sessões únicas das suas transmissões do Live Ingest, por host ou no total entre hosts.
Você pode contar as sessões únicas conectadas às suas transmissões do Live Ingest com o dataset connectedUsersMetrics da GraphQL API, por host ou no total entre todos os hosts. O dataset guarda dados agregados que o Live Ingest fornece, e o endpoint de métricas, https://api.azion.com/v4/metrics/graphql, os serve. Use os resultados para analisar a atividade da sua audiência ou para levá-los a outra plataforma de análise.
Pré-requisitos
- Uma assinatura do Live Ingest na sua conta. Para saber o que o Live Ingest faz, consulte Connectors.
- Um personal token da sua conta.
- Uma forma de enviar uma query GraphQL, como o GraphiQL ou o
curl. Para mais informações, consulte Primeiros passos com a GraphQL API.
Consulte as sessões únicas por host
Agrupe as linhas por ts e host para ler as sessões únicas de cada host em cada timestamp. Para consultar as sessões por host:
Esta query lê as sessões de todos os hosts em uma janela de um dia, da mais recente para a mais antiga. Substitua os valores de begin e end pela sua janela:
A query usa estes argumentos:
| Argumento | O que define |
|---|---|
limit | O número máximo de linhas retornadas, de 0 a 10000. Sem ele, a API retorna no máximo 10 linhas. |
filter | Os critérios que as linhas devem atender. Um filtro de tempo é obrigatório. tsRange recebe um timestamp begin e um end no formato "YYYY-MM-DDTHH:mm:ss". |
groupBy | Os campos que agrupam as linhas: ts, host ou ambos. [ts,host] retorna uma linha por timestamp e host. |
orderBy | A ordem das linhas. [ts_DESC] retorna primeiro o timestamp mais recente, e [ts_ASC], o mais antigo. |
O dataset connectedUsersMetrics não aceita o argumento resample.
Envie a query em uma requisição POST para https://api.azion.com/v4/metrics/graphql, com o header Authorization: Token [TOKEN VALUE].
A resposta traz um objeto por timestamp e host em data.connectedUsersMetrics, com os campos que a query seleciona:
| Campo | Tipo | Descrição |
|---|---|---|
ts | CustomDateTime | O timestamp do ponto de dados. |
host | String | O host da requisição: o nome do host da linha de requisição, o nome do host do header de requisição Host ou o nome do servidor que corresponde à requisição. |
uniqueSessions | Int | As sessões únicas contadas para o host. |
A API responde com HTTP 200 e retorna as linhas em data.connectedUsersMetrics.
Consulte o total entre hosts
O campo uniqueSessionsTotal conta as sessões únicas entre todos os hosts, por isso a query agrupa as linhas apenas por ts e deixa host de fora. Para consultar o total de sessões:
Esta query lê o total de sessões em uma janela de um dia, da mais recente para a mais antiga. Substitua os valores de begin e end pela sua janela:
limit aceita até 10000 linhas, filter exige um filtro de tempo como tsRange, e orderBy aceita [ts_DESC] ou [ts_ASC]. groupBy: [ts] retorna uma linha por timestamp.
Envie a query em uma requisição POST para https://api.azion.com/v4/metrics/graphql, com o header Authorization: Token [TOKEN VALUE].
A resposta traz um objeto por timestamp em data.connectedUsersMetrics, com os campos que a query seleciona:
| Campo | Tipo | Descrição |
|---|---|---|
ts | CustomDateTime | O timestamp do ponto de dados. |
uniqueSessionsTotal | Int | As sessões únicas contadas entre todos os hosts. |
A API responde com HTTP 200 e retorna as linhas em data.connectedUsersMetrics.