A API da Kinsta agora fornece mais informações sobre o tráfego que chega aos seus ambientes WordPress, incluindo quais agentes de usuário e navegadores estão fazendo solicitações, de onde essas solicitações foram encaminhadas, quais hosts elas alcançaram e quais redes estão por trás delas.
Cinco novos endpoints de análises fornecem esses dados de forma programática, complementando os dados de países, cidades, IPs de clientes, distribuição de visitas e códigos de resposta já disponíveis por meio da API.
Todos os cinco endpoints oferecem os mesmos controles de período usados pelos nossos outros endpoints de análises. Você pode solicitar dados de 24_hours, 7_days, 30_days ou 60_days, ou usar from e to para definir um intervalo de datas personalizado.
Veja quais agentes de usuário e navegadores estão fazendo solicitações
Dois novos endpoints fornecem diferentes visualizações dos softwares que fazem solicitações a um ambiente.
O endpoint de principais agentes de usuário retorna as strings de agente de usuário associadas ao maior número de solicitações. Isso revela o identificador bruto enviado por um navegador, crawler, ferramenta de linha de comando ou outro cliente.
Por exemplo, a solicitação a seguir recupera os principais agentes de usuário dos últimos 30 dias:
curl -i -X GET \
'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/top-uas?company_id={company_id}&time_span=30_days' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'Uma resposta tem a seguinte aparência:
{
"analytics": {
"analytics_response": {
"key": "user_agents",
"data": [
{
"name": "Mozilla/5.0",
"views": "1000"
}
]
}
}
}Se você quiser identificar o navegador, em vez da string completa do agente de usuário, use o endpoint de principais navegadores. A resposta agrupa as solicitações por navegadores, como o Chrome:
{
"analytics": {
"analytics_response": {
"key": "browsers",
"data": [
{
"name": "Chrome",
"views": "1000"
}
]
}
}
}Você encontra todos os detalhes das solicitações e respostas na documentação da API.
Encontre as principais origens que enviam tráfego ao seu site
O novo endpoint de principais origens mostra quais origens estão associadas às solicitações feitas a um ambiente.
Isso oferece outra maneira de analisar a origem do tráfego sem precisar extrair manualmente os dados do MyKinsta ou dos seus próprios registros. Por exemplo, você pode usá-lo em um relatório interno que monitora quanto tráfego de referência vem de um domínio específico.
curl -i -X GET \
'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/top-referrers?company_id={company_id}&time_span=30_days' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'A resposta inclui cada origem e sua respectiva contagem de solicitações:
{
"analytics": {
"analytics_response": {
"key": "referrers",
"data": [
{
"name": "google.com",
"views": "1000"
}
]
}
}
}Consulte a documentação da API sobre as principais origens para conferir todos os parâmetros compatíveis.
Verifique quais hosts estão recebendo solicitações
Para ambientes que recebem tráfego por diferentes domínios ou hostnames, o endpoint de principais hosts permite identificar quais hosts concentram o maior número de solicitações.
Veja um exemplo referente aos últimos 30 dias:
curl -i -X GET \
'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/top-hosts?company_id={company_id}&time_span=30_days' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'A resposta lista cada host e o número de solicitações associadas a ele:
{
"analytics": {
"analytics_response": {
"key": "hosts",
"data": [
{
"name": "example.com",
"views": "1000"
}
]
}
}
}Você encontra mais detalhes na documentação da API sobre os principais hosts.
Veja de quais redes vêm as solicitações
O novo endpoint de principais ASNs agrupa as solicitações por Número de Sistema Autônomo (ASN). Um ASN identifica a rede responsável por rotear um bloco de endereços IP, portanto, esses dados podem ajudar a investigar a origem de um grande volume de tráfego.
Por exemplo:
curl -i -X GET \
'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/top-asns?company_id={company_id}&time_span=30_days' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'A resposta lista os ASNs junto com suas respectivas contagens de solicitações:
{
"analytics": {
"analytics_response": {
"key": "asns",
"data": [
{
"name": "AS12345",
"views": "1000"
}
]
}
}
}Consulte a documentação da API sobre os principais ASNs para conferir o formato completo das solicitações e respostas.
Mais dados sobre os visitantes por meio da API da Kinsta
Esses cinco endpoints ampliam os dados sobre os visitantes que você pode recuperar por meio da API da Kinsta, complementando as análises existentes de países, cidades, IPs de clientes e distribuição de visitas.
Juntos, eles fornecem mais detalhes sobre as solicitações que chegam aos seus ambientes WordPress, incluindo os navegadores e agentes de usuário por trás delas, de onde o tráfego foi encaminhado, quais hosts recebem as solicitações e de quais redes elas se originam.
Você pode usar esses dados em seus próprios painéis de controle, relatórios, ferramentas de monitoramento ou fluxos de trabalho automatizados. Confira todos os endpoints disponíveis na documentação da API da Kinsta.