Relatórios

Assim como em outros tipos de campanha, é possível usar GoogleAdsService.SearchStream para recuperar atributos e métricas de performance das campanhas inteligentes.

As métricas das campanhas inteligentes estão disponíveis no recurso campaign, e as métricas específicas dos termos de pesquisa estão disponíveis no recurso smart_campaign_search_term_view. No smart_campaign_search_term_view, o campo search_term contém todas as consultas correspondentes que geraram resultados.

Impressões e cliques de campanhas inteligentes nos últimos 30 dias

A consulta abaixo recupera impressões e cliques de cada termo de pesquisa dos últimos 30 dias para todas as campanhas inteligentes, segmentadas por data.

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.impressions,
  metrics.clicks,
  smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
WHERE segments.date DURING LAST_30_DAYS

10 principais termos de pesquisa por impressões

A consulta abaixo recupera os 10 principais termos de pesquisa que geraram o maior número de impressões nos últimos 30 dias, além do custo deles.

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.impressions,
  metrics.cost_micros,
  smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
ORDER BY metrics.impressions DESC
LIMIT 10

Recuperar atributos de um KeywordThemeConstant

Como KeywordThemeConstants são recuperados de um grande conjunto de dados não específico ao cliente, não é possível verificar todo o recurso keyword_theme_constant de uma só vez. Para recuperar KeywordThemeConstants individual, você precisa consultar o recurso campaign_criterion para encontrar os nomes dos recursos dos temas de palavra-chave associados às suas campanhas. Em seguida, use esses nomes de recursos para filtrar o recurso keyword_theme.

SELECT
  campaign_criterion.type,
  campaign_criterion.status,
  campaign_criterion.criterion_id,
  campaign_criterion.keyword_theme.keyword_theme_constant
FROM campaign_criterion
WHERE campaign_criterion.type = KEYWORD_THEME

Agora, use o nome do recurso no campo campaign_criterion.keyword_theme.keyword_theme_constant na seguinte consulta:

SELECT
  keyword_theme_constant.resource_name,
  keyword_theme_constant.display_name,
  keyword_theme_constant.country_code
FROM keyword_theme_constant
WHERE keyword_theme_constant.resource_name = 'keywordThemeConstants/40804~0'

Requisitos de funcionalidade dos relatórios

Para implementar campanhas inteligentes, seu aplicativo precisa satisfazer um conjunto de funcionalidades mínimas necessárias (RMF).

Para gerar relatórios especificamente, vários campos de relatórios precisam ser disponibilizados para o usuário final. Veja como recuperar os campos obrigatórios do número de item Desempenho da campanha R.20 no RMF:

SELECT
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM campaign

Veja como recuperar os campos obrigatórios do número de item R.70 Smart Campaign Search Term View:

SELECT
  metrics.clicks,
  metrics.cost_micros
FROM smart_campaign_search_term_view

Métricas por loja

Veja a seguir uma consulta que inclui todas as métricas por loja disponíveis. Esses campos também podem ser combinados com outros campos em uma única consulta:

SELECT
  metrics.all_conversions_from_click_to_call,
  metrics.all_conversions_from_directions,
  metrics.all_conversions_from_menu,
  metrics.all_conversions_from_order,
  metrics.all_conversions_from_other_engagement,
  metrics.all_conversions_from_store_visit,
  metrics.all_conversions_from_store_website
FROM campaign

Chamadas segmentadas por hora

Veja como recuperar todas as métricas de chamada telefônica entre 12h e 17h:

SELECT
  segments.hour,
  metrics.phone_calls
FROM campaign
WHERE segments.hour BETWEEN 12 and 17