- แหล่งข้อมูล: YouTubeAdGroupAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- ภาพปก
- VideoPerformanceAd
- AdUrl
- AdUrlType
- เมธอด
แหล่งข้อมูล: YouTubeAdGroupAd
โฆษณาเดียวที่เชื่อมโยงกับกลุ่มโฆษณา YouTube
การแสดง JSON |
---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "entityStatus": enum ( |
ช่อง | |
---|---|
name |
ชื่อทรัพยากรของโฆษณา |
advertiserId |
รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่เป็นเจ้าของโฆษณา |
adGroupAdId |
รหัสที่ไม่ซ้ำกันของโฆษณา กำหนดโดยระบบ |
adGroupId |
รหัสที่ไม่ซ้ำของกลุ่มโฆษณาที่มีโฆษณา |
displayName |
ชื่อที่แสดงของโฆษณา ต้องเป็นแบบ UTF-8 ที่เข้ารหัสด้วยขนาดสูงสุด 255 ไบต์ |
entityStatus |
สถานะเอนทิตีของโฆษณา |
adUrls[] |
รายการ URL ที่โฆษณาใช้ |
ฟิลด์สหภาพ ad_details รายละเอียดของโฆษณา ad_details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
displayVideoSourceAd |
รายละเอียดโฆษณาที่มาจากครีเอทีฟโฆษณา Display & Video 360 |
mastheadAd |
รายละเอียดโฆษณาที่แสดงในฟีดบนหน้าแรกของ YouTube |
inStreamAd |
รายละเอียดของโฆษณาในสตรีมที่ข้ามได้หลังจากเล่นไปแล้ว 5 วินาที ซึ่งใช้เพื่อการรับรู้ถึงแบรนด์หรือบรรลุวัตถุประสงค์ทางการตลาด |
nonSkippableAd |
รายละเอียดของโฆษณาวิดีโอในสตรีมแบบสั้นที่ข้ามไม่ได้ความยาว 6-15 วินาที ซึ่งใช้เพื่อวัตถุประสงค์ทางการตลาด |
bumperAd |
รายละเอียดของโฆษณาวิดีโอสั้นๆ แบบข้ามไม่ได้ที่ใช้เพื่อการเข้าถึง |
audioAd |
รายละเอียดของโฆษณาเสียงที่ใช้สำหรับบรรลุวัตถุประสงค์ทางการตลาด |
videoDiscoverAd |
รายละเอียดของโฆษณาที่โปรโมตวิดีโอที่แสดงในที่ที่มีการค้นพบ |
videoPerformanceAd |
รายละเอียดโฆษณาที่ใช้ในแคมเปญวิดีโอเพื่อกระตุ้นการกระทำเพื่อกระตุ้นการกระทำต่อธุรกิจ บริการ หรือผลิตภัณฑ์ |
DisplayVideoSourceAd
โฆษณาที่มาจากครีเอทีฟโฆษณา DV360
การแสดง JSON |
---|
{ "creativeId": string } |
ช่อง | |
---|---|
creativeId |
รหัสของครีเอทีฟโฆษณาแหล่งที่มา |
MastheadAd
รายละเอียดสำหรับโฆษณา Masthead
การแสดง JSON |
---|
{ "video": { object ( |
ช่อง | |
---|---|
video |
วิดีโอ YouTube ที่โฆษณาใช้ |
headline |
บรรทัดแรกของโฆษณา |
description |
คำอธิบายของโฆษณา |
videoAspectRatio |
สัดส่วนภาพของวิดีโอ YouTube ที่เล่นอัตโนมัติในโฆษณา Masthead |
autoplayVideoStartMillisecond |
ระยะเวลาเป็นมิลลิวินาทีที่วิดีโอจะเริ่มเล่นหลังจากนั้น |
autoplayVideoDuration |
ระยะเวลาที่วิดีโอจะเล่นอัตโนมัติ ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
callToActionButtonLabel |
ข้อความบนปุ่มคำกระตุ้นให้ดำเนินการ |
callToActionFinalUrl |
URL ปลายทางสำหรับปุ่มคำกระตุ้นการตัดสินใจ |
callToActionTrackingUrl |
URL ติดตามสำหรับปุ่มคำกระตุ้นให้ดำเนินการ |
showChannelArt |
แสดงพื้นหลังหรือแบนเนอร์ที่ด้านบนของหน้า YouTube ไหม |
companionYoutubeVideos[] |
วิดีโอที่ปรากฏถัดจากโฆษณา Masthead บนเดสก์ท็อป ต้องไม่เกิน 2 |
YoutubeVideoDetails
รายละเอียดวิดีโอ YouTube
การแสดง JSON |
---|
{
"id": string,
"unavailableReason": enum ( |
ช่อง | |
---|---|
id |
รหัสวิดีโอ YouTube ซึ่งค้นหาได้ในหน้าเว็บ YouTube |
unavailableReason |
สาเหตุที่ข้อมูลวิดีโอไม่พร้อมใช้งาน |
VideoAspectRatio
สัดส่วนภาพที่เป็นไปได้สำหรับวิดีโอ YouTube
Enum | |
---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
ไม่ระบุหรือไม่รู้จัก |
VIDEO_ASPECT_RATIO_WIDESCREEN |
วิดีโอยืดออกโดยครอบตัดด้านบนและด้านล่างแล้ว |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
วิดีโอใช้สัดส่วนภาพแบบคงที่ 16:9 |
InStreamAd
รายละเอียดสำหรับโฆษณาในสตรีม
การแสดง JSON |
---|
{
"commonInStreamAttribute": {
object ( |
ช่อง | |
---|---|
commonInStreamAttribute |
แอตทริบิวต์โฆษณาทั่วไป |
customParameters |
พารามิเตอร์ที่กำหนดเองที่จะส่งค่าที่กำหนดเองไปยังเทมเพลต URL ติดตาม ออบเจ็กต์ที่มีรายการคู่ |
CommonInStreamAttribute
แอตทริบิวต์ทั่วไปสำหรับโฆษณาในสตรีม แบบข้ามไม่ได้ และโฆษณาบัมเปอร์
การแสดง JSON |
---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( |
ช่อง | |
---|---|
displayUrl |
ที่อยู่หน้าเว็บที่ปรากฏพร้อมกับโฆษณา |
finalUrl |
ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะไปถึงหลังจากคลิกโฆษณา |
trackingUrl |
ระบบจะโหลดที่อยู่ URL ในเบื้องหลังเพื่อวัตถุประสงค์ในการติดตาม |
actionButtonLabel |
ข้อความบนปุ่มคำกระตุ้นให้ดำเนินการ |
actionHeadline |
บรรทัดแรกของแบนเนอร์คำกระตุ้นให้ดำเนินการ |
video |
วิดีโอ YouTube ของโฆษณา |
companionBanner |
รูปภาพที่แสดงถัดจากโฆษณาวิดีโอ |
ImageAsset
ข้อมูลเมตาของชิ้นงานรูปภาพ
การแสดง JSON |
---|
{
"mimeType": string,
"fullSize": {
object ( |
ช่อง | |
---|---|
mimeType |
ประเภท MIME ของชิ้นงานรูปภาพ |
fullSize |
ข้อมูลเมตาสำหรับรูปภาพนี้ในขนาดดั้งเดิม |
fileSize |
ขนาดไฟล์ของชิ้นงานรูปภาพในหน่วยไบต์ |
NonSkippableAd
รายละเอียดของโฆษณาแบบข้ามไม่ได้
การแสดง JSON |
---|
{
"commonInStreamAttribute": {
object ( |
ช่อง | |
---|---|
commonInStreamAttribute |
แอตทริบิวต์โฆษณาทั่วไป |
customParameters |
พารามิเตอร์ที่กำหนดเองที่จะส่งค่าที่กำหนดเองไปยังเทมเพลต URL ติดตาม ออบเจ็กต์ที่มีรายการคู่ |
BumperAd
รายละเอียดของโฆษณาบัมเปอร์
การแสดง JSON |
---|
{
"commonInStreamAttribute": {
object ( |
ช่อง | |
---|---|
commonInStreamAttribute |
แอตทริบิวต์โฆษณาทั่วไป |
AudioAd
รายละเอียดสำหรับโฆษณาเสียง
การแสดง JSON |
---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"video": {
object ( |
ช่อง | |
---|---|
displayUrl |
ที่อยู่หน้าเว็บที่ปรากฏพร้อมกับโฆษณา |
finalUrl |
ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะไปถึงหลังจากคลิกโฆษณา |
trackingUrl |
ระบบจะโหลดที่อยู่ URL ในเบื้องหลังเพื่อวัตถุประสงค์ในการติดตาม |
video |
วิดีโอ YouTube ของโฆษณา |
VideoDiscoveryAd
รายละเอียดสำหรับโฆษณา Video Discovery
การแสดง JSON |
---|
{ "headline": string, "description1": string, "description2": string, "video": { object ( |
ช่อง | |
---|---|
headline |
บรรทัดแรกของโฆษณา |
description1 |
ข้อความบรรทัดแรกสำหรับโฆษณา |
description2 |
บรรทัดข้อความที่สองสำหรับโฆษณา |
video |
วิดีโอ YouTube ที่โฆษณาโปรโมต |
thumbnail |
รูปภาพขนาดย่อที่ใช้ในโฆษณา |
ภาพปก
ตัวเลือกภาพขนาดย่อที่ใช้ได้ในโฆษณา Video Discovery
Enum | |
---|---|
THUMBNAIL_UNSPECIFIED |
ไม่รู้จักหรือไม่ได้ระบุ |
THUMBNAIL_DEFAULT |
ภาพขนาดย่อเริ่มต้นอาจสร้างขึ้นโดยอัตโนมัติหรืออัปโหลดโดยผู้ใช้ |
THUMBNAIL_1 |
ภาพขนาดย่อ 1 สร้างขึ้นจากวิดีโอ |
THUMBNAIL_2 |
ภาพขนาดย่อ 2 ที่สร้างจากวิดีโอ |
THUMBNAIL_3 |
ภาพขนาดย่อ 3 ที่สร้างจากวิดีโอ |
VideoPerformanceAd
รายละเอียดสำหรับโฆษณาที่มีประสิทธิภาพวิดีโอ
การแสดง JSON |
---|
{ "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( |
ช่อง | |
---|---|
finalUrl |
ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะไปถึงหลังจากคลิกโฆษณา |
trackingUrl |
ระบบจะโหลดที่อยู่ URL ในเบื้องหลังเพื่อวัตถุประสงค์ในการติดตาม |
actionButtonLabels[] |
รายการชิ้นงานข้อความที่แสดงในปุ่มคำกระตุ้นให้ดำเนินการ (Call-To-Action) |
headlines[] |
รายการบรรทัดแรกที่แสดงในแบนเนอร์คำกระตุ้นให้ดำเนินการ (Call-To-Action) |
longHeadlines[] |
รายการบรรทัดแรกรายการเดียวที่แสดงในแบนเนอร์คำกระตุ้นให้ดำเนินการ (Call-To-Action) |
descriptions[] |
รายการคำอธิบายที่แสดงในแบนเนอร์คำกระตุ้นให้ดำเนินการ (Call-To-Action) |
displayUrlBreadcrumb1 |
ส่วนแรกต่อจากโดเมนใน URL ที่แสดง |
displayUrlBreadcrumb2 |
ส่วนที่ 2 ถัดจากโดเมนใน URL ที่แสดง |
domain |
โดเมนของ URL ที่แสดง |
videos[] |
รายการเนื้อหาวิดีโอ YouTube ที่โฆษณานี้ใช้ |
customParameters |
พารามิเตอร์ที่กำหนดเองที่จะส่งค่าที่กำหนดเองไปยังเทมเพลต URL ติดตาม ออบเจ็กต์ที่มีรายการคู่ |
companionBanners[] |
รายการแบนเนอร์ที่แสดงร่วมกันซึ่งโฆษณานี้ใช้ |
AdUrl
URL เพิ่มเติมที่เกี่ยวข้องกับโฆษณา รวมถึงบีคอน
การแสดง JSON |
---|
{
"type": enum ( |
ช่อง | |
---|---|
type |
ประเภทของ URL โฆษณา |
url |
ค่าสตริง URL |
AdUrlType
ประเภท URL ของโฆษณาที่เป็นไปได้
Enum | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
ไม่รู้จักหรือไม่ได้ระบุ |
AD_URL_TYPE_BEACON_IMPRESSION |
การติดตามพิกเซล 1x1 ที่จะใช้คำสั่ง ping เมื่อมีการแสดงผลโฆษณา |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
บีคอนการแสดงผล DCM ที่ขยายได้ ในขณะให้บริการ จะขยายไปเป็นบีคอนหลายตัว |
AD_URL_TYPE_BEACON_CLICK |
URL ติดตามผลที่ใช้คำสั่ง ping เมื่อมีการทริกเกอร์กิจกรรมการคลิก |
AD_URL_TYPE_BEACON_SKIP |
URL ติดตามผลที่ใช้คำสั่ง ping เมื่อมีการทริกเกอร์เหตุการณ์การข้าม |
วิธีการ |
|
---|---|
|
รับโฆษณาในกลุ่มโฆษณา YouTube |
|
แสดงโฆษณาของกลุ่มโฆษณา YouTube |