Informes en la IU

En esta guía, se asignan los conceptos y las convenciones de nombres para los informes de la IU de Google Ads a los informes que puedes generar mediante el lenguaje de consultas 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 búsqueda de Google Ads (GAQL).

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

Columnas

Las columnas en la IU son equivalentes a Campos de recursos, Campos de segmentos y Métricas en GAQL.

Filtros

Intervalos de fechas

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

Filtros

Los filtros en 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, puede que te interese ver la cantidad específica de impresiones específicas de la Red de Búsqueda de Google y de la Red de Display de Google. En este caso, te recomendamos que segmentes tu informe por red. Consulta Segmentación para incluir campos de segmentos en la cláusula SELECT.

Paginación

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

Recuperar informes con GoogleAdsService.Search permite paginar los resultados mediante next_page_token de una manera similar a la IU.

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

Hacer pedido

En la IU, ordenas los resultados por una columna en particular seleccionando una columna. En GAQL, puedes usar las cláusulas ORDER BY y la cláusula LIMIT para modificar el resultado de tu consulta.

Formatos de descarga

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

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

Programe y envíe informes por correo electrónico

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

Informes predefinidos

Puede crear una lista de informes predefinidos en la IU de Google Ads. A continuación, se muestra una lista de informes predefinidos básicos y sus nombres de recursos de GAQL que coinciden.

Informes predefinidos básicos Nombre del recurso de GAQL
(especifica en la cláusula FROM)
Cuenta cliente
Campaña,
Detalles de la campaña
campaña
Grupo de anuncios,
Detalles del grupo de anuncios
grupo_anuncios
Anuncio,
URL final
anuncio_grupo_anuncios
Buscar palabra clave keyword_view
Términos de búsqueda search_term_view
Búsqueda de pago y búsqueda orgánica view_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 la GAQL anterior en la API, consulta uno de los siguientes ejemplos de informes:

Diferencias comunes

Cuando se comparan los informes de la IU con los informes 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.

Para replicar una vista de la IU predeterminada, debes agregar un filtro (por lo general, con un campo status) a fin de excluir las filas quitadas.

Por ejemplo, si recuperas campañas, puedes usar una consulta como la siguiente:

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