Os relatórios fornecem informações sobre todos os diferentes recursos na sua conta. Você pode buscar informações sobre campanhas, grupos de anúncios e as estatísticas deles, o histórico de alterações da sua conta e muito mais. A infraestrutura de relatórios é respaldada pela API Google Ads e usa o GAQL para especificar campos, métricas e condições que você quer definir.
Relatório x pesquisa
Existem dois mecanismos principais de denúncia. Ambas aceitam os mesmos tipos de consultas e diferem principalmente em como retornam os resultados.
Para os dois casos, usaremos a seguinte consulta:
SELECT
campaign.id,
campaign.status,
metrics.clicks,
metrics.impressions,
customer.id
FROM campaign
WHERE
metrics.impressions > 0
AdsApp.report()
- Isso retornará uma representação simples, 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"]
erow["metrics.impressions"]
, diretamente. Com esse formato, você pode exportar os resultados diretamente para uma planilha usando o métodoexportToSheet()
. Esse não é o formato nativo para o qual os resultados são retornados pela API Google Ads. Sendo assim, em alguns casos, alguns campos não estão disponíveis nesse formato. Se esse for o caso, usesearch
. AdsApp.search()
- Isso vai retornar uma lista de objetos
GoogleAdsRow
, que têm vários campos, cada um com subcampos. Portanto, você acessariarow.campaign.id
erow.metrics.impressions
para buscar os dados. Isso geralmente é mais útil se você planeja processar os dados de maneira programática, e alguns campos podem estar disponíveis apenas no formatosearch
se não puderem ser convertidos em uma representação simples.
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 de
AdsApp.report
para ver detalhes completos 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 todas as configurações possíveis.