Informes en la IU

En esta guía, se asignan los conceptos y las convenciones de nomenclatura para los informes de la IU de Google Ads con los informes que puedes generar con el lenguaje de consulta de Google Ads (GAQL) y la API de Google Ads.

Términos comunes de la IU

En la siguiente tabla, se resumen algunos de los términos comunes que se usan en la IU y sus asignaciones con el lenguaje de consulta de Google Ads (GAQL).

IU GAQL
Columnas Cualquier recurso, campo de segmento o métrica en la cláusula SELECT de una consulta de GAQL.
Período Los períodos se asignan a una cláusula WHERE que filtra en segments.date.
Filtros Una o más condiciones en la cláusula WHERE.
Segmentar campos Para aplicar la segmentación, incluye campos de segmentos en tu consulta de GAQL.
Paginación Paging divide el conjunto de resultados de la búsqueda en varias páginas.

Columnas

Las columnas de la IU son equivalentes a los campos de recursos, los campos de segmento y las métricas en GAQL.

Filtros

Intervalos de fechas

La IU de Google Ads tiene una tabla que muestra las estadísticas de la cuenta y un menú desplegable para controlar el período de estas estadísticas. Tienes el mismo control en GAQL si filtras segments.date en la cláusula WHERE de una consulta de GAQL.

Filtros

Los filtros de la IU son equivalentes a una o más condiciones de la cláusula WHERE de GAQL.

Segmentación

Para obtener estadísticas más detalladas, puedes dividir los datos por segmentos. Por ejemplo, es posible que te interese ver la cantidad de impresiones específicas de la Red de Búsqueda de Google por separado de la Red de Display de Google. En este caso, te recomendamos segmentar el informe por red. Consulta Segmentación para obtener información sobre cómo incluir campos de segmento en la cláusula SELECT.

Paginación

Puedes navegar por tus informes en la IU con los controles disponibles en la parte inferior de cada tabla de datos, que te permiten cambiar de página y seleccionar la cantidad de resultados que se mostrarán de un conjunto definido de tamaños.

La recuperación de informes con GoogleAdsService.Search permite desplazarse por los resultados mediante next_page_token de un modo similar a la IU.

Sin embargo, también puedes usar GoogleAdsService.SearchStream para obtener conjuntos de resultados completos sin usar la paginación.

Pedidos

En la IU, puedes ordenar los resultados por una columna en particular mediante la selección de una columna. En GAQL, puedes usar la cláusula ORDER BY y la cláusula LIMIT para modificar el resultado de la consulta.

Descargar formatos

Los informes se pueden descargar en la interfaz de usuario en diversos formatos (csv, tsv, xml, etc.). La API no admite formatos ni resultados de archivos. Te recomendamos que extiendas cualquiera de los siguientes ejemplos de informes para tu caso de uso:

Este es un ejemplo en Ruby que muestra cómo puedes implementar el formato CSV en tu cliente:

Programar informes y enviarlos por correo electrónico

La IU puede programar y enviar por correo electrónico un informe, pero no es compatible con la API.

Informes predefinidos

Puedes crear una lista de informes predefinidos en la IU de Google Ads. A continuación, se muestra una lista de los informes predefinidos básicos y su nombre de recurso de GAQL correspondiente.

Informes predefinidos básicos Nombre del recurso de GAQL
(se especifica en la cláusula FROM)
Cuenta cliente
Campaña,
Detalles de la campaña		 campaign
Grupo de anuncios,
Detalles del grupo de anuncios		 ad_group
Anuncio,
URL final		 ad_group_ad
Palabra clave de la búsqueda keyword_view
Términos de búsqueda search_term_view
Búsqueda de pago y búsqueda orgánica paid_organic_search_term_view
Página de destino landing_page_view
Página de destino expandida expanded_landing_page_view

Como ejemplo de la tabla anterior, puedes usar el siguiente GAQL para generar el informe de la cuenta:

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

Para ejecutar el GAQL anterior en la API, consulta cualquiera de los siguientes ejemplos de informes:

Diferencias comunes

Cuando se comparan los informes de la IU con los de la API, una de las diferencias más comunes es que la IU filtra implícitamente las entidades quitadas, mientras que la API no.

A fin de replicar una vista predeterminada de la IU, debes agregar un filtro (por lo general, con un campo status) para excluir las filas que se quitaron.

Por ejemplo, si se recuperan campañas, podrías utilizar una consulta como la siguiente:

SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"