แคมเปญวิดีโอ

แคมเปญวิดีโอช่วยให้คุณแสดงโฆษณาวิดีโอบน 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 ได้
• แคมเปญ Demand Gen: หากเป้าหมายของคุณคือการแสดงโฆษณาวิดีโอในผลิตภัณฑ์และบริการของ Google รวมถึง YouTube Google Ads API รองรับแคมเปญ Demand Gen อย่างเต็มรูปแบบทั้งสำหรับการสร้างและการจัดการ

ดูข้อมูลประสิทธิภาพ

คุณสามารถดึงข้อมูลประสิทธิภาพของแคมเปญวิดีโอ กลุ่มโฆษณา และเกณฑ์ต่างๆ โดยใช้ GoogleAdsService.SearchStream ด้วยการกรองหา campaign.advertising_channel_type = 'VIDEO'

หมายเหตุ: ใช้ metrics.video_trueview_views, metrics.video_trueview_view_rate และ metrics.trueview_average_cpv สำหรับเมตริกยอดดู TrueView ตั้งแต่เดือนv25เป็นต้นไป คุณยังสามารถเลือก segments.ad_sub_format_type (ควบคู่ไปกับ segments.ad_format_type) เพื่อแจกแจงโฆษณาในสตรีมแบบข้ามไม่ได้ตามระยะเวลา รวมถึงเมตริกการมีส่วนร่วมทางโซเชียลของวิดีโอ (metrics.youtube_comments, metrics.youtube_likes และ metrics.youtube_shares)

ประสิทธิภาพของกลุ่มโฆษณา

คําค้นหาต่อไปนี้จะดึงเมตริกแคมเปญวิดีโอและกลุ่มโฆษณา ซึ่งรวมถึงยอดดูวิดีโอ TrueView และอัตราการเล่นจนจบตามควอไทล์จากแหล่งข้อมูล ad_group

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

การรายงานการเข้าถึงและความถี่ของแคมเปญ

สำหรับแคมเปญวิดีโอ คุณสามารถค้นหาเมตริก Unique Reach ในทรัพยากร campaign เพื่อวัดจำนวนบุคคลที่ไม่ซ้ำซึ่งเห็นโฆษณาของคุณที่ความถี่ในการแสดงผลที่เฉพาะเจาะจง

เมตริกผู้ใช้ที่ไม่ซ้ำต่อไปนี้จะวัดการเข้าถึงกลุ่มเป้าหมายในกลุ่มความถี่ต่างๆ

• metrics.unique_users: จำนวนผู้ใช้ที่ไม่ซ้ำกันที่เห็นโฆษณาของคุณอย่างน้อย 1 ครั้งภายในช่วงวันที่ที่เลือก (สูงสุด 92 วัน) และไม่สามารถรวมข้ามแถวได้
• metrics.unique_users_two_plus ถึง metrics.unique_users_ten_plus: จำนวนผู้ใช้ที่ไม่ซ้ำซึ่งเห็นโฆษณาของคุณอย่างน้อย 2 ถึง 10 ครั้งตามลำดับ สำหรับช่วงวันที่สูงสุด 31 วัน (โดยมี metrics.unique_users_six_plus ถึง metrics.unique_users_nine_plus เป็นชุด 2+ ถึง 10+ ที่สมบูรณ์ใน v26 ขึ้นไป)
• metrics.average_impression_frequency_per_user: จำนวนครั้งโดยเฉลี่ยที่ผู้ใช้ที่ไม่ซ้ำเห็นโฆษณาของคุณในช่วงเวลาที่ขอ (สูงสุด 92 วัน) โดยไม่สามารถรวมข้ามแถวและไม่มีช่อง _info ที่เชื่อมโยง

ใน v26 ขึ้นไป เมตริกการเข้าถึงแต่ละรายการจะมีช่องข้อมูลเมตาที่เชื่อมโยงกันประเภท ReachMetricInfo ได้แก่ metrics.unique_users_info และ metrics.unique_users_two_plus_info ถึง metrics.unique_users_ten_plus_info

ในภาษาการค้นหาของ Google Ads (GAQL) ช่องการเข้าถึงที่แสดงร่วมกันคือMESSAGE เมตริกที่เลือกโดยตรงในส่วนคำสั่ง SELECT (เช่น metrics.unique_users_info) อย่าเพิ่ม .reach_metric_states ในส่วนคำสั่ง SELECT เนื่องจากจะเลือกช่องข้อความที่ฝังใน GAQL ไม่ได้และจะแสดงข้อผิดพลาด UNRECOGNIZED_FIELD แต่การเลือก metrics.unique_users_info จะแสดงข้อความ ReachMetricInfo ที่มีช่อง enum reach_metric_states ซ้ำของประเภท ReachMetricState ซึ่งอธิบายว่าเมตริกถูกระงับหรือสมบูรณ์แล้ว

เมื่อใดก็ตามที่มีการระงับเมตริกการเข้าถึงหรืออยู่นอกกรอบเวลาเก็บรักษา (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION หรือ DATE_RANGE_BEYOND_RETENTION) ระบบจะไม่ตั้งค่าช่อง optional int64 ใน Metrics (ซึ่งจะประเมินเป็น 0 หากไม่ได้เลือกการแสดงช่อง) ในขณะที่ LOW_QUALITY ยังคงป้อนข้อมูลเมตริกตัวเลข

ค่า enum ReachMetricState จะระบุสถานะของข้อมูลการเข้าถึง ดังนี้

• COMPLETE: เมตริกการเข้าถึงเสร็จสมบูรณ์โดยไม่มีการระงับเนื่องจากความเป็นส่วนตัว คุณภาพ หรือขีดจำกัดอื่นๆ
• PRIVACY_SUPPRESSION: ระบบระงับข้อมูลการเข้าถึงเพื่อปกป้องความเป็นส่วนตัวของผู้ใช้ (เช่น เมื่อปริมาณกลุ่มเป้าหมายไม่เป็นไปตามเกณฑ์ k-anonymity)
• QUALITY_SUPPRESSION: ระบบระงับข้อมูลการเข้าถึงเนื่องจากข้อกำหนดด้านคุณภาพของข้อมูล
• LOW_QUALITY: ระบบคำนวณเมตริกการเข้าถึงแล้ว แต่มีการแจ้งว่ามีคุณภาพต่ำ
• DATE_RANGE_BEYOND_RETENTION: เมตริกการเข้าถึงไม่พร้อมใช้งานเนื่องจากช่วงวันที่ที่เลือกเกินระยะเวลาเก็บรักษาข้อมูล 3 ปีสำหรับข้อมูลการเข้าถึง

คําค้นหาต่อไปนี้จะดึงข้อมูลเมตริกการเข้าถึงและสถานะการระงับสําหรับแคมเปญวิดีโอ

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  segments.device,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.average_impression_frequency_per_user,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_three_plus,
  metrics.unique_users_three_plus_info,
  metrics.unique_users_four_plus,
  metrics.unique_users_four_plus_info,
  metrics.unique_users_five_plus,
  metrics.unique_users_five_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_seven_plus,
  metrics.unique_users_seven_plus_info,
  metrics.unique_users_eight_plus,
  metrics.unique_users_eight_plus_info,
  metrics.unique_users_nine_plus,
  metrics.unique_users_nine_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date BETWEEN '2026-01-01' AND '2026-01-31'

หมายเหตุ: เมตริกการเข้าถึงและความถี่ไม่สามารถรวมข้ามแถวได้ แม้ว่า metrics.unique_users และ metrics.average_impression_frequency_per_user จะรองรับช่วงวันที่สูงสุด 92 วันและแบ่งกลุ่มตามsegments.date, segments.device, segments.adjusted_age_range และsegments.adjusted_gender ได้ แต่เมตริกที่เก็บความถี่ unique_users_*_plus (สูงสุด 31 วัน) และช่อง metrics.unique_users*_info ที่ใช้ร่วมกันทั้งหมดรองรับเฉพาะsegments.date และ segments.device เท่านั้น นอกจากนี้ ช่อง metrics.unique_users*_info ที่ใช้ร่วมกันยังเป็นเมตริก MESSAGE ที่มี filterable: false และ sortable: false จึงไม่สามารถใช้ในส่วนคำสั่ง WHERE หรือ ORDER BY ได้ ดูรายละเอียดเพิ่มเติมเกี่ยวกับการจัดการเมตริกการเข้าถึงที่ถูกระงับในรายงานได้ที่การระงับเมตริกการเข้าถึงและค่าเป็น 0