影片廣告活動

影片廣告活動可在 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 起，您可使用 experiment.video_experiment 設定包含影片廣告活動的實驗。YOUTUBE_CUSTOM

廣告活動管理替代方案

如需以程式輔助方式建立或管理影片廣告活動，請考慮下列選項：

  • Google Ads 指令碼：您可以使用 Google Ads 指令碼管理影片廣告活動。這樣就能在 Google Ads 介面中自動管理。
  • 需求開發廣告活動：如果您的目標是在 YouTube 等 Google 資源中放送影片廣告，Google Ads API 完全支援需求開發廣告活動的建立和管理作業。

取得成效資料

您可以透過篩選 campaign.advertising_channel_type = 'VIDEO'，使用 GoogleAdsService.SearchStream 擷取影片廣告活動、廣告群組和條件的成效資料。

廣告群組成效

下列查詢會從 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