Como receber dados de desempenho

É 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

  1. 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.
  2. 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).
  3. 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: inclui country e/ou device (opcional).
  • type: enumera mais de cada valor de type conforme pretendido em uma consulta separada.
  • aggregationType: precisa ser byPage.

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: inclui page. Também é possível incluir qualquer combinação de query, country ou device.
  • type: enumera mais de cada valor de type 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: inclui country e/ou device (opcional).
  • type: enumera opcionalmente sobre cada valor type 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 de query, country ou device.
  • type: enumera mais de cada valor de type 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:

  1. Especifique searchAppearance como a única dimensão, que agrupará todos os dados pelo tipo de aspecto da pesquisa sem outras dimensões.
  2. 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
  },
...