Assim como em outros tipos de campanha, você pode usar GoogleAdsService.SearchStream
para recuperar atributos e métricas de performance das campanhas inteligentes.
As métricas de campanhas inteligentes estão disponíveis no recurso campaign
, e as métricas específicas de termo de pesquisa estão disponíveis no recurso smart_campaign_search_term_view
. Em smart_campaign_search_term_view
, o campo
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 impressões e cliques de cada termo de pesquisa 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 10 principais termos de pesquisa que geraram mais impressões nos últimos 30 dias, junto com o 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
Extrair atributos de uma KeywordThemeConstant
Como 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 o KeywordThemeConstants
individual, consulte o recurso campaign_criterion
para encontrar os nomes dos recursos dos temas de palavra-chave associados às suas campanhas e use-os 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 da funcionalidade de relatórios
Para implementar campanhas inteligentes, seu aplicativo precisa atender a um conjunto de funcionalidades mínimas obrigatórias (RMF, na sigla em inglês).
Para gerar relatórios específicos, alguns campos precisam ser disponibilizados ao usuário final. Veja como recuperar os campos obrigatórios do item de número Performance da campanha R.20 no RMF:
SELECT
metrics.clicks,
metrics.cost_micros,
metrics.impressions,
metrics.conversions,
metrics.all_conversions
FROM campaign
Confira como recuperar os campos obrigatórios do item de número R.70 Smart Campaign Search Term View:
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 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