ภาคผนวก: การจับคู่ช่อง UI กับช่อง API ตามประเภทครีเอทีฟโฆษณา
ตารางด้านล่างจะแมปช่อง UI กับช่อง API ที่เกี่ยวข้อง โดยแยกตามประเภทโฆษณา โปรดทราบว่าช่อง API บางช่องจำเป็นต้องมีข้อกำหนดเพิ่มเติมผ่านบทบาทหรือประเภทที่ได้รับมอบหมายสำหรับทรัพยากรที่จัดเตรียมไว้
โฆษณาแบบรูปภาพมาตรฐาน
ประเภทโฆษณา: CREATIVE_TYPE_STANDARD |
แหล่งที่มาโฮสติ้ง: HOSTING_SOURCE_HOSTED |
ชื่อ
|
จำเป็น
|
ชื่อช่อง API: displayName
|
|
ชิ้นงานครีเอทีฟโฆษณา
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_MAIN
|
|
URL ของหน้า Landing Page
|
จำเป็น
|
ชื่อช่อง API: exitEvents[].url
|
ประเภทเหตุการณ์การออก: EXIT_EVENT_TYPE_DEFAULT
|
|
สถานะ
|
จำเป็น
|
ชื่อช่อง API: entityStatus
|
|
แท็กติดตาม HTML ที่ต่อท้าย
|
ไม่บังคับ
|
ชื่อช่อง API: DFPTag
|
|
โค้ดการผสานรวม
|
ไม่บังคับ
|
ชื่อช่อง API: integrationCode
|
|
Notes
|
ไม่บังคับ
|
ชื่อช่อง API: หมายเหตุ
|
|
สถานะการตรวจสอบ
|
อ่านอย่างเดียว
|
ชื่อช่อง API: reviewStatus
|
|
ครีเอทีฟโฆษณา HTML5
ประเภทโฆษณา: CREATIVE_TYPE_STANDARD |
แหล่งที่มาโฮสติ้ง: HOSTING_SOURCE_HOSTED |
ชื่อ
|
จำเป็น
|
ชื่อช่อง API: displayName
|
|
ชิ้นงานครีเอทีฟโฆษณา
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_MAIN
|
|
สถานะ
|
จำเป็น
|
ชื่อช่อง API: entityStatus
|
|
รูปภาพสำรอง
|
ไม่บังคับ
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_BACKUP
|
|
URL ของหน้า Landing Page สำรอง
|
ไม่บังคับ
|
ชื่อช่อง API: exitEvents[].url
|
ออกจากประเภทเหตุการณ์: EXIT_EVENT_TYPE_BACKUP
|
|
ป้ายกำกับการออกจากการรายงานข้อมูลสำรอง
|
ไม่บังคับ
|
ชื่อช่อง API: exitEvents[].reportingName
|
ออกจากประเภทเหตุการณ์: EXIT_EVENT_TYPE_BACKUP
|
|
โหลดรูปภาพแบบ Polite
|
ไม่บังคับ
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_POLITE_LOAD
|
|
การออก
|
จำเป็น
|
ชื่อช่อง API: exitEvents[]
|
ประเภทเหตุการณ์การออก: EXIT_EVENT_TYPE_DEFAULT
|
|
ตัวนับ
|
ไม่บังคับ
|
ชื่อช่อง API: เหตุการณ์โต้แย้ง[]
|
|
ตัวจับเวลา
|
ไม่บังคับ
|
ชื่อช่อง API: timerEvents[]
|
|
แท็กติดตาม HTML ที่ต่อท้าย
|
ไม่บังคับ
|
ชื่อช่อง API: DFPTag
|
|
โค้ดการผสานรวม
|
ไม่บังคับ
|
ชื่อช่อง API: integrationCode
|
|
Notes
|
ไม่บังคับ
|
ชื่อช่อง API: หมายเหตุ
|
|
สถานะการตรวจสอบ
|
ไม่บังคับ
|
ชื่อช่อง API: reviewStatus
|
|
ครีเอทีฟโฆษณาแบบดิสเพลย์ของบุคคลที่สาม
ประเภทโฆษณา: CREATIVE_TYPE_STANDARD |
แหล่งที่มาโฮสติ้ง: HOSTING_SOURCE_THIRD_PARTY |
ชื่อ
|
จำเป็น
|
ชื่อช่อง API: displayName
|
|
สถานะ
|
จำเป็น
|
ชื่อช่อง API: entityStatus
|
|
ขนาด
|
จำเป็น
|
ชื่อช่อง API: มิติข้อมูล
|
|
URL ของหน้า Landing Page
|
จำเป็น
|
ชื่อช่อง API: exitEvents[].url
|
ประเภทเหตุการณ์การออก: EXIT_EVENT_TYPE_DEFAULT
|
|
ต้องใช้ MRAID
|
ไม่บังคับ
|
ชื่อช่อง API: requiredMraid
|
|
ต้องใช้ HTML5
|
ไม่บังคับ
|
ชื่อช่อง API: requiredHtml5
|
|
แท็กจากบุคคลที่สาม
|
จำเป็น
|
ชื่อช่อง API: thirdPartyTag
|
|
ต้องใช้คำสั่ง ping สำหรับการระบุแหล่งที่มา
|
ไม่บังคับ
|
ชื่อช่อง API: requiredPingForAttribution
|
|
โค้ดการผสานรวม
|
ไม่บังคับ
|
ชื่อช่อง API: integrationCode
|
|
Notes
|
ไม่บังคับ
|
ชื่อช่อง API: หมายเหตุ
|
|
สถานะการตรวจสอบ
|
อ่านอย่างเดียว
|
ชื่อช่อง API: reviewStatus
|
|
โฆษณาที่ขยายได้ของบุคคลที่สาม
ประเภทโฆษณา: CREATIVE_TYPE_EXPANDABLE |
แหล่งที่มาโฮสติ้ง: HOSTING_SOURCE_THIRD_PARTY |
ชื่อ
|
จำเป็น
|
ชื่อช่อง API: displayName
|
|
สถานะ
|
จำเป็น
|
ชื่อช่อง API: entityStatus
|
|
ขนาด
|
จำเป็น
|
ชื่อช่อง API: มิติข้อมูล
|
|
URL ของหน้า Landing Page
|
จำเป็น
|
ชื่อช่อง API: exitEvents[].url
|
ประเภทเหตุการณ์การออก: EXIT_EVENT_TYPE_DEFAULT
|
|
ต้องใช้ MRAID
|
ไม่บังคับ
|
ชื่อช่อง API: requiredMraid
|
|
ต้องใช้ HTML5
|
ไม่บังคับ
|
ชื่อช่อง API: requiredHtml5
|
|
ทิศทางการขยาย
|
จำเป็น
|
ชื่อฟิลด์ API: expandDirection
|
|
ขยายเมื่อวางเหนือ
|
ไม่บังคับ
|
ชื่อช่อง API:expandOnHover
|
|
บุคคลที่สาม
|
จำเป็น
|
ชื่อช่อง API: thirdPartyTag
|
|
ต้องใช้คำสั่ง ping สำหรับการระบุแหล่งที่มา
|
ไม่บังคับ
|
ชื่อช่อง API: requiredPingForAttribution
|
|
โค้ดการผสานรวม
|
ไม่บังคับ
|
ชื่อช่อง API: integrationCode
|
|
Notes
|
ไม่บังคับ
|
ชื่อช่อง API: หมายเหตุ
|
|
สถานะการตรวจสอบ
|
อ่านอย่างเดียว
|
ชื่อช่อง API: reviewStatus
|
|
ครีเอทีฟโฆษณาวิดีโอของบุคคลที่สาม
ประเภทโฆษณา: CREATIVE_TYPE_VIDEO |
แหล่งที่มาโฮสติ้ง: HOSTING_SOURCE_THIRD_PARTY |
ชื่อ
|
จำเป็น
|
ชื่อช่อง API: displayName
|
|
สถานะ
|
จำเป็น
|
ชื่อช่อง API: entityStatus
|
|
URL ของแท็ก VAST
|
จำเป็น
|
ชื่อช่อง API: vastTagUrl
|
|
VPAID
|
อ่านอย่างเดียว
|
ชื่อช่อง API: vpaid
|
|
วิดีโอ HTML5
|
อ่านอย่างเดียว
|
ชื่อช่อง API: html5Video
|
|
ต้องใช้คำสั่ง ping สำหรับการระบุแหล่งที่มา
|
ไม่บังคับ
|
ชื่อช่อง API: requiredPingForAttribution
|
|
โค้ดการผสานรวม
|
ไม่บังคับ
|
ชื่อช่อง API: integrationCode
|
|
Notes
|
ไม่บังคับ
|
ชื่อช่อง API: หมายเหตุ
|
|
สถานะการตรวจสอบ
|
อ่านอย่างเดียว
|
ชื่อช่อง API: reviewStatus
|
|
ครีเอทีฟโฆษณาเสียงของบุคคลที่สาม
ประเภทโฆษณา: CREATIVE_TYPE_AUDIO |
แหล่งที่มาโฮสติ้ง: HOSTING_SOURCE_THIRD_PARTY |
ชื่อ
|
จำเป็น
|
ชื่อช่อง API: displayName
|
|
สถานะ
|
จำเป็น
|
ชื่อช่อง API: entityStatus
|
|
URL ของแท็ก VAST
|
จำเป็น
|
ชื่อช่อง API: vastTagUrl
|
|
ต้องใช้คำสั่ง ping สำหรับการระบุแหล่งที่มา
|
ไม่บังคับ
|
ชื่อช่อง API: requiredPingForAttribution
|
|
โค้ดการผสานรวม
|
ไม่บังคับ
|
ชื่อช่อง API: integrationCode
|
|
Notes
|
ไม่บังคับ
|
ชื่อช่อง API: หมายเหตุ
|
|
สถานะการตรวจสอบ
|
อ่านอย่างเดียว
|
ชื่อช่อง API: reviewStatus
|
|
โฆษณาวีดีโอ
ประเภทโฆษณา: CREATIVE_TYPE_VIDEO |
แหล่งที่มาโฮสติ้ง: HOSTING_SOURCE_HOSTED |
ชื่อ
|
จำเป็น
|
ชื่อช่อง API: displayName
|
|
สถานะ
|
จำเป็น
|
ชื่อช่อง API: entityStatus
|
|
ไฟล์ต้นฉบับ
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_MAIN
|
|
URL ของหน้า Landing Page
|
จำเป็น
|
ชื่อช่อง API: exitEvents[].url
|
ประเภทเหตุการณ์การออก: EXIT_EVENT_TYPE_DEFAULT
|
|
รวมปุ่มข้าม
|
ไม่บังคับ
|
ชื่อช่อง API: ข้ามได้
|
|
ระยะเวลาเล่นวิดีโอก่อนให้กดข้าม
|
ไม่บังคับ
|
ชื่อช่อง API: joinOffset
|
|
ระยะเวลาก่อนเริ่มคิดค่าดูวิดีโอ
|
ไม่บังคับ
|
ชื่อช่อง API: progressOffset
|
|
รหัสโฆษณาสากล
|
ไม่บังคับ
|
ชื่อช่อง API: UniversalAdId
|
|
OBA
|
ไม่บังคับ
|
ชื่อช่อง API: obaIcon
|
|
ครีเอทีฟโฆษณาที่แสดงร่วม
|
ไม่บังคับ
|
ชื่อช่อง API:companionCreativeIds
|
|
ไฟล์ที่แสดง
|
อ่านอย่างเดียว
|
ชื่อช่อง API: การแปลง
|
|
URL ของบุคคลที่สาม
|
ไม่บังคับ
|
ชื่อช่อง API: thirdPartyUrls
|
|
โค้ดการผสานรวม
|
ไม่บังคับ
|
ชื่อช่อง API: integrationCode
|
|
Notes
|
ไม่บังคับ
|
ชื่อช่อง API: หมายเหตุ
|
|
สถานะการตรวจสอบ
|
อ่านอย่างเดียว
|
ชื่อช่อง API: reviewStatus
|
|
ครีเอทีฟโฆษณาเสียง
ประเภทโฆษณา: CREATIVE_TYPE_AUDIO |
แหล่งที่มาโฮสติ้ง: HOSTING_SOURCE_HOSTED |
ชื่อ
|
จำเป็น
|
ชื่อช่อง API: displayName
|
|
สถานะ
|
จำเป็น
|
ชื่อช่อง API: entityStatus
|
|
ไฟล์ต้นฉบับ
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_MAIN
|
|
URL ของหน้า Landing Page
|
จำเป็น
|
ชื่อช่อง API: exitEvents[].url
|
ประเภทเหตุการณ์การออก: EXIT_EVENT_TYPE_DEFAULT
|
|
เนื้อหาที่แสดงร่วมกัน (อัปโหลดหรือกำหนด)
|
จำเป็น
|
ชื่อช่อง API:companionCreativeIds
|
|
ชื่อไฟล์ที่แสดง
|
อ่านอย่างเดียว
|
ชื่อช่อง API: transcodes[].name
|
|
ประเภทไฟล์ที่แสดง
|
อ่านอย่างเดียว
|
ชื่อช่อง API: transcodes[].mimeType
|
|
การแสดงผลอัตราบิตของเสียงในไฟล์
|
อ่านอย่างเดียว
|
ชื่อช่อง API: transcodes[].audioBitRateKbps
|
|
อัตราการสุ่มตัวอย่างเสียงของไฟล์ที่แสดง
|
อ่านอย่างเดียว
|
ชื่อช่อง API: transcodes[].audioSampleRateHz
|
|
URL ของบุคคลที่สาม
|
ไม่บังคับ
|
ชื่อช่อง API: thirdPartyUrls
|
|
โค้ดการผสานรวม
|
ไม่บังคับ
|
ชื่อช่อง API: integrationCode
|
|
Notes
|
ไม่บังคับ
|
ชื่อช่อง API: หมายเหตุ
|
|
สถานะการตรวจสอบ
|
อ่านอย่างเดียว
|
ชื่อช่อง API: reviewStatus
|
|
ครีเอทีฟโฆษณาดิสเพลย์แบบเนทีฟ
ประเภทโฆษณา: CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_SQUARE |
แหล่งที่มาโฮสติ้ง: HOSTING_SOURCE_HOSTED |
ชื่อ
|
จำเป็น
|
ชื่อช่อง API: displayName
|
|
สถานะ
|
จำเป็น
|
ชื่อช่อง API: entityStatus
|
|
โลโก้
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_ICON
|
|
รูปภาพ / รูปภาพสี่เหลี่ยมจัตุรัส
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_MAIN
|
|
บรรทัดแรก
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_HEADLINE
|
|
บรรทัดแรกแบบยาว
|
ไม่บังคับ
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_LONG_HEADLINE
|
|
ข้อความเนื้อหา
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_BODY
|
|
ข้อความเนื้อหายาว
|
ไม่บังคับ
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_LONG_BODY
|
|
URL ของหน้า Landing Page
|
จำเป็น
|
ชื่อช่อง API: exitEvents[].url
|
ประเภทเหตุการณ์การออก: EXIT_EVENT_TYPE_DEFAULT
|
|
URL คำอธิบายภาพ
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_CAPTION_URL
|
|
คำกระตุ้นให้ดำเนินการ (Call-To-Action)
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_CALL_TO_ACTION
|
|
โฆษณาเพื่อการติดตามของ Campaign Manager 360
|
ไม่บังคับ
|
ชื่อช่อง API: cmTrackingAd
|
|
URL ติดตามการแสดงผล 1
|
ไม่บังคับ
|
ชื่อช่อง API: TrackingUrls[]
|
|
URL ติดตามการแสดงผล 2
|
ไม่บังคับ
|
ชื่อช่อง API: TrackingUrls[]
|
|
URL ติดตาม JavaScript
|
ไม่บังคับ
|
ชื่อช่อง API: jsTrackerUrl
|
|
โค้ดการผสานรวม
|
ไม่บังคับ
|
ชื่อช่อง API: integrationCode
|
|
Notes
|
ไม่บังคับ
|
ชื่อช่อง API: หมายเหตุ
|
|
สถานะการตรวจสอบ
|
อ่านอย่างเดียว
|
ชื่อช่อง API: reviewStatus
|
|
ครีเอทีฟโฆษณาวิดีโอเนทีฟ
ประเภทโฆษณา: CREATIVE_TYPE_NATIVE_VIDEO |
แหล่งที่มาโฮสติ้ง: HOSTING_SOURCE_HOSTED |
ชื่อ
|
จำเป็น
|
ชื่อช่อง API: displayName
|
|
สถานะ
|
จำเป็น
|
ชื่อช่อง API: entityStatus
|
|
โลโก้
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_ICON
|
|
วิดีโอ
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_MAIN
|
|
ภาพหน้าปก
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_COVER_IMAGE
|
|
ชื่อผู้ลงโฆษณา
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_ADVERTISER_NAME
|
|
บรรทัดแรก
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_HEADLINE
|
|
บรรทัดแรกแบบยาว
|
ไม่บังคับ
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_LONG_HEADLINE
|
|
ข้อความเนื้อหา
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_BODY
|
|
ข้อความเนื้อหายาว
|
ไม่บังคับ
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_LONG_BODY
|
|
URL ของหน้า Landing Page
|
จำเป็น
|
ชื่อช่อง API: exitEvents[].url
|
ประเภทเหตุการณ์การออก: EXIT_EVENT_TYPE_DEFAULT
|
|
URL คำอธิบายภาพ
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_CAPTION_URL
|
|
คำกระตุ้นให้ดำเนินการ (Call-To-Action)
|
จำเป็น
|
ชื่อช่อง API: เนื้อหา
|
บทบาทเนื้อหา: ASSET_ROLE_CALL_TO_ACTION
|
|
URL ติดตามการแสดงผล 1
|
ไม่บังคับ
|
ชื่อช่อง API: TrackingUrls[]
|
|
URL ติดตามการแสดงผล 2
|
ไม่บังคับ
|
ชื่อช่อง API: TrackingUrls[]
|
|
URL ติดตาม JavaScript
|
ไม่บังคับ
|
ชื่อช่อง API: jsTrackerUrl
|
|
โค้ดการผสานรวม
|
ไม่บังคับ
|
ชื่อช่อง API: integrationCode
|
|
Notes
|
ไม่บังคับ
|
ชื่อช่อง API: หมายเหตุ
|
|
สถานะการตรวจสอบ
|
อ่านอย่างเดียว
|
ชื่อช่อง API: reviewStatus
|
|
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2023-12-01 UTC
[null,null,["อัปเดตล่าสุด 2023-12-01 UTC"],[[["This document provides a comprehensive mapping of UI fields to their corresponding API fields for various creative types, including Standard Image, HTML5, Third-Party Display, Third-Party Expandable, Third-Party Video, Third-Party Audio, Video, Audio, Native Display, and Native Video."],["Each creative type has a specific set of required and optional fields, along with their API field names and any further specifications for asset roles or exit event types."],["Creative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names."],["Campaign Manager 360 tracking ad can optionally be included using the `cmTrackingAd` API field."],["This mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system."]]],[]]