Se usó la API de Cloud Translation para traducir esta página.

Obtén tus datos de rendimiento

Puedes consultar tus datos de rendimiento con rapidez, y sin exceder tu cuota, ejecutando una consulta diaria del equivalente de datos de un día.

Debes elegir qué información quieres que aparezca en tus datos: los tipos de búsqueda (web, de imagen, de video, etc.) y qué dimensiones (página, búsqueda, país o dispositivo), además de si se deben agrupar los resultados por página o propiedad. Es posible que se pierdan algunos datos cuando se realice una búsqueda de una página o una cadena de consulta (estos son los motivos).

Descripción general

Recomendamos ejecutar una consulta cada día para los datos de un día mediante uno de los estilos de consulta que se describen a continuación. La ejecución de una consulta diaria por un día de datos no debería exceder tu cuota diaria. Por lo general, los datos están disponibles después de 2 o 3 días. Para saber cuáles son los datos disponibles más recientes, ejecuta una consulta simple agrupada por fecha durante los últimos 10 días. Escribe tu consulta:
- Elige si quieres agrupar los resultados por página o propiedad.
- Elige si quieres recuentos más completos o más dimensiones en tu consulta. Nota: Los datos de apariencia de búsqueda (AMP, vínculo azul, resultado enriquecido, etc.) se deben consultar mediante un proceso de dos pasos.
Desplázate por los resultados volviendo a ejecutar la misma consulta y aumenta el valor de startRow en 25,000 en la solicitud hasta que llegues a la última página (una respuesta con 0 filas).
De manera opcional, ejecuta la misma consulta con otro parámetro type.

Este es un ejemplo de un pseudocódigo para una sola consulta. Puedes ejecutarlo una vez al día para cada valor type del que quieras obtener datos.

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

Límites de datos

Además de la cuota de uso de la API, el método de las estadísticas de la Búsqueda expone un máximo de 50,000 filas de datos por día por tipo de búsqueda (web, imagen, etc., ordenadas por clics).

Detalles de la consulta

Puedes consultar datos agrupados por página o propiedad.

Agrupados por página

Para realizar recuentos precisos, debes omitir las dimensiones de la página y de la búsqueda de la siguiente manera:

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

startDate / endDate: Elige la misma fecha para la ventana de un día.
dimensions: De manera opcional, puedes incluir country o device.
type: Enumera cada valor type como desees en una consulta separada.
aggregationType: Debe ser byPage.

Para obtener más detalles, incluida la información de la página o de la búsqueda, a expensas de perder algunos datos, ejecuta una consulta como la siguiente:

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

startDate / endDate: Elige la misma fecha para la ventana de un día.
dimensions: Incluye page. De manera opcional, puedes incluir cualquier combinación de query, country o device.
type: Enumera cada valor type como desees en una consulta separada.

Agrupado por propiedad

Para realizar recuentos precisos, debes omitir las dimensiones de la página y de la búsqueda de la siguiente manera:

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

startDate / endDate: Elige la misma fecha para la ventana de un día.
dimensions: De manera opcional, puedes incluir country o device.
type: De manera opcional, enumera cada valor type como desees en una consulta independiente.

Para obtener más detalles, incluida la información de la búsqueda, el país o el dispositivo, a expensas de perder algunos datos, ejecuta una consulta como la siguiente:

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

startDate / endDate: Elige la misma fecha para la ventana de un día.
dimensions: De manera opcional, puedes incluir cualquier combinación de query, country o device.
type: Enumera cada valor type como desees en una consulta separada.

Agrupa resultados por página o propiedad

Las impresiones, los clics, la posición y la tasa de clics se calculan de manera diferente cuando se agrupan los resultados por página y no por propiedad. Más información.

¿Por qué pierdo datos cuando solicito más detalles?

Cuando agrupa por página o búsqueda, nuestro sistema puede quitar algunos datos para poder calcular los resultados en un tiempo razonable con una cantidad razonable de recursos de procesamiento.

Obtén datos de apariencia de búsqueda

La apariencia de búsqueda no está disponible como una columna junto con ninguna otra dimensión. Por lo tanto, si deseas ver información sobre la apariencia de búsqueda de tu sitio, debes seguir este proceso:

Especifica searchAppearance como la única dimensión, que agrupará todos los datos por tipo de apariencia de búsqueda sin otras dimensiones.
Si lo deseas, puedes ejecutar una segunda consulta. Para ello, filtra por uno de los tipos de apariencia de búsqueda que se indican en el paso 1 y agrega las dimensiones que desees (página, país, búsqueda, etcétera).

Para recuperar datos sobre varios tipos de apariencia de búsqueda, debes ejecutar el segundo paso una vez por cada tipo de apariencia de búsqueda que se indica en el paso 1.

Primera consulta:

Obtén una lista de los tipos de apariencia de búsqueda en tu sitio.

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

Resultados:

Tu sitio tiene el tipo INSTANT_APP, AMP_BLUE_LINK, etcétera.

 "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:

Filtra por uno de los tipos de apariencia de búsqueda que se incluyen en el paso 1, junto con las dimensiones que te gusten (página, dispositivo, etc.). Aquí 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:

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