Relatórios

Os relatórios fornecem informações sobre todos os recursos diferentes na sua conta. Você pode buscar informações sobre campanhas, grupos de anúncios e as estatísticas deles, mudar o histórico da sua conta e muito mais. A infraestrutura de relatórios é apoiada pela API Google Ads e usa o GAQL para especificar quais campos, métricas e condições você quer definir.

Há dois mecanismos principais para fazer relatórios. Ambos aceitam os mesmos tipos de consultas e diferem principalmente na forma como retornam os resultados.

Para ambos os casos, vamos usar a seguinte consulta:

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0
AdsApp.report()
Isso vai retornar uma representação plana, semelhante a um dicionário, dos resultados da pesquisa. É possível acessar os campos como se estivesse usando um dicionário, como row["campaign.id"] e row["metrics.impressions"] diretamente. Com esse formato, você pode exportar os resultados diretamente para uma planilha usando o método exportToSheet(). Esse não é o formato nativo em que os resultados são retornados pela API Google Ads. Portanto, em alguns casos, alguns campos podem não estar disponíveis nesse formato. Nesse caso, use search.
AdsApp.search()
Isso vai retornar uma lista de objetos GoogleAdsRow, que têm vários campos, cada um dos quais pode ter subcampos. Então você acessaria row.campaign.id e row.metrics.impressions para buscar os dados. Isso geralmente é mais útil se você planeja processar os dados de forma programática. Alguns campos só estarão disponíveis no formato search se não puderem ser convertidos em uma representação plana.

Exemplo de relatório

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"];
}

Consulte a documentação AdsApp.report para conferir todos os detalhes sobre o uso dessa visualização.

Exemplo de pesquisa

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;
}

Consulte a documentação completa do Adsapp.search para conferir todas as configurações possíveis.