Informes en la IU de Google Ads

La IU de Google Ads proporciona capacidades de informes. Para crear un informe, accede a tu cuenta de Google Ads, haz clic en Campañas en el menú de navegación de la izquierda y, luego, en Estadísticas e informes. Para crear un informe desde cero, haz clic en Editor de informes.

En esta guía, se asignan conceptos y convenciones de nomenclatura de informes comunes en la IU de Google Ads a los informes que puedes generar con el lenguaje de consultas de Google Ads (GAQL) y la API de Google Ads. También puedes seguir las indicaciones de la IU para crear el informe que mejor se adapte a tus requisitos.

Herramientas y recursos

Para obtener ejemplos más detallados y ayuda automatizada para asignar pantallas de la IU a la API, consulta los siguientes recursos:

• Recetario de consultas: Es una colección de consultas de GAQL que replican los datos que se encuentran en muchas pantallas comunes de la IU de Google Ads.
• Extensión de informes de la API de Google Ads: Es una extensión de Chrome que te ayuda a identificar los nombres de los campos y recursos de la API directamente en la IU 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 consultas de Google Ads (GAQL).

IU	GAQL
Columnas	Cualquier recurso, campo de segmento o métrica en la SELECT cláusula de una consulta de GAQL.
Período	Los períodos se asignan a una WHERE cláusula que filtra segments.date.
Filtros	Una o más condiciones en la WHERE cláusula.
Campos de segmento	Aplica la segmentación incluyendo 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 usar una cláusula SELECT para los campos de recursos, los campos de segmento o las métricas en GAQL.

Para obtener más información, consulta Acerca de las columnas de tu tabla de estadísticas.

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 intervalo de fechas de estas estadísticas.

Tienes el mismo control en GAQL filtrando en 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 WHERE cláusula de GAQL.

Para obtener más información, consulta Filtra tu vista de los datos de rendimiento.

Segmentación

Para obtener estadísticas más detalladas, divide los datos por segmentos. Por ejemplo, supongamos que deseas 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 ese caso, segmenta tu informe por red. Consulta Segmentación para obtener información sobre cómo incluir campos de segmento en la cláusula SELECT.

Paginación

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

Para paginar los resultados cuando recuperes informes, usa GoogleAdsService.Search con next_page_token. Para recuperar todo el conjunto de resultados sin paginación, usa GoogleAdsService.SearchStream.

Ordenar resultados

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

En GAQL, puedes usar la ORDER BY cláusula y LIMIT cláusula para ordenar y limitar los resultados 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 da formato directamente a los resultados en archivos como CSV, por lo que tu aplicación cliente debe dar formato a la respuesta. Consulta el ejemplo de código Informe de campañas a CSV para obtener información sobre cómo implementar el formato CSV en un cliente.

Programar y enviar informes por correo electrónico

Puedes programar y enviar un informe por correo electrónico desde la IU, pero estas funciones no son compatibles con la API.

Asigna vistas de la IU a recursos de la API

Esta es una lista de las vistas comunes de la IU y sus nombres de recursos de GAQL correspondientes.

Vistas de la IU	Nombre del recurso de GAQL (especificar 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 pagada y orgánica (plantilla de visibilidad competitiva)^*	paid_organic_search_term_view
Página de destino	landing_page_view
Página de destino expandida	expanded_landing_page_view
Contenido > Posiciones	managed_placement_view
Contenido > Posiciones donde se mostraron los anuncios	group_placement_view
Contenido > Posiciones donde se mostraron los anuncios > Ver detalles	detail_placement_view
Públicos > Datos demográficos > Edad	age_range_view
Públicos > Datos demográficos > Género	gender_view
Ubicaciones	location_view
Contenido > Temas	topic_view
Ubicaciones > Informe geográfico	geographic_view

^* Para generar el informe de búsqueda pagada y orgánica, debes vincular una cuenta de Google Search Console a tu cuenta de Google Ads a nivel del cliente.

Como ejemplo de la tabla anterior, puedes usar la siguiente consulta de GAQL para generar un informe de cuenta agregado de los últimos 7 días (agrega segments.date a la cláusula SELECT si deseas que las métricas se desglosen por día):

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

Para replicar una vista predeterminada de la IU, agrega un filtro con un campo status para excluir las filas quitadas (o incluye explícitamente las entidades ENABLED y PAUSED). Por ejemplo:

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