Google Ads API には、広告が表示された場所とパフォーマンスを分析するためのビューがいくつか用意されています。managed_placement_view、group_placement_view、detail_placement_view、performance_max_placement_view です。各ビューでは、プレースメント データを異なる視点から確認できます。Google 広告管理画面のプレースメント画面を再現する、すぐに実行可能な Google 広告クエリ言語(GAQL)と curl クエリについては、クックブックをご覧ください。
手動プレースメント ビュー
- 表示内容:
managed_placement_viewリソースは、広告グループでターゲットに設定したポジティブ プレースメント条件別に集計されたパフォーマンス データを提供します。このビューには、Google 広告の管理画面の [コンテンツ] > [プレースメント] で管理される 5 つの条件タイプ(ウェブサイト、YouTube チャンネル、YouTube 動画、モバイルアプリ、モバイルアプリのカテゴリ)がすべて含まれます。 - UI での対応項目: [コンテンツ] > [プレースメント]
- クエリビルダー: クエリビルダーで探索する
ターゲットとするプレースメントの条件タイプ
managed_placement_view リソースの各行は、ad_group_criterion.type 値に一致する AdGroupCriterion フィールドに入力され、他のプレースメント フィールドは未設定のままになります。
| UI のプレースメント タイプ | ad_group_criterion.type 値 |
条件の詳細フィールド | メモ |
|---|---|---|---|
| Websites | PLACEMENT |
ad_group_criterion.placement.url |
対象のウェブサイトまたはドメインの URL。 |
| YouTube チャンネル | YOUTUBE_CHANNEL |
ad_group_criterion.youtube_channel.channel_id |
YouTube チャンネル ID。ad_group_criterion.display_name フィールドはチャンネル名を返します。 |
| YouTube 動画 | YOUTUBE_VIDEO |
ad_group_criterion.youtube_video.video_id |
YouTube 動画 ID。ad_group_criterion.display_name フィールドは動画のタイトルを返します。 |
| アプリ | MOBILE_APPLICATION |
ad_group_criterion.mobile_application.app_id、ad_group_criterion.mobile_application.name |
{platform}-{platform_native_id} 形式のアプリ ID(iOS の場合は 1-、Android の場合は 2-)とアプリ名。 |
| アプリのカテゴリ | MOBILE_APP_CATEGORY |
ad_group_criterion.mobile_app_category.mobile_app_category_constant |
リソース名(mobileAppCategoryConstants/{mobile_app_category_id} 形式)。モバイルアプリのカテゴリ名と階層をご覧ください。 |
クエリ例
過去 30 日間のすべてのターゲットとするプレースメント タイプにわたるパフォーマンス指標を取得するには、タイプ固有のフィールドとともに ad_group_criterion.type フィールドを選択します。
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.display_name,
ad_group_criterion.placement.url,
ad_group_criterion.youtube_channel.channel_id,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.mobile_application.app_id,
ad_group_criterion.mobile_application.name,
ad_group_criterion.mobile_app_category.mobile_app_category_constant,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
モバイルアプリのカテゴリ名と階層
Google 広告の管理画面では、ターゲットに設定されたモバイルアプリのカテゴリに、[アプリのカテゴリ] > [Apple App Store] > [教育] のように、アプリストアのフルパスが表示されます。Google Ads API をクエリする場合は、次の動作に注意してください。
- モバイルアプリのカテゴリ定数の属性:
mobile_app_category_constantリソースは、managed_placement_viewリソースの属性リソースではありません。代わりにad_group_criterion.mobile_app_category.mobile_app_category_constantフィールド(mobileAppCategoryConstants/60503など)を選択するか、指標が不要な場合はad_group_criterionリソースをクエリします。 - リーフのみの表示名:
ad_group_criterion.display_nameフィールドとmobile_app_category_constant.nameフィールドの両方で、リーフカテゴリ名("Education"や"Games"など)のみが返されます。どちらのフィールドにも、親アプリストアのパスは含まれません。 - アプリストアのパスの解決: Google Play と Apple App Store では、異なる条件 ID でリーフ カテゴリ名が共有されます。たとえば、条件 ID
60005(/All Apps/Google Play/Education)、60060(/All Apps/Google Play/Family/Education)、60503(/All Apps/Apple App Store/Education)はすべて、nameフィールドとdisplay_nameフィールドで"Education"を返します。リソース名から{mobile_app_category_id}接尾辞を抽出し、モバイルアプリのカテゴリの表または CSV ファイルで完全な階層パスをルックアップします。
グループ プレースメント ビュー
- 表示内容:
group_placement_viewリソースには、ディスプレイ ネットワークと YouTube で広告が実際に配信された場所が表示されます。プレースメントが明示的にターゲットに設定されたか、Google のシステムによって自動的に検出されたかは関係ありません。これには、ウェブサイト、YouTube チャンネル、動画、アプリなどが含まれます。 - UI での対応項目: [コンテンツ] > [広告が表示された場所]
- クエリビルダー: クエリビルダーで探索する
クエリ例
次のクエリは、過去 30 日間に広告が表示されたドメイン、モバイルアプリ、YouTube チャンネルのパフォーマンス指標を取得します。
SELECT
campaign.id,
ad_group.id,
group_placement_view.display_name,
group_placement_view.target_url,
group_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS
「合計: その他」行
レポートの生成を高速化するため、group_placement_view リソースと detail_placement_view リソースでは、インプレッション数またはインタラクション数の最小アクティビティ基準を満たしていない個々のプレースメントが除外されます。
- Google 広告の管理画面: このアクティビティのしきい値を満たさないプレースメントは、[合計: その他] というラベルの概要行に集計されます。
- Google Ads API の場合: API は、アクティビティのしきい値を満たしていないプレースメントをレポート結果から除外し、
group_placement_view.placementフィールドまたはdetail_placement_view.placementフィールドの値が"Other"である概要行を返しません。
そのため、group_placement_view リソースと detail_placement_view リソースの個々のプレースメント行の合計が、広告グループまたはキャンペーンの合計指標よりも低くなる可能性があります。詳しくは、「広告が表示された場所」レポートについてをご覧ください。しきい値とメタデータの欠落がクロスビュー比較にどのように影響するかについては、プレースメント ビュー間の指標の違いとプレースメントの詳細が利用できない行をご覧ください。
プレースメント ターゲティングの設定
group_placement_view の動作とユーティリティは、広告グループ単位の PLACEMENT ディメンションの TargetingSetting の影響を受けます。この設定には
target_restrictions のリストが含まれます。各 には、広告をターゲットとするプレースメントのみに表示するか、
他のプレースメントにも表示するかを指定する bid_only ブール値
フィールドがあります。「ターゲティング」と「モニタリング」設定についてをご覧ください。
bid_only = false: この値は、Google 広告の管理画面のプレースメントのターゲティングに対応します。広告グループが [ターゲティング] に設定されている場合、広告は、条件として明示的に追加したプレースメントにのみ表示されます。これらのプレースメントに入札単価調整を適用することもできます。このシナリオでは、group_placement_viewはmanaged_placement_viewをほぼ反映しますが、最小アクティビティしきい値の対象となります。bid_only = true: この値は、プレースメントの Google 広告管理画面の [モニタリング] に対応します。広告グループが [モニタリング] に設定されている場合、広告はディスプレイ ネットワークと YouTube の有効なプレースメントに表示されます。また、ターゲットに設定したプレースメントに入札単価調整を適用することもできます。この場合、group_placement_viewは、広告が表示されている新しいプレースメントを検出するために重要です。これらのプレースメントは、手動プレースメントまたは除外として追加できます。
詳細プレースメント ビュー
- 表示内容:
detail_placement_viewリソースは、ドメインやチャネルのレベルを超えた詳細なプレースメントの内訳を提供します。たとえば、広告が表示された特定の URL や YouTube 動画 ID を確認できます。 - UI での操作: [コンテンツ] > [広告が表示された場所] で行を選択し、[詳細を表示] をクリックする操作に相当します。
- クエリビルダー: クエリビルダーで探索する
- 重要な考慮事項:
group_placement_viewリソースと同様に、このビューでは、最小アクティビティしきい値を満たしていないアクティビティの少ないプレースメントは省略されます(「合計: その他」行セクションをご覧ください)。
クエリ例
結果の量を制限するため、次のクエリでは、7 日間の期間にわたる URL レベルと動画レベルのプレースメント指標を取得します。大規模なアカウントの場合は、campaign.id フィールドまたは ad_group.id フィールドでさらにフィルタします。
SELECT
campaign.id,
ad_group.id,
detail_placement_view.display_name,
detail_placement_view.target_url,
detail_placement_view.group_placement_target_url,
detail_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS
プレースメント メタデータが利用できない行を除外するには、AND
detail_placement_view.target_url IS NOT NULL を追加します(プレースメントの詳細が利用できない行を参照)。resource_name フィールドを返す必要がない場合は、PARAMETERS
omit_unselected_resource_names = true 句を追加します。
プレースメント ビュー間の指標の違い
最小アクティビティしきい値は、各粒度レベルで個別に評価されます。
group_placement_viewリソースは、集計されたドメイン、モバイルアプリ、YouTube チャンネル全体でしきい値を評価します。detail_placement_viewリソースは、個々のページ URL または YouTube 動画ごとにしきい値を評価します。
detail_placement_view リソースでは、しきい値を満たしていない個々のページ URL または YouTube 動画は省略されます。その結果、ドメインまたは YouTube チャンネルの detail_placement_view 行(detail_placement_view.group_placement_target_url フィールドでフィルタリング)を合計すると、対応する group_placement_view 行よりもインプレッション数が少なくなることがあります。
プレースメントの詳細が利用できない行
group_placement_view リソースまたは detail_placement_view リソースに対するクエリでは、placement、display_name、target_url フィールドが設定されておらず、resource_name 値が同じ(~MTRf で終わるなど)である同じ広告グループ内の複数の行が返されることがあります。
この動作は次の理由で発生します。
- 内部プレースメントのグループ化: どちらのビューでも、パフォーマンス指標は
resource_name文字列フィールドやplacement文字列フィールドではなく、一意の内部プレースメント識別子でグループ化されます。 - プレースメントのメタデータが利用できない: Google 広告の管理画面では、バックエンドのルックアップ テーブルにメタデータがないプレースメントは、不明、チャンネルは利用できなくなりました、動画は利用できなくなりましたと表示されます。API では、個別のプレースメント識別子ごとに指標行が返されますが、
placement、display_name、target_urlフィールドは設定されません。 - 合成リソース名:
resource_nameフィールドの{base64_placement}接尾辞は、{type_id}_{placement}から Base64 でエンコードされます。ここで、{type_id}はPlacementType列挙型番号ではなく、内部プレースメント タイプ識別子です。placement_typeフィールドがWEBSITE(内部 ID14)で、placementフィールドが設定されていない場合、文字列"14_"はMTRfにエンコードされます(同様に、MOBILE_APPLICATIONは"55_"をNTVfにエンコードし、YOUTUBE_VIDEOは"89_"をODlfにエンコードし、YOUTUBE_CHANNELは"90_"をOTBfにエンコードします)。したがって、同じ広告グループ内でメタデータが利用できない同じタイプの複数のプレースメントは、同じresource_name値を共有しながら、別々の指標行をレポートします。
クライアント コードで group_placement_view または detail_placement_view の結果を処理する場合は、resource_name フィールドのみで行の重複除去を行わないでください。これを行うと、使用できないメタデータを含む個別のプレースメント間で指標が上書きされる可能性があります。GAQL でメタデータが利用できない行を除外するには、target_url フィールドまたは display_name フィールドでフィルタします。placement フィールドと resource_name フィールドはフィルタできません。たとえば、WHERE group_placement_view.target_url IS
NOT NULL または WHERE detail_placement_view.target_url IS NOT NULL を使用します。
P-MAX キャンペーンのプレースメント ビュー
- 表示内容:
performance_max_placement_viewリソースは、P-MAX 広告が配信されたプレースメントのインプレッション データ(metrics.impressions)を提供します。v24 以降では、performance_max_placement_viewをsegments.ad_network_typeで分割できます(v23 ではサポートされていません)。 - UI での操作: [分析情報とレポート] > [レポート エディタ] > [P-MAX キャンペーンのプレースメント]
- クエリビルダー: クエリビルダーで探索する
クエリ例
次のクエリは、過去 30 日間の P-MAX キャンペーンについて、広告ネットワーク タイプ別に分割されたプレースメントのインプレッション数を取得します。
SELECT
campaign.id,
performance_max_placement_view.display_name,
performance_max_placement_view.target_url,
performance_max_placement_view.placement_type,
segments.ad_network_type,
metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS
プレースメント ビューを選択する
managed_placement_viewを使用して、積極的にターゲットに設定して入札しているプレースメントのパフォーマンスを評価します。group_placement_viewを使用すると、広告が表示されている場所の全体像を把握できます。特に「モニタリング」設定を使用している場合は、新しいターゲティングの機会や除外対象を特定できます。detail_placement_viewを使用すると、広告が表示された特定の URL または動画に関する最も詳細な情報を取得できます。これは、group_placement_viewで関心のあるドメインまたはチャンネルを特定した後に使用されることがよくあります。performance_max_placement_viewを使用して、P-MAX キャンペーンのプレースメント インプレッションを検査します。