Obtén tus datos de rendimiento

Puedes consultar tus datos de rendimiento rápidamente, sin exceder tu cuota, ejecuta una consulta diaria para los datos de un día.

Debes elegir qué información quieres incluir en tus datos: qué tipos de búsqueda (web, imagen, video, etcétera). y qué dimensiones (página, búsqueda, país o dispositivo), así como si deseas 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

Te recomendamos que ejecutes una consulta cada día para obtener los datos de un día con uno de los estilos de consulta que se describen a continuación. Ejecutar una consulta diaria para un día de datos no debe exceder tu cuota diaria. Por lo general, los datos están disponibles después de 2 a 3 días. Si deseas conocer cuáles son los datos disponibles más recientes, ejecuta una consulta simple agrupada por fecha de los últimos 10 días. Escribe tu consulta:
- Elige si quieres agrupar los resultados por página o propiedad.
- Elige si deseas obtener 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.
Pagina 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 ejecutar esta función una vez al día para cada valor de type del que deseas 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 Search Analytics expone un máximo de 50,000 filas de datos al día por tipo de búsqueda (web, imagen, etc., ordenados por clics).

Detalles de la consulta

Puedes consultar datos agrupados por página o propiedad.

Agrupados por página

Para obtener recuentos precisos, debes omitir las dimensiones de página y de consulta, de la siguiente manera:

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

startDate / endDate: Elige un período de un día seleccionando la misma fecha.
dimensions: De manera opcional, incluye country o device.
type: Enumera sobre cada valor de type como desees en una consulta independiente.
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 un período de un día seleccionando la misma fecha.
dimensions: Incluye page. De manera opcional, puedes incluir cualquier combinación de query, country o device.
type: Enumera sobre cada valor de type como desees en una consulta independiente.

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, incluye country o device.
type: De manera opcional, enumera cada valor de 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 costa de perder algunos datos, ejecuta una consulta como esta:

"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, incluye cualquier combinación de query, country o device.
type: Enumera cada valor de type como desees en una consulta independiente.

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. Obtén más información.

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

Si 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.

Cómo obtener 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.
De manera opcional, ejecuta una segunda consulta, filtrando por uno de los tipos de apariencia de la búsqueda que se enumeran 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 encuentran en el paso 1, junto con las dimensiones que quieras (página, dispositivo, etcétera). 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"
        }
      ]
    }
  ]
}