Relatórios

Assim como em outros tipos de campanha, você pode usar GoogleAdsService.SearchStream para recuperar atributos e métricas de desempenho das campanhas inteligentes.

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

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

A consulta abaixo recupera as impressões e cliques de cada termo de pesquisa a partir nos ú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 dez principais termos de pesquisa que geraram a mais impressões nos últimos 30 dias, junto com o custo.

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

Extrair atributos de uma KeywordThemeConstant

Como KeywordThemeConstants são recuperados de um grande conjunto de dados que não é são específicos do cliente, não é possível analisar keyword_theme_constant o recurso de uma só vez. Para recuperar KeywordThemeConstants individuais, você precisa consulte o recurso campaign_criterion para encontrar os nomes dos recursos dos temas de palavra-chave associados a suas campanhas e, 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 campaign_criterion.keyword_theme.keyword_theme_constant no 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 da funcionalidade de relatórios

Para implementar campanhas inteligentes, seu aplicativo precisa atender a um conjunto de funcionalidade mínima obrigatória (RMF, na sigla em inglês).

Para gerar relatórios especificamente, alguns campos de relatório devem ser definidos disponíveis para o usuário final. Veja como recuperar os campos obrigatórios do item o número 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 item de número R.70 Visualização do termo de pesquisa da campanha inteligente:

SELECT
  metrics.clicks,
  metrics.cost_micros
FROM smart_campaign_search_term_view

Métricas por loja

Esta é uma consulta que inclui todas as métricas disponíveis por loja. Esses Os campos também podem ser combinados com outros 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

Ligações segmentadas por hora

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

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