レポート

他のキャンペーン タイプと同様に、GoogleAdsService.SearchStream を使用して、スマート アシスト キャンペーンの属性とパフォーマンス指標を取得できます。

スマート アシスト キャンペーンの指標は campaign リソースから取得でき、検索語句固有の指標は smart_campaign_search_term_view リソースから取得できます。smart_campaign_search_term_viewsearch_term フィールドには、結果を生成した一致するクエリが含まれます。

スマート アシスト キャンペーンの過去 30 日間のインプレッション数とクリック数

次のクエリでは、すべてのスマート キャンペーンについて過去 30 日間の検索語句ごとのインプレッション数とクリック数が日付別に分類されて取得されます。

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 個の検索語句

次のクエリは、過去 30 日間に最も多くのインプレッションを生み出した上位 10 個の検索キーワードと、それらの費用を取得します。

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

KeywordThemeConstant の属性を取得する

KeywordThemeConstants は顧客固有ではない大規模なデータセットから取得されるため、keyword_theme_constant リソース全体を一度にスキャンすることはできません。個々の KeywordThemeConstants を取得するには、campaign_criterion リソースをクエリして、キャンペーンに関連付けられているキーワード テーマのリソース名を見つけ、それらのリソース名を使用して 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

次のクエリの campaign_criterion.keyword_theme.keyword_theme_constant フィールドでリソース名を使用します。

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'

レポート機能の要件

スマート アシスト キャンペーンを実装するには、アプリが必須の最小機能(RMF)のセットを満たしている必要があります。

レポート作成については、エンドユーザーが利用できるレポート フィールドがいくつか必要です。RMF の項目番号 R.20 Campaign Performance から必須項目を取得する方法は次のとおりです。

SELECT
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM campaign

項目番号 R.70 スマート キャンペーン検索語句ビューから必須フィールドを取得する方法は次のとおりです。

SELECT
  metrics.clicks,
  metrics.cost_micros
FROM smart_campaign_search_term_view

店舗ごとの指標

使用可能な店舗ごとの指標をすべて含むクエリを次に示します。これらのフィールドは、1 つのクエリで他のフィールドと組み合わせることもできます。

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

1 時間ごとに分割された通話

午後 12 時から午後 5 時までのすべての通話指標を取得する方法は次のとおりです。

SELECT
  segments.hour,
  metrics.phone_calls
FROM campaign
WHERE segments.hour BETWEEN 12 and 17