Reporting

他のキャンペーン タイプと同様に、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 Smart Campaign Search Term View」から必須項目を取得する方法は次のとおりです。

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

通話を時間で分割表示

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

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