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

แคมเปญวิดีโอช่วยให้คุณแสดงโฆษณาวิดีโอบน YouTube และตามเว็บไซต์และแอปที่ทำงานในพาร์ทเนอร์วิดีโอของ Google ได้

ข้อจำกัดของ API

Google Ads API รองรับการดึงข้อมูลและการรายงานเกี่ยวกับแคมเปญวิดีโอ กลุ่มโฆษณา โฆษณา และเกณฑ์ที่มีอยู่เป็นหลัก คุณไม่สามารถสร้างหรือเปลี่ยนแปลงแคมเปญวิดีโอโดยใช้ Google Ads API โดยมีข้อยกเว้นและลักษณะการทำงานเฉพาะเวอร์ชันต่อไปนี้

  • ความสามารถในการเปลี่ยนแปลงได้ของ VideoResponsiveAdInfo: ตั้งแต่ v24 เป็นต้นไป ออบเจ็กต์ VideoResponsiveAdInfo จะเปลี่ยนแปลงได้ (ในเวอร์ชันก่อนหน้าจะเปลี่ยนแปลงไม่ได้) เมื่อสร้างหรือเปลี่ยนแปลง VideoResponsiveAdInfo คุณต้องระบุช่อง videos, business_name และ logo_images
  • ความเหมาะสมกับแบรนด์: ตั้งแต่เวอร์ชัน 24 เป็นต้นไป ระบบจะนํา 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'

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

คําค้นหาต่อไปนี้จะดึงข้อมูลเมตริกแคมเปญวิดีโอและกลุ่มโฆษณา ซึ่งรวมถึงยอดดูวิดีโอ 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 และ customer (เริ่มต้นใน v26) เพื่อวัดจํานวนบุคคลที่ไม่ซ้ำกันซึ่งเห็นโฆษณาของคุณที่ความถี่ในการแสดงผลที่เฉพาะเจาะจง

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

  • 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 วัน) เมตริกนี้ใช้ได้เฉพาะในทรัพยากร campaign, ไม่สามารถรวมข้ามแถว และไม่มีช่อง _info ที่ใช้ร่วมกัน

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

ในภาษาการค้นหาของ Google Ads (GAQL) ช่องที่ใช้ร่วมกันmetrics.unique_users*_infoคือเมตริก MESSAGE ที่มี filterable: false และ sortable: false คุณจึงไม่สามารถใช้ในส่วนคำสั่ง WHERE หรือ ORDER BY ได้ เลือกช่องเหล่านี้โดยตรงในส่วนคำสั่ง 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 ปีสำหรับข้อมูลการเข้าถึง

คําค้นหาต่อไปนี้จะดึงข้อมูลเมตริกการเข้าถึงที่กรองข้อมูลที่ซ้ำกันออกในช่วง 30 วันและสถานะการระงับสําหรับแคมเปญวิดีโอ โดยแบ่งกลุ่มตามอุปกรณ์และรูปแบบโฆษณา ละเว้นกลุ่ม segments.date จากส่วนคำสั่ง SELECT เพื่อให้เมตริกการเข้าถึงและN+ความถี่กรองข้อมูลที่ซ้ำกันออกตลอดกรอบเวลาทั้งหมดแทนที่จะเป็นต่อวัน ดังนี้

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  segments.ad_format_type,
  segments.ad_sub_format_type,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

แหล่งข้อมูล กรอบเวลา และกลุ่มที่รองรับ

การค้นหาการเข้าถึงและความถี่ต้องใช้ตัวกรอง segments.date แบบจำกัดภายในกรอบเวลาสูงสุดของเมตริก การค้นหาที่ไม่มีตัวกรองวันที่หรือเกินกรอบเวลาจะแสดงช่องการเข้าถึงที่ไม่ได้ตั้งค่าไว้ ดังนี้

เมตริก แหล่งข้อมูล ช่วงวันที่สูงสุด กลุ่มที่เข้ากันได้
metrics.unique_users campaign, customer (v26 ขึ้นไป) 92 วัน segments.date, segments.device, กลุ่มรูปแบบโฆษณา (v26 ขึ้นไป), กลุ่มเครือข่ายโฆษณา (v26 ขึ้นไป) และกลุ่มเป้าหมายตามข้อมูลประชากรที่ปรับแล้ว
metrics.average_impression_frequency_per_user campaign 92 วัน segments.date, segments.device และกลุ่มเป้าหมายตามข้อมูลประชากรที่ปรับแล้ว
metrics.unique_users_two_plus ถึง metrics.unique_users_ten_plus campaign, customer (v26 ขึ้นไป) 31 วัน segments.date, segments.device, กลุ่มรูปแบบโฆษณา (v26 ขึ้นไป) และกลุ่มเครือข่ายโฆษณา (v26 ขึ้นไป)
metrics.unique_users*_info (v26 ขึ้นไป) campaign, customer เมตริกฐานการจับคู่ segments.date, segments.device, กลุ่มรูปแบบโฆษณา และกลุ่มเครือข่ายโฆษณา

เมื่อแบ่งกลุ่มคำค้นหาการเข้าถึง ให้ใช้ข้อจำกัดของกลุ่มร่วมต่อไปนี้

  • กลุ่มรูปแบบโฆษณาเทียบกับกลุ่มเครือข่ายโฆษณา: คุณสามารถแบ่งกลุ่มตามรูปแบบโฆษณา (segments.ad_format_type โดยจะใช้ segments.ad_sub_format_type หรือไม่ก็ได้) หรือตามเครือข่ายโฆษณา (segments.ad_network_type โดยจะใช้ segments.ad_sub_network_type หรือไม่ก็ได้) แต่จะรวมกลุ่มรูปแบบโฆษณาและกลุ่มเครือข่ายโฆษณาไว้ในการค้นหาเดียวกันไม่ได้ เลือกกลุ่มหลัก (segments.ad_format_type หรือ segments.ad_network_type) เสมอเมื่อเลือกกลุ่มย่อย กลุ่ม segments.ad_sub_format_type จะแจกแจงโฆษณาในสตรีมแบบข้ามไม่ได้ตามระยะเวลาและแสดงผล UNSEGMENTED สำหรับรูปแบบโฆษณาอื่นๆ ส่วนกลุ่ม segments.ad_sub_network_type จะแจกแจงแพลตฟอร์มต่างๆ ของ YouTube (YOUTUBE_INSTREAM, YOUTUBE_INFEED และ YOUTUBE_SHORTS) สำหรับแคมเปญ Demand Gen เท่านั้น และแสดงผล UNSEGMENTED สำหรับแคมเปญวิดีโอ
  • กลุ่มเป้าหมายตามข้อมูลประชากรที่ปรับแล้ว: กลุ่ม segments.adjusted_age_range และ segments.adjusted_gender ใช้ได้กับบัญชีที่อยู่ในรายการที่อนุญาตเท่านั้น โดยต้องเลือกพร้อมกัน และไม่สามารถรวมกับเมตริก metrics.unique_users_*_plus, ช่อง metrics.unique_users*_info หรือกลุ่มเครือข่ายโฆษณา