Informes

Los informes proporcionan información acerca de todos los diferentes recursos de su cuenta. Puedes recuperar información sobre campañas, grupos de anuncios y sus estadísticas, cambiar el historial de tu cuenta y mucho más. La infraestructura de informes cuenta con el respaldo la API de Google Ads y usa GAQL para especificar qué campos, métricas y condiciones quieres establecer.

Informe vs. búsqueda

Existen dos mecanismos principales para la creación de informes. Ambos aceptan el mismo tipo de y se diferencian principalmente en cómo muestran 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 de la búsqueda con un estilo de diccionario. resultados. Puedes acceder a los campos como si estuvieras usando un diccionario, como row["campaign.id"] y row["metrics.impressions"] directamente. Mediante formato, puedes exportar los resultados directamente a una hoja de cálculo con el exportToSheet(). Este no es el formato nativo en el que se obtienen devueltos por la API de Google Ads, 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 en su lugar.

AdsApp.search()

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

Nota: Cuando uses AdsApp.search, los campos que se muestren estarán en lowerCamelCase, aunque se especifican en underscore_case en el para cada búsqueda. Por ejemplo, si tu 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 AdsApp.report para obtener detalles completos sobre cómo usar 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 toda la Adsapp.search documentación para todos los parámetros de configuración posibles.