Rapporti

Come per gli altri tipi di campagne, puoi utilizzare GoogleAdsService.SearchStream per recuperare gli attributi e le metriche di rendimento per le campagne intelligenti.

Le metriche delle campagne intelligenti sono disponibili nella risorsa campaign, mentre quelle specifiche per i termini di ricerca sono disponibili nella risorsa smart_campaign_search_term_view. Nel smart_campaign_search_term_view, il campo search_term contiene tutte le query corrispondenti che hanno generato risultati. Per recuperare lo stato operativo e i dettagli di idoneità di una campagna intelligente (ad esempio lo stato in revisione, i motivi di non idoneità o i timestamp delle impressioni), utilizza SmartCampaignSettingService.GetSmartCampaignStatus come descritto in Stato della campagna.

Impressioni e clic delle campagne intelligenti negli ultimi 30 giorni

La seguente query recupera le impressioni e i clic per ogni termine di ricerca degli ultimi 30 giorni per tutte le campagne intelligenti, segmentati per 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

I 10 termini di ricerca principali per impressioni

La seguente query recupera i 10 termini di ricerca principali che hanno generato il maggior numero di impressioni negli ultimi 30 giorni, insieme al relativo costo. Tieni presente che segments.date viene omesso dalla clausola SELECT in modo che le impressioni e il costo vengano aggregati nell'intero intervallo di date di 30 giorni per termine di ricerca.

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

Recupera gli attributi di una KeywordThemeConstant

Poiché i KeywordThemeConstants vengono recuperati da un ampio set di dati non specifico per i clienti, non è possibile scansionare l'intera risorsa keyword_theme_constant contemporaneamente. Per recuperare singoli KeywordThemeConstants, devi eseguire una query sulla risorsa campaign_criterion per trovare i nomi risorsa dei temi delle parole chiave associati alle tue campagne, quindi utilizzare questi nomi risorsa per eseguire una query sulla risorsa 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'

Quindi utilizza il nome della risorsa nel campo campaign_criterion.keyword_theme.keyword_theme_constant nella seguente query:

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'

Requisiti delle funzionalità di generazione dei report

Per implementare le campagne intelligenti, la tua applicazione deve soddisfare un insieme di funzionalità minime richieste (RMF).

Per i report in particolare, è necessario rendere disponibili all'utente finale una serie di campi dei report. Ecco come recuperare i campi obbligatori dal numero articolo R.20 Campaign Performance nel 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'

Ecco come recuperare i campi obbligatori dal numero di elemento R.70 Visualizzazione dei termini di ricerca delle campagne smart, insieme alla campagna e al termine di ricerca associati:

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

Metriche per negozio

Ecco una query che include tutte le metriche per negozio disponibili per le campagne intelligenti. Questi campi possono anche essere combinati con altri campi in una singola query:

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'

Chiamate telefoniche segmentate per ora

Ecco come recuperare tutte le metriche delle chiamate tra le 12:00 e le 17:00 (valori segments.hour da 12 a 16, dove ogni numero intero rappresenta un intervallo di 1 ora a partire da quell'ora):

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