Relatórios

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

As métricas de campanhas inteligentes estão disponíveis no recurso campaign, e as métricas específicas de 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. Para recuperar o status de funcionamento e os detalhes de qualificação de uma campanha inteligente (como status em revisão, motivos de não qualificação ou 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 recupera as impressões e os cliques de cada termo de pesquisa dos últimos 30 dias para todas as campanhas inteligentes, segmentados 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 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. Observe que 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

Recuperar atributos de um KeywordThemeConstant

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

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

Para implementar campanhas inteligentes, seu aplicativo precisa atender a um conjunto de recursos mínimos obrigatórios (RMF).

Para 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 item número 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'

Veja como recuperar os campos obrigatórios do item número R.70 Visualização do termo de pesquisa da campanha inteligente, junto com a campanha e o 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

Veja uma consulta que inclui todas as métricas por loja disponíveis 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

Veja como recuperar todas as métricas de ligações entre 12h e 17h (valores de segments.hour de 12 a 16, em que cada número inteiro representa uma janela de 1 hora que começa nesse 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