Rapports

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 ressource campaign, et les métriques spécifiques aux termes de recherche sont disponibles à partir de la ressource smart_campaign_search_term_view. Dans smart_campaign_search_term_view, le champ search_term contient toutes les requêtes correspondantes ayant généré des résultats. Pour récupérer l'état opérationnel et les informations sur l'éligibilité d'une campagne intelligente (comme l'état "En cours d'examen", les raisons de la non-é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 pour 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

Top 10 des termes de recherche par impressions

La requête suivante récupère les 10 premiers termes de recherche ayant 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 afin que les impressions et les coûts soient 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 les 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'intégralité de la ressource keyword_theme_constant en une seule fois. Pour récupérer des KeywordThemeConstants individuels, vous devez interroger la ressource campaign_criterion 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 ressource 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'

Utilisez ensuite le nom de la 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'

Exigences concernant la fonctionnalité de reporting

Pour implémenter des campagnes intelligentes, votre application doit satisfaire un ensemble de fonctionnalités minimales requises (FMR).

Pour les rapports, un certain nombre de champs doivent être mis à la disposition de l'utilisateur final. Voici comment récupérer les champs requis à partir du numéro d'article R.20 Performances des campagnes dans le 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'

Voici comment récupérer les champs requis à partir de l'élément numéro R.70 Vue des termes de recherche des campagnes intelligentes, 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 même 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 sur les appels téléphoniques entre 12h00 et 17h00 (valeurs segments.hour de 12 à 16, où chaque entier représente une période 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