É possível consultar seus dados de desempenho rapidamente e sem exceder sua cota, executando uma consulta diária de dados de um dia.
Você precisa escolher quais informações quer incluir nos seus dados: tipos de pesquisa (Web, imagem, vídeo etc.) e quais dimensões (página, consulta, país ou dispositivo) e se você quer agrupar resultados por página ou propriedade. Ao consultar a página e/ou a string de consulta, alguns dados podem ser descartados (veja o motivo).
Visão geral
- Recomendamos a execução de uma consulta todos os dias com os dados de um dia usando um dos estilos de consulta descritos abaixo. A execução de uma consulta diária de um dia não pode exceder a
cota diária. Normalmente, os dados ficam disponíveis após dois ou três dias. É possível saber quais são os dados mais recentes executando uma consulta simples agrupada por data dos últimos 10 dias. Ao escrever sua consulta:
- Escolha se você quer agrupar os resultados por página ou propriedade.
- Escolha se você quer contagens mais completas ou mais dimensões na sua consulta. Observação: os dados de aspecto da pesquisa (AMP, link azul, pesquisa aprimorada etc.) precisam ser consultados usando um processo de duas etapas.
- Percorra os resultados executando novamente a mesma consulta, aumentando o valor de
startRow
em 25.000 na solicitação até chegar à última página (uma resposta com 0 linhas). - Opcionalmente, execute a mesma consulta com outro parâmetro
type
.
Veja um exemplo de pseudocódigo para uma única consulta. É possível executá-lo uma vez por dia
para cada valor de type
de que você quer dados.
int maxRows = 25000; // Current max response size int i = 0; do { response = Request(startDate = 3_days_ago, endDate = 3_days_ago, ... add dimensions, type ... rowLimit = maxRows, startRow = i * maxRows); i++; … // Do something with the response data. } while (response.rows.count() != 0); // Page through all result rows
Limites de dados
Além da cota de uso da API, o método Search Analytics expõe no máximo 50 mil linhas de dados por dia por tipo de pesquisa (Web, imagem e assim por diante, classificadas por cliques).
Detalhes da consulta
É possível consultar dados agrupados por página ou propriedade.
Agrupados por página
Para contagens precisas, é preciso omitir as dimensões da página e da consulta, desta forma:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web", "aggregationType": "byPage"
startDate
/endDate
: escolha uma janela de um dia selecionando a mesma data.dimensions
: incluicountry
e/oudevice
(opcional).type
: enumera mais de cada valor detype
conforme pretendido em uma consulta separada.aggregationType
: precisa serbyPage
.
Para mais detalhes, incluindo informações de página e/ou consulta, às custas de perder alguns dados, execute uma consulta como esta:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["page", "query", "country", "device"], "type": "web"
startDate
/endDate
: escolha uma janela de um dia selecionando a mesma data.dimensions
: incluipage
. Também é possível incluir qualquer combinação dequery
,country
oudevice
.type
: enumera mais de cada valor detype
conforme pretendido em uma consulta separada.
Agrupados por propriedade
Para contagens precisas,é preciso omitir as dimensões da página e da consulta, desta forma:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web"
startDate
/endDate
: escolha uma janela de um dia selecionando a mesma data.dimensions
: incluicountry
e/oudevice
(opcional).type
: enumera opcionalmente sobre cada valortype
conforme desejado em uma consulta separada.
Para mais detalhes, incluindo informações de consulta, país e/ou dispositivo, às vezes, execute uma consulta como esta:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["query", "country", "device"], "type": "web"
startDate
/endDate
: escolha uma janela de um dia selecionando a mesma data.dimensions
: opcionalmente, inclui qualquer combinação dequery
,country
oudevice
.type
: enumera mais de cada valor detype
conforme pretendido em uma consulta separada.
Agrupar resultados por página ou propriedade
As impressões, os cliques, a posição e a taxa de cliques são calculados de forma diferente ao agrupar os resultados por página, e não por propriedade. Saiba mais
Por que perco dados quando peço mais detalhes?
Quando você agrupa por página e/ou consulta, nosso sistema pode remover alguns dados para calcular resultados em um tempo razoável usando uma quantidade razoável de recursos de computação.
Como receber dados de aspecto da pesquisa
O aspecto da pesquisa não está disponível como uma coluna, nem com outras dimensões. Portanto, se você quiser ver informações de aspecto da pesquisa para seu site, siga este processo:
- Especifique
searchAppearance
como a única dimensão, que agrupará todos os dados pelo tipo de aspecto da pesquisa sem outras dimensões. - Opcionalmente, execute uma segunda consulta, filtrando por um dos tipos de aspecto da pesquisa listados na etapa 1, adicionando as dimensões desejadas à consulta (página, país, consulta etc.).
Para recuperar dados sobre vários tipos de aspecto da pesquisa, execute a segunda etapa uma vez para cada tipo listado na etapa 1.
Primeira consulta:
Veja uma lista dos tipos de aspecto da pesquisa no seu site.
{ "startDate": "2018-05-01", "endDate": "2018-05-31", "type": "web", "dimensions": [ "searchAppearance" ] }
Resultados:
O tipo de site é INSTANT_APP, AMP_BLUE_LINK etc.
"rows": [ { "keys": [ "INSTANT_APP" ], "clicks": 443024.0, "impressions": 4109826.0, "ctr": 0.10779629113251997, "position": 1.088168452873674 }, { "keys": [ "AMP_BLUE_LINK" ], "clicks": 429887.0, "impressions": 1.7090884E7, "ctr": 0.025152999692701676, "position": 7.313451603790653 },...
Segunda consulta:
Filtre por um dos tipos de aspecto da pesquisa encontrados na etapa 1, além das dimensões que você quiser (página, dispositivo etc.). Aqui, filtramos por AMP_BLUE_LINK.
{ "startDate": "2018-05-01", "endDate": "2018-05-31", "type": "web", "dimensions": [ "device" // and/or page, country, ... ], "dimensionFilterGroups": [ { "filters": [ { "dimension": "searchAppearance", "operator": "equals", "expression": "AMP_BLUE_LINK" } ] } ] }
Resultados:
Detalhamento de AMP_BLUE_LINK por tipos de dispositivos.
"rows": [ { "keys": [ "MOBILE" ], "clicks": 429887.0, "impressions": 1.7090783E7, "ctr": 0.025153148337323107, "position": 7.31339517914422 }, { "keys": [ "DESKTOP" ], "clicks": 0.0, "impressions": 66.0, "ctr": 0.0, "position": 12.257575757575758 }, ...