Informes en la IU

En esta guía, se asignan los conceptos y las convenciones de nombres de los informes de la IU de Google Ads a 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 al 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
Campos de segmentos	Para aplicar la segmentación, incluye campos de segmento en tu consulta de GAQL.
Paginación	La paginación divide el conjunto de resultados de la consulta en varias páginas.

Columnas

Las columnas de la IU equivalen a los campos de recursos, los campos de segmentos 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 por segments.date en la cláusula WHERE de una consulta de GAQL.

Filtros

Los filtros de la IU equivalen a una o más condiciones en 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, segmentarías tu informe por red. Consulta Segmentación para saber cómo incluir campos de segmentos 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 a partir de un conjunto definido de tamaños.

La paginación de resultados está disponible cuando se recuperan informes con GoogleAdsService.Search a través de next_page_token. Para recuperar todo el conjunto de resultados sin paginación, usa GoogleAdsService.SearchStream.

Ordena los resultados

En la IU, puedes ordenar los resultados seleccionando una columna.

En GAQL, puedes usar la cláusula ORDER BY y la cláusula LIMIT para ordenar el resultado de tu consulta.

Formatos de descarga

En la IU, los informes se pueden descargar en varios formatos, como CSV, TSV o XML.

La API no admite directamente diferentes formatos en su salida, por lo que deberás realizar un procesamiento posterior. Consulta un ejemplo de código que muestra cómo implementar el formato CSV en un cliente.

Programa y envía informes por correo electrónico

La programación y el envío por correo electrónico de un informe están disponibles en la IU, pero no son compatibles con la API.

Informes predefinidos

Puedes crear una lista de informes predefinidos en la IU de Google Ads.

Esta es una lista de los informes básicos predefinidos y sus nombres de recursos de GAQL coincidentes.

Informes predefinidos básicos	Nombre del recurso de GAQL (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
Pagados y orgánicos	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 la 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

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 de forma implícita las entidades quitadas, mientras que la API no lo hace.

Para replicar una vista de IU predeterminada, debes agregar un filtro, por lo general, con un campo status, para excluir las filas quitadas, por ejemplo:

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