Informes

Los informes proporcionan información sobre todos los diferentes recursos de tu cuenta. Puedes obtener información sobre campañas, grupos de anuncios y sus estadísticas, el historial de cambios de tu cuenta y mucho más. La infraestructura de informes está respaldada por la API de Google Ads y usa GAQL para especificar los campos, las métricas y las condiciones que deseas establecer.

Comparación entre el informe y la búsqueda

Existen dos mecanismos principales para realizar denuncias. Ambas aceptan los mismos tipos de consultas y difieren principalmente en la forma en que muestran los resultados.

Para ambos casos, usaremos la siguiente consulta:

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0

AdsApp.report()

Se mostrará una representación plana y similar a un diccionario de los resultados de la búsqueda. Puedes acceder a los campos como si usaras un diccionario, como row["campaign.id"] y row["metrics.impressions"] directamente. Con este formato, puedes exportar los resultados directamente a una hoja de cálculo con el método exportToSheet(). Este no es el formato nativo con el que la API de Google Ads muestra los resultados, por lo que, en algunos casos, es posible que algunos campos no estén disponibles en este formato. Si ese es el caso, debes usar search.

AdsApp.search()

Se mostrará una lista de objetos GoogleAdsRow que tienen varios campos, cada uno de los cuales puede tener subcampos. Por lo tanto, tendrás que acceder a row.campaign.id y a row.metrics.impressions para recuperar los datos. Por lo general, esto es más útil si planeas procesar los datos de manera programática y es posible que algunos campos solo estén disponibles en el formato search si no se pueden convertir en una representación plana.

Nota: Cuando se usa AdsApp.search, los campos que se muestran estarán en lowerCamelCase, aunque se especifiquen en underscore_case en la consulta. Por ejemplo, si el campo en la consulta es campaign.start_date, entonces, para recuperar el resultado de la fila, debes usar campaign.startDate.

Ejemplo de informe

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

Consulta la documentación de AdsApp.report para obtener todos los detalles sobre el uso de esta vista.

Ejemplo de búsqueda

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

Consulta la documentación completa de Adsapp.search para obtener todos los parámetros de configuración posibles.