แคมเปญวิดีโอช่วยให้คุณแสดงโฆษณาวิดีโอบน 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หรือกลุ่มเครือข่ายโฆษณา