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 a GAQL para especificar quais campos, métricas e condições você quer definir.

Relatório x pesquisa

Há dois mecanismos principais para denúncias. Ambos aceitam os mesmos tipos de consultas e diferem principalmente na forma como retornam os resultados.

Para os dois 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 simples, semelhante a um dicionário, dos seus resultados de pesquisa. É possível acessar campos como se estivesse usando um dicionário, como row["campaign.id"] e row["metrics.impressions"] diretamente. Ao usar esse formato, é possível 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. Se for esse o caso, use search.

AdsApp.search()

Isso vai retornar uma lista de objetos GoogleAdsRow, que têm vários campos, cada um deles podendo ter subcampos. Assim, 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, e alguns campos só podem estar disponíveis no formato search se não puderem ser convertidos em uma representação simples.

Observação: ao usar AdsApp.search, os campos retornados estarão em lowerCamelCase, mesmo que sejam especificados em underscore_case na consulta. Por exemplo, se o campo na consulta for campaign.start_date, use campaign.startDate para buscar o resultado da linha.

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

Confira a documentação do AdsApp.report para mais 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 de Adsapp.search para conferir todas as configurações possíveis.