Comme pour les autres types de campagnes, vous pouvez utiliser
GoogleAdsService.SearchStream pour récupérer les attributs et les
métriques de performances des campagnes intelligentes.
Les métriques des campagnes intelligentes sont disponibles à partir de la campaign
ressource, et les métriques spécifiques aux termes de recherche sont disponibles à partir de la
smart_campaign_search_term_view ressource. Dans le
smart_campaign_search_term_view, le search_term champ
contient toutes les requêtes correspondantes qui ont généré des résultats. Pour récupérer l'
état opérationnel et les informations sur l'éligibilité d'une campagne intelligente (par exemple, l'
état "En cours d'examen", les motifs d'inéligibilité ou les codes temporels des impressions), utilisez
SmartCampaignSettingService.GetSmartCampaignStatus
, comme décrit dans État de la campagne.
Impressions et clics des campagnes intelligentes au cours des 30 derniers jours
La requête suivante récupère les impressions et les clics de chaque terme de recherche au cours des 30 derniers jours pour toutes les campagnes intelligentes, segmentés par date.
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 principaux termes de recherche par impressions
La requête suivante récupère les 10 principaux termes de recherche qui ont généré le plus d'impressions au cours des 30 derniers jours, ainsi que leur coût. Notez que segments.date est omis de la clause SELECT, de sorte que les impressions et le coût sont agrégés sur l'ensemble de la période de 30 jours par terme de recherche.
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
Récupérer les attributs d'un KeywordThemeConstant
Étant donné que KeywordThemeConstants sont récupérés à partir d'un grand ensemble de données qui n'est pas
spécifique à un client, il n'est pas possible d'analyser l'ensemble de la ressource
keyword_theme_constant en une seule fois. Pour
récupérer des KeywordThemeConstants individuels, vous devez interroger la
campaign_criterion ressource afin de trouver les noms de ressources
des thèmes de mots clés associés à vos campagnes, puis utiliser ces noms de ressources
pour interroger la keyword_theme_constant ressource.
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'
Utilisez ensuite le nom de ressource dans le champ campaign_criterion.keyword_theme.keyword_theme_constant de la requête suivante :
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'
Fonctionnalitéde reporting
Pour implémenter des campagnes intelligentes, votre application doit répondre à un ensemble de fonctionnalités minimales requises (RMF).
Pour le reporting en particulier, un certain nombre de champs de reporting doivent être mis à la disposition de l'utilisateur final. Voici comment récupérer les champs requis à partir de l'élément R.20 Performances de la campagne dans les fonctionnalités minimales requises :
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'
Voici comment récupérer les champs requis à partir de l'élément R.70 Vue des termes de recherche de la campagne intelligente, ainsi que la campagne et le terme de recherche associés :
SELECT
campaign.id,
campaign.name,
smart_campaign_search_term_view.search_term,
metrics.clicks,
metrics.cost_micros
FROM smart_campaign_search_term_view
Métriques par magasin
Voici une requête qui inclut toutes les métriques par magasin disponibles pour les campagnes intelligentes. Ces champs peuvent également être combinés avec d'autres champs dans une seule requête :
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'
Appels téléphoniques segmentés par heure
Voici comment récupérer toutes les métriques d'appels téléphoniques entre 12h00 et 17h00 (valeurs segments.hour comprises entre 12 et 16, où chaque entier représente une fenêtre d'une heure commençant à cette heure) :
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