他のキャンペーン タイプと同様に、GoogleAdsService.SearchStream を使用して、スマート アシスト キャンペーンの属性とパフォーマンス指標を取得できます。
スマート アシスト キャンペーンの指標は campaign リソースから取得でき、検索語句固有の指標は smart_campaign_search_term_view リソースから取得できます。smart_campaign_search_term_view の search_term フィールドには、結果を生成した一致するクエリが含まれます。スマート アシスト キャンペーンの運用ステータスと適格性の詳細(審査中のステータス、不適格の理由、インプレッションのタイムスタンプなど)を取得するには、キャンペーン ステータスで説明されているように、SmartCampaignSettingService.GetSmartCampaignStatus を使用します。
過去 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 個の検索キーワードと、その費用を取得します。segments.date は SELECT 句から省略されているため、インプレッション数と費用は、検索語句ごとに 30 日間の期間全体で集計されます。
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
KeywordThemeConstant の属性を取得する
KeywordThemeConstants は、お客様固有ではない大規模なデータセットから取得されるため、keyword_theme_constant リソース全体を一度にスキャンすることはできません。個々の KeywordThemeConstants を取得するには、campaign_criterion リソースをクエリして、キャンペーンに関連付けられているキーワード テーマのリソース名を見つけ、そのリソース名を使用して 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'
次に、次のクエリの 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
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'
項目番号 R.70 スマート キャンペーンの検索語句ビューから、関連付けられているキャンペーンと検索語句とともに、必須フィールドを取得する方法は次のとおりです。
SELECT
campaign.id,
campaign.name,
smart_campaign_search_term_view.search_term,
metrics.clicks,
metrics.cost_micros
FROM smart_campaign_search_term_view
店舗ごとの指標
スマート アシスト キャンペーンで利用可能な店舗ごとの指標をすべて含むクエリを次に示します。これらのフィールドは、単一のクエリで他のフィールドと組み合わせることもできます。
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'
1 時間ごとに分割された通話
午後 12 時から午後 5 時までのすべての通話指標を取得する方法は次のとおりです(segments.hour 値 12 から 16。各整数は、その時間から始まる 1 時間のウィンドウを表します)。
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