レポート

他のキャンペーン タイプと同様に、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 キャンペーンのパフォーマンスから必須フィールドを取得する方法は次のとおりです。

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 時間単位)

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

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