- แหล่งข้อมูล: โฆษณาของกลุ่มโฆษณา
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- ภาพปก
- VideoPerformanceAd
- AdUrl
- AdUrlType
- เมธอด
ทรัพยากร: โฆษณาในกลุ่มโฆษณา
โฆษณาเดียวที่เชื่อมโยงกับกลุ่มโฆษณา
การแสดง 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 |
รายละเอียดของโฆษณาวิดีโอสั้นๆ แบบข้ามไม่ได้ ที่ใช้เพื่อการเข้าถึง ที่เท่ากับหรือน้อยกว่า 6 วินาที |
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 |
รูปภาพขนาดย่อที่ใช้ในโฆษณา |
ภาพปก
ตัวเลือกภาพขนาดย่อที่ใช้ได้ในโฆษณา 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[] |
รายการบรรทัดแรกที่แสดงในแบนเนอร์คำกระตุ้นให้ดำเนินการ |
longHeadlines[] |
รายการบรรทัดแรกเดี่ยวๆ ที่แสดงในแบนเนอร์คำกระตุ้นให้ดำเนินการ (Call-To-Action) |
descriptions[] |
รายการคำอธิบายที่แสดงในแบนเนอร์คำกระตุ้นให้ดำเนินการ |
displayUrlBreadcrumb1 |
ส่วนแรกต่อจากโดเมนใน URL ที่แสดง |
displayUrlBreadcrumb2 |
ส่วนที่สองถัดจากโดเมนใน 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 เมื่อมีการทริกเกอร์เหตุการณ์การข้าม |
วิธีการ |
|
---|---|
|
รับโฆษณาระดับกลุ่มโฆษณา |
|
แสดงรายการโฆษณาของกลุ่มโฆษณา |