Relatórios

Os relatórios são um recurso eficiente que permite que você acesse o grande conjunto de relatórios da Google AdWords API. As consultas de relatório são especificadas usando a Linguagem de consulta do Google AdWords e os valores retornados são objetos JSON simples. Por exemplo,

var report = AdWordsApp.report(
    "SELECT AdGroupId, Query, Ctr, Cost, Impressions " +
    "FROM   SEARCH_QUERY_PERFORMANCE_REPORT " +
    "WHERE  Impressions < 10 " +
    "DURING LAST_30_DAYS");

var rows = report.rows();
while (rows.hasNext()) {
    var row = rows.next();
    var query = row["Query"];
    var impressions = row["Impressions"];
}

Os relatórios não suportam as condições ORDER BY ou LIMIT. Os resultados são exibidos sem uma ordem específica.

Leia a Referência para ver mais detalhes sobre a API. Para ver um exemplo de uso de relatórios nos scripts do Google AdWords, veja a solução de consulta de pesquisa.

As principais vantagens do uso de relatórios:

  • Acesso a diversas estatísticas não disponíveis a entidades comuns do Google AdWords (incluindo segmentos).
  • Capacidade de acessar uma grande quantidade de dados. No momento, os relatórios não estão sujeitos a quaisquer cotas, e é possível gerar um relatório com 1 milhão de linhas.
  • Desempenho: o download de um relatório pode levar um tempo, mas as iterações nas linhas do relatório são incrivelmente rápidas.

Versões da API

Conforme novas versões da Google AdWords API são lançadas e as antigas têm seu uso suspenso, determinados campos de relatórios ou até mesmo relatórios inteiros podem desaparecer. Isso pode, inadvertidamente, corromper seu código. Como um mecanismo de segurança, considere especificar a versão da API com a qual seu código espera trabalhar:

var report = AdWordsApp.report(query, {
    apiVersion: 'v201605'
});

Dessa forma, o código não será corrompido quando uma nova versão for lançada.

Uma desvantagem é que em algum momento v201605 terá seu uso suspenso e será desativado. Quando isso ocorrer, os scripts que faziam referência especificamente a essa versão ficarão corrompidos. Use apiVersion com cuidado.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.