Relatórios

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

As métricas das campanhas inteligentes estão disponíveis no campaign recurso, e as métricas específicas de termos de pesquisa estão disponíveis no smart_campaign_search_term_view recurso. No smart_campaign_search_term_view, o search_term campo contém todas as consultas correspondentes que geraram resultados. Para extrair o status de funcionamento e os detalhes de qualificação de uma campanha inteligente (como o status em análise, os motivos de não qualificação ou os carimbos de data/hora de impressão), use SmartCampaignSettingService.GetSmartCampaignStatus conforme descrito em Status da campanha.

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

A consulta a seguir extrai 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

Os 10 principais termos de pesquisa por impressões

A consulta a seguir extrai os 10 principais termos de pesquisa que geraram mais impressões nos últimos 30 dias, além do custo. O segments.date é omitido da cláusula SELECT para que as impressões e o custo sejam agregados em todo o período de 30 dias por termo de pesquisa.

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

Extrair atributos de um KeywordThemeConstant

Como os KeywordThemeConstants são extraídos de um conjunto de dados grande que não é específico do cliente, não é possível verificar todo o recurso keyword_theme_constant de uma só vez. Para extrair KeywordThemeConstants, consulte o campaign_criterion recurso para encontrar os nomes de recursos dos temas de palavras-chave associados às suas campanhas e use esses nomes para consultar o keyword_theme_constant recurso.

SELECT
  campaign.id,
  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'

Em seguida, use o nome do recurso no campo campaign_criterion.keyword_theme.keyword_theme_constant na consulta a seguir:

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 de relatórios

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

Para relatórios especificamente, vários campos de relatórios precisam ser disponibilizados ao usuário final. Saiba como extrair os campos obrigatórios do item R.20 Performance da campanha no RMF:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'

Saiba como extrair os campos obrigatórios do item R.70 Visualização de termos de pesquisa de campanhas inteligentes, além da campanha e do termo de pesquisa associados:

SELECT
  campaign.id,
  campaign.name,
  smart_campaign_search_term_view.search_term,
  metrics.clicks,
  metrics.cost_micros
FROM smart_campaign_search_term_view

Métricas por loja

Confira uma consulta que inclui todas as métricas disponíveis por loja para campanhas inteligentes. Esses campos também podem ser combinados com outros em uma única consulta:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  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
WHERE campaign.advertising_channel_type = 'SMART'

Ligações telefônicas segmentadas por hora

Saiba como extrair todas as métricas de ligações telefônicas entre 12h e 17h (valores segments.hour de 12 a 16, em que cada número inteiro representa uma janela de uma hora a partir desse horário):

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  segments.hour,
  metrics.phone_calls
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'
  AND segments.hour BETWEEN 12 AND 16
  AND segments.date DURING LAST_30_DAYS