La IU de Google Ads proporciona funciones de generación 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 Informes y estadísticas. Para crear un informe desde cero, haz clic en Editor de informes.
En esta guía, se asignan conceptos de informes y convenciones de nombres comunes en la IU de Google Ads a los informes que puedes generar con el lenguaje de búsqueda de Google Ads (GAQL) y la API de Google Ads. También puedes seguir las instrucciones 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 IU a la API, consulta los siguientes recursos:
- Guía 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 recursos y los campos 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 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 por segments.date. |
| Filtros | Una o más condiciones en la cláusula WHERE. |
| 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 segmentos 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 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 de la
cláusula WHERE de GAQL.
Para obtener más información, consulta Cómo filtrar la 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 desplazarte por los resultados cuando recuperas 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 cláusula ORDER BY y la cláusula LIMIT 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 formatea directamente el resultado en archivos como CSV, por lo que tu aplicación cliente debe formatear la respuesta. Consulta la muestra de código para generar un informe de campaña en formato CSV para aprender a implementar el formato CSV en un cliente.
Programa y envía 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
A continuación, se muestra una lista de las vistas comunes de la IU y sus nombres de recursos de GAQL correspondientes.
| Vistas de IU | Nombre del recurso de GAQL (especifícalo 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 (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úsquedas pagadas y orgánicas, 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 de forma implícita las entidades quitadas, mientras que la API no lo hace.
Para replicar una vista de IU predeterminada, agrega un filtro con un campo status para excluir
las filas quitadas (o incluir de forma explícita las entidades ENABLED y PAUSED). Por ejemplo:
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'