Cómo obtener los datos de rendimiento

Puedes consultar tus datos de rendimiento con rapidez y sin exceder tu cuota. Para ello, ejecuta una consulta diaria de datos diarios.

Debe elegir la información que desea incluir en sus datos: qué tipos de búsqueda (web, imagen, video, etc.) y qué dimensiones (página, búsqueda, país o dispositivo) y si se agrupan los resultados por página o propiedad. Cuando se consulta por páginas o strings de consulta, es posible que se pierdan algunos datos (estos son los motivos).

Descripción general

  1. Recomendamos ejecutar una consulta cada día por el valor de un día de datos mediante uno de los estilos de consulta que se describen a continuación. Ejecutar una consulta diaria por un día de datos no debe exceder tu cuota diaria. Por lo general, los datos están disponibles después de 2 o 3 días. Para conocer los datos disponibles más recientemente, ejecute una consulta simple agrupada por fecha en los últimos 10 días. Cuando escribas tu consulta, haz lo siguiente:
    • Elige si quieres agrupar los resultados por página o propiedad.
    • Elija si desea obtener recuentos más completos o más dimensiones en su 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.
  2. Pagina los resultados mediante una nueva ejecución de la misma consulta, lo que aumenta el valor de startRow en 25,000 en la solicitud hasta llegar a la última página (una respuesta con 0 filas).
  3. De manera opcional, ejecuta la misma consulta con otro parámetro type.

Este es un ejemplo de pseudocódigo para una sola consulta. Puedes ejecutar esto una vez al día para cada valor type sobre el que quieras 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 Search Analytics expone un máximo de 50,000 filas de datos por 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.

Agrupado por página

Para realizar recuentos precisos, debes omitir la página y las dimensiones de búsqueda, como se muestra a continuación:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"
  • startDate / endDate: Selecciona un período para elegir un período de un día.
  • dimensions: De manera opcional, puedes incluir country o device.
  • type: enumera en 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 la consulta, a costa de la pérdida de 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: Selecciona un período para elegir un período de un día.
  • dimensions: Incluye page. De manera opcional, puedes incluir cualquier combinación de query, country o device.
  • type: enumera en cada valor type como desees en una consulta separada.

Agrupado por propiedad

Para realizar recuentos precisos, debes omitir la página y las dimensiones de búsqueda, como se muestra a continuación:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"
  • startDate/endDate: Selecciona un período para elegir un período de un día.
  • dimensions: De manera opcional, puedes incluir country o device.
  • type: De forma opcional, enumera en cada valor type como desees en una consulta diferente.

Para obtener más detalles, incluida la información de la consulta, el país o el dispositivo, a costa de la pérdida de algunos datos, ejecuta una consulta como la siguiente:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"
  • startDate/endDate: Selecciona un período para elegir un período de un día.
  • dimensions: De manera opcional, puedes incluir cualquier combinación de query, country o device.
  • type: enumera en cada valor type como desees en una consulta separada.

Agrupación de resultados por página o propiedad

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

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

Cuando agrupa por página o consulta, nuestro sistema puede descartar 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 cualquier otra dimensión. Por lo tanto, si quieres ver la información de apariencia de búsqueda de tu sitio, debes seguir este proceso:

  1. Especifica searchAppearance como la única dimensión, que agrupará todos los datos por tipo de apariencia de búsqueda sin otras dimensiones.
  2. Si lo desea, ejecute una segunda consulta mediante el filtrado según uno de los tipos de apariencia de búsqueda que se mencionan en el paso 1, y agregue las dimensiones que desee (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 tipo de apariencia de búsqueda 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:

Su sitio tiene el tipo 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 uno de los tipos de apariencia de búsqueda que se encuentran en el paso 1, junto con las dimensiones que desee (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 tipo 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
  },
...