動画キャンペーン

動画キャンペーンでは、YouTube および Google 動画パートナー上のウェブサイトやアプリで配信される動画に動画広告を表示できます。

API の制限事項

Google Ads API は主に、既存の動画キャンペーン、広告グループ、広告、条件の取得とレポート作成をサポートしています。Google Ads API を使用して動画キャンペーンを作成または変更することはできません。ただし、バージョン固有の例外と動作は次のとおりです。

• VideoResponsiveAdInfo の可変性: v24 以降では、VideoResponsiveAdInfo オブジェクトは可変です（以前のバージョンでは不変です）。VideoResponsiveAdInfo を作成または変更する場合、videos、business_name、logo_images の各フィールドは必須です。
• ブランド保護の適合性: v24 以降、キャンペーン単位の campaign.video_brand_safety_suitability が削除されます。customer.video_brand_safety_suitability を使用して、アカウント単位でブランド保護の適合性をクエリします。
• 動画キャンペーンのテスト: v24 以降、動画キャンペーンで構成される YOUTUBE_CUSTOM テストを構成するために experiment.video_experiment を使用できます。

キャンペーン管理の代替手段

動画キャンペーンをプログラムで作成または管理する必要がある場合は、次のオプションをご検討ください。

• Google 広告スクリプト: Google 広告スクリプトを使用して、動画キャンペーンを管理できます。これにより、Google 広告のインターフェース内で自動管理が可能になります。
• デマンド ジェネレーション キャンペーン: YouTube を含む Google サービス全体で動画広告を配信することが目標の場合は、デマンド ジェネレーション キャンペーンの作成と管理の両方で Google Ads API が完全にサポートされています。

パフォーマンス データを取得する

campaign.advertising_channel_type = 'VIDEO' でフィルタして GoogleAdsService.SearchStream を使用すると、動画キャンペーン、広告グループ、条件のパフォーマンス データを取得できます。

注: metrics.video_trueview_views、metrics.video_trueview_view_rate、metrics.trueview_average_cpv（v22 の以前の metrics.video_views、metrics.video_view_rate、metrics.average_cpv フィールドから名前が変更されました）を使用します。v25 以降では、segments.ad_sub_format_type（segments.ad_format_type とともに）を選択して、スキップ不可のインストリーム広告を再生時間別に分類したり、動画のソーシャル エンゲージメント指標（metrics.youtube_comments、metrics.youtube_likes、metrics.youtube_shares）を取得したりすることもできます。

広告グループのパフォーマンス

次のクエリは、ad_group リソースから TrueView 動画視聴回数や四分位完了率などの動画キャンペーンと広告グループの指標を取得します。

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  ad_group.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.video_trueview_views,
  metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'

動画のプレースメントと条件のレポート

ad_group_criterion は指標やセグメントを直接サポートしていないため、managed_placement_view などの条件ビュー リソースを使用して、ターゲットの YouTube 動画、YouTube チャンネル、その他の管理プレースメントのパフォーマンス指標を取得します。

SELECT
  campaign.id,
  ad_group.id,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.youtube_channel.channel_id,
  metrics.impressions,
  metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
  AND segments.date DURING LAST_30_DAYS