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
- 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.
- 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). - 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 incluircountry
odevice
.type
: enumera en cada valortype
como desees en una consulta separada.aggregationType
: Debe serbyPage
.
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
: Incluyepage
. De manera opcional, puedes incluir cualquier combinación dequery
,country
odevice
.type
: enumera en cada valortype
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 incluircountry
odevice
.type
: De forma opcional, enumera en cada valortype
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 dequery
,country
odevice
.type
: enumera en cada valortype
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:
- Especifica
searchAppearance
como la única dimensión, que agrupará todos los datos por tipo de apariencia de búsqueda sin otras dimensiones. - 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 }, ...