En esta guía, se describen los conceptos y las convenciones de nombres para 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 usados 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 cláusula SELECT de una consulta de GAQL |
| Período | Los períodos se asignan a un operador WHERE
filtrando por segments.date. |
| Filtros | Una o más condiciones en la cláusula WHERE. |
| Campos del segmento | Aplique la segmentación incluyendo campos de segmento. en tu consulta de GAQL. |
| Paginación | Paging desglosa el conjunto de resultados de la consulta en varias páginas. |
Columnas
Las columnas en la IU son equivalentes a Recurso campos, Segmentar y 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 un GAQL
para cada búsqueda.
Filtros
Los filtros en la IU son equivalentes 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 le interese ver la cantidad de impresiones específicas de la La Red de Búsqueda de Google es independiente de la Red de Display de Google. En este caso, debes segmentar el informe por red. Consulta Segmentación sobre cómo incluir campos de segmentos en la cláusula SELECT.
Paginación
Puedes navegar por tus informes en la IU usando los controles disponibles en parte inferior de cada tabla de datos que te permite cambiar de página y seleccionar el número de para mostrar resultados de un conjunto definido de tamaños.
La paginación a través de los resultados está disponible cuando se recuperan informes con
De GoogleAdsService.Search a
next_page_token Recuperar todo el conjunto de resultados
sin paginación, usa
GoogleAdsService.SearchStream
Resultados del pedido
En la IU, puedes ordenar los resultados seleccionando una columna.
En GAQL, puedes usar el operador ORDER BY cláusula y LIMIT cláusula para ordenar el resultado de tu consulta.
Descargar formatos
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 resultado, por lo que necesita realizar algún 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 de un informe por correo electrónico están disponibles en la IU, pero no se admiten en la API.
Informes predefinidos
Puedes crear una lista de informes predefinidos en la IU de Google Ads.
Esta es una lista de los informes predefinidos básicos y sus recursos de GAQL correspondientes Nombre
| Informes básicos predefinidos | Nombre del recurso de GAQL (se 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 |
| Búsqueda de pago y búsqueda orgánica | 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 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 filtrará implícitamente las entidades quitadas, mientras que la API no.
Para replicar una vista predeterminada de la IU, debes agregar un filtro, en general,
Mediante un campo status, para excluir las filas que se quitaron, por ejemplo:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"