Como acessar seus dados de desempenho

Você pode consultar seus dados de desempenho rapidamente, sem exceder sua cota, executar uma consulta diária para dados de um dia.

Você precisa escolher quais informações quer nos seus dados: quais tipos de pesquisa (Web, imagem, vídeo etc.) e quais dimensões (página, consulta, país ou dispositivo), além de agrupar os resultados por página ou propriedade. Ao consultar a página e/ou a string de consulta, alguns dados podem ser descartados (saiba por que).

Visão geral

Recomendamos executar uma consulta por dia para um dia de dados usando um dos estilos de consulta descritos abaixo. A execução de uma consulta diária para um dia de dados não deve exceder sua cota diária. Normalmente, os dados ficam disponíveis após dois a três dias. Para saber quais são os dados mais recentes, execute uma consulta simples agrupada por data nos ú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 em sua consulta. Observação: os dados de aparência da pesquisa (AMP, link azul, resultado aprimorado etc.) precisam ser consultados usando um processo em duas etapas.
Navegue pelos resultados executando a mesma consulta novamente, 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.

Confira um exemplo de pseudocódigo para uma única consulta. É possível executar esse processo uma vez por dia para cada valor de type 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 e por tipo de pesquisa (Web, imagem e assim por diante, classificada por cliques).

Detalhes da consulta

Você pode consultar os dados agrupados por página ou propriedade.

Agrupados por página

Para contar com precisão, omita as dimensões da página e da consulta, como esta:

"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: opcionalmente, inclua country e/ou device.
type: enumera cada valor type conforme desejado em uma consulta separada.
aggregationType: precisa ser byPage.

Para mais detalhes, incluindo informações de página e/ou consulta, em detrimento da perda de 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 um período de um dia selecionando a mesma data.
dimensions: inclui page. Inclua, se quiser, qualquer combinação de query, country ou device.
type: enumerar em cada valor type, conforme desejado em uma consulta separada.

Agrupado por propriedade

Para ter contagens precisas, omita as dimensões de página e consulta da seguinte maneira:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"

startDate / endDate: escolha um período de um dia selecionando a mesma data.
dimensions: inclua opcionalmente country e/ou device.
type: enumerado opcionalmente em cada valor type, conforme desejado em uma consulta separada.

Para mais detalhes, incluindo informações de consulta, país e/ou dispositivo, em detrimento da perda de alguns dados, execute uma consulta como esta:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"

startDate / endDate: escolha um período de um dia selecionando a mesma data.
dimensions: inclua opcionalmente qualquer combinação de query, country ou device.
type: enumera cada valor type conforme desejado 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 maneira diferente ao agrupar resultados por página em vez de por propriedade. Saiba mais.

Por que perco dados ao pedir mais detalhes?

Quando você agrupa por página e/ou consulta, nosso sistema pode eliminar alguns dados para calcular os resultados em um tempo razoável usando uma quantidade razoável de recursos de computação.

Como receber dados do aspecto da pesquisa

A aparência da pesquisa não está disponível como uma coluna com outras dimensões. Portanto, se você quiser ver informações de aspecto da pesquisa do seu site, siga este processo:

Especifique searchAppearance como a única dimensão, que vai agrupar todos os dados por tipo de aspecto da pesquisa sem outras dimensões.
Se preferir, execute uma segunda consulta filtrando por um dos tipos de aspecto da pesquisa listados na etapa 1 e adicionando as dimensões desejadas à consulta (página, país, consulta etc.).

Para extrair dados sobre vários tipos de aspecto da pesquisa, execute a segunda etapa uma vez para cada tipo de aspecto da pesquisa listado na etapa 1.

Primeira consulta:

Receba uma lista de tipos de aspecto da pesquisa no seu site.

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "searchAppearance"
  ]
}

Resultados:

Seu site tem o tipo INSTANT_APP, AMP_BLUE_LINK e assim por diante.

 "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 aparência de pesquisa encontrado na etapa 1, com as 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"
        }
      ]
    }
  ]
}