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 qui ont généré des résultats. Pour récupérer l'état opérationnel et les détails d'éligibilité d'une campagne intelligente (par exemple, l'état "En cours d'examen", les motifs de 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 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 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 le coût 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 ensemble de données volumineux qui n'est pas spécifique au 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 les fonctionnalités de reporting

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

Pour les rapports en particulier, un certain nombre de champs de rapport doivent être mis à la disposition de l'utilisateur final. Voici comment récupérer les champs obligatoires à partir du numéro d'élément R.20 Performances de la campagne dans la FMR :

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 obligatoires de l'élément 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 d'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
  AND segments.date DURING LAST_30_DAYS