Como acessar seus 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 em 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 se é necessário agrupar os resultados por página ou propriedade. Ao consultar uma página e/ou string de consulta, alguns dados podem ser descartados (confira os motivos).

Visão geral

  1. Recomendamos executar uma consulta diária para dados de um dia usando um dos estilos de consulta descritos abaixo. A execução de uma consulta de dados diária para um dia não deve exceder sua cota diária. Normalmente, os dados ficam disponíveis após 2 a 3 dias. Para saber quais são os dados disponíveis mais recentemente, 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 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 startRow em 25.000 na solicitação até chegar à última página (uma resposta com nenhuma linha).
  3. Se quiser, execute a mesma consulta com outro parâmetro type.

Aqui está um exemplo de pseudocódigo para uma única consulta. Você pode executar esse processo uma vez por dia para cada valor de type que tiver 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 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 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",
"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 de 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 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 cada valor de type conforme desejado em uma consulta separada.

Agrupados 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 uma janela de um dia selecionando a mesma data.
  • dimensions: opcionalmente, inclua country e/ou device.
  • type: como opção, enumerar cada valor de type como quiser 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 uma janela de um dia selecionando a mesma data.
  • dimensions: inclui opcionalmente qualquer combinação de query, country ou device.
  • type: enumera cada valor de type conforme desejado em uma consulta separada.

Agrupar resultados por página ou propriedade

Impressões, cliques, posição e 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 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

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

  1. Especifique searchAppearance como a única dimensão, que vai agrupar todos os dados por tipo de aspecto da pesquisa sem outras dimensões.
  2. Se preferir, 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, é necessário executar a segunda etapa uma vez para cada tipo 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 aspecto da pesquisa encontrados na etapa 1, além das dimensões que você preferir (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 dispositivo.

"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
  },
...