他のキャンペーン タイプと同様に、GoogleAdsService.SearchStream
を使ってスマート アシスト キャンペーンの属性とパフォーマンス指標を取得できます。
スマート アシスト キャンペーンの指標は campaign
リソースから、検索キーワード固有の指標は smart_campaign_search_term_view
リソースから利用できます。smart_campaign_search_term_view
の search_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