En esta guía, se correlacionan los conceptos y las convenciones de nomenclatura de los informes en la IU de Google Ads con los informes que puedes generar con 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 consultas de Google Ads (GAQL).
| IU | GAQL |
|---|---|
| Columnas | Cualquier recurso, campo de segmentación 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 segmentación | 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 los campos de recursos, los campos de segmentos y las métricas en GAQL.
Filtros
Puedes filtrar y organizar los datos de tus informes.
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.
En GAQL, tienes el mismo control si filtras por segments.date en la cláusula WHERE de una consulta en 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, 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 segmentación 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 a partir de un conjunto definido de tamaños.
La paginación a través de los 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.
Ordenar 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 debes realizar un procesamiento posterior. Consulta este ejemplo de código que muestra 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.
Informes predefinidos
Puedes crear una lista de informes predefinidos en la IU de Google Ads.
A continuación, se incluye una lista de los informes básicos predefinidos y sus nombres de recursos de GAQL correspondientes.
| Informes básicos predefinidos | 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 |
| 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 el siguiente GAQL para generar el informe de 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"