- แหล่งข้อมูล: ครีเอทีฟโฆษณา
- HostingSource
- CreativeAttribute
- ReviewStatusInfo
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus
- PublisherReviewStatus
- AssetAssociation
- ชิ้นงาน
- AssetRole
- ExitEvent
- ExitEventType
- TimerEvent
- CounterEvent
- AudioVideoOffset
- UniversalAdId
- UniversalAdRegistry
- ThirdPartyUrl
- ThirdPartyUrlType
- การแปลง
- CmTrackingAd
- ObaIcon
- ObaIconPosition
- ExpandingDirection
- เมธอด
ทรัพยากร: ครีเอทีฟโฆษณา
ครีเอทีฟโฆษณาเดียว
การแสดง JSON |
---|
{ "name": string, "advertiserId": string, "creativeId": string, "cmPlacementId": string, "displayName": string, "entityStatus": enum ( |
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ชื่อทรัพยากรของครีเอทีฟโฆษณา |
advertiserId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่เป็นเจ้าของครีเอทีฟโฆษณา |
creativeId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของครีเอทีฟโฆษณา กำหนดโดยระบบ |
cmPlacementId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของตำแหน่ง Campaign Manager 360 ที่เชื่อมโยงกับครีเอทีฟโฆษณา ช่องนี้ใช้ได้กับครีเอทีฟโฆษณาที่ซิงค์จาก Campaign Manager เท่านั้น |
displayName |
ต้องระบุ ชื่อที่แสดงของครีเอทีฟโฆษณา ต้องเป็น UTF-8 ที่เข้ารหัสด้วยขนาดสูงสุด 240 ไบต์ |
entityStatus |
ต้องระบุ ควบคุมว่าครีเอทีฟโฆษณาจะแสดงได้หรือไม่ ค่าที่ยอมรับมีดังนี้
|
updateTime |
เอาต์พุตเท่านั้น การประทับเวลาเมื่อมีการอัปเดตครีเอทีฟโฆษณาครั้งล่าสุด ไม่ว่าจะโดยผู้ใช้หรือระบบ (เช่น การตรวจสอบครีเอทีฟโฆษณา) กำหนดโดยระบบ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
createTime |
เอาต์พุตเท่านั้น การประทับเวลาที่สร้างโฆษณา กำหนดโดยระบบ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
creativeType |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเภทของครีเอทีฟโฆษณา |
hostingSource |
ต้องระบุ ระบุตำแหน่งที่โฮสต์ครีเอทีฟโฆษณา |
dynamic |
เอาต์พุตเท่านั้น ระบุว่าครีเอทีฟโฆษณาเป็นแบบไดนามิกหรือไม่ |
dimensions |
ต้องระบุ มิติข้อมูลหลักของครีเอทีฟโฆษณา ใช้ได้กับครีเอทีฟโฆษณาทุกประเภท ค่าของ
|
additionalDimensions[] |
มิติข้อมูลเพิ่มเติม ใช้ได้เมื่อ
หากระบุช่องนี้ ต้องระบุทั้ง |
mediaDuration |
เอาต์พุตเท่านั้น ระยะเวลาสื่อของครีเอทีฟโฆษณา ใช้ได้เมื่อ
ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย " |
creativeAttributes[] |
เอาต์พุตเท่านั้น รายการแอตทริบิวต์ของครีเอทีฟโฆษณาที่ระบบสร้างขึ้น |
reviewStatus |
เอาต์พุตเท่านั้น สถานะปัจจุบันของขั้นตอนการตรวจสอบครีเอทีฟโฆษณา |
assets[] |
ต้องระบุ เนื้อหาที่เชื่อมโยงกับครีเอทีฟโฆษณานี้ |
exitEvents[] |
ต้องระบุ เหตุการณ์การออกสำหรับโฆษณานี้ การออก (หรือที่เรียกว่าแท็กคลิก) คือบริเวณใดๆ ในครีเอทีฟโฆษณาที่ผู้ใช้สามารถคลิกหรือแตะเพื่อเปิดหน้า Landing Page ของผู้ลงโฆษณาได้ ครีเอทีฟโฆษณาทุกชิ้นต้องมีทางออกอย่างน้อย 1 จุด คุณเพิ่มการออกลงในครีเอทีฟโฆษณาได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้
|
timerEvents[] |
เหตุการณ์ที่กำหนดเองตัวจับเวลาสำหรับโฆษณาสื่อสมบูรณ์ ตัวจับเวลาจะติดตามเวลาระหว่างที่ผู้ใช้ดูและโต้ตอบกับส่วนที่ระบุของโฆษณาสื่อสมบูรณ์ ครีเอทีฟโฆษณา 1 รายการอาจมีเหตุการณ์ของเครื่องควบคุมเวลาหลายเหตุการณ์ แต่ละเหตุการณ์มีการจับเวลาแยกกัน ปล่อยว่างไว้หรือไม่ได้ตั้งค่าสำหรับครีเอทีฟโฆษณาที่มีชิ้นงานรูปภาพเท่านั้น |
counterEvents[] |
เหตุการณ์ตัวนับสำหรับโฆษณาสื่อสมบูรณ์ ตัวนับจะติดตามจำนวนครั้งที่ผู้ใช้โต้ตอบกับส่วนใดๆ ของโฆษณาสื่อสมบูรณ์ด้วยวิธีการที่ระบุ (เช่น การวางเมาส์บนส่วนนั้น การเลื่อนเมาส์ออกจากส่วนนั้น การคลิก การแตะ การโหลดข้อมูล การป้อนข้อมูลผ่านแป้นพิมพ์ เป็นต้น) ระบบจะบันทึกเหตุการณ์ทั้งหมดในครีเอทีฟโฆษณาเป็นตัวนับได้ ปล่อยว่างไว้หรือไม่ได้ตั้งค่าสำหรับครีเอทีฟโฆษณาที่มีชิ้นงานรูปภาพเท่านั้น |
appendedTag |
แท็กติดตาม HTML ของบุคคลที่สามที่จะต่อท้ายแท็กครีเอทีฟโฆษณา |
integrationCode |
ข้อมูลรหัสที่ใช้เพื่อลิงก์ครีเอทีฟโฆษณานี้กับระบบภายนอก ต้องเป็น UTF-8 ที่เข้ารหัสโดยมีความยาวไม่เกิน 10,000 อักขระ |
notes |
หมายเหตุผู้ใช้สำหรับโฆษณานี้ ต้องเป็น UTF-8 ที่เข้ารหัสโดยมีความยาวไม่เกิน 20,000 อักขระ |
iasCampaignMonitoring |
ระบุว่ามีการเปิดใช้การตรวจสอบแคมเปญ Integral Ad Science (IAS) หรือไม่ หากต้องการเปิดใช้การตั้งค่านี้สำหรับครีเอทีฟโฆษณา ให้ตรวจสอบว่ามีการตั้งค่า |
companionCreativeIds[] |
รหัสของครีเอทีฟโฆษณาที่แสดงร่วมกันสำหรับครีเอทีฟโฆษณาวิดีโอ คุณกําหนดครีเอทีฟโฆษณา Display ที่มีอยู่ (พร้อมชิ้นงานรูปภาพหรือ HTML5) เพื่อแสดงรอบๆ โปรแกรมเล่นวิดีโอของผู้เผยแพร่โฆษณาได้ วิดีโอที่แสดงร่วมกันจะแสดงรอบๆ โปรแกรมเล่นวิดีโอขณะที่วิดีโอกำลังเล่น และจะยังคงอยู่หลังจากวิดีโอเล่นจบแล้ว ครีเอทีฟโฆษณามี ช่องนี้ใช้ได้กับ
|
skippable |
ผู้ใช้เลือกได้ว่าจะข้ามครีเอทีฟโฆษณาวิดีโอหรือไม่ ช่องนี้ใช้ได้กับ
|
skipOffset |
ระยะเวลาเล่นวิดีโอก่อนที่ปุ่มข้ามจะปรากฏ ต้องระบุข้อมูลในช่องนี้เมื่อ ช่องนี้ใช้ได้กับ
|
progressOffset |
ระยะเวลาการเล่นวิดีโอก่อนนับจำนวนการดู ต้องระบุข้อมูลในช่องนี้เมื่อ ช่องนี้ใช้ได้กับ
|
universalAdId |
ไม่บังคับ ตัวระบุครีเอทีฟโฆษณาซึ่งไม่บังคับซึ่งบริษัทรับจดทะเบียนจะไม่ซ้ำกันในทุกแพลตฟอร์ม รหัสโฆษณาสากลเป็นส่วนหนึ่งของมาตรฐาน VAST 4.0 ซึ่งแก้ไขได้หลังจากสร้างโฆษณาแล้ว ช่องนี้ใช้ได้กับ
|
thirdPartyUrls[] |
ติดตาม URL จากบุคคลที่สามเพื่อติดตามการโต้ตอบกับครีเอทีฟโฆษณาวิดีโอ ช่องนี้ใช้ได้กับ
|
transcodes[] |
เอาต์พุตเท่านั้น การแปลงเสียง/วิดีโอ Display & Video 360 จะแปลงเนื้อหาหลักเป็นเวอร์ชันทางเลือกหลายๆ เวอร์ชันที่ใช้รูปแบบไฟล์ต่างกันหรือมีคุณสมบัติแตกต่างกัน (ความละเอียด อัตราบิตของเสียง และอัตราบิตของวิดีโอ) แต่ละรายการออกแบบมาสำหรับโปรแกรมเล่นวิดีโอหรือแบนด์วิดท์ที่เจาะจง การแปลงเหล่านี้ช่วยให้ระบบของผู้เผยแพร่โฆษณามีตัวเลือกมากขึ้นสำหรับการแสดงผลแต่ละครั้งในวิดีโอของคุณ และช่วยให้มั่นใจได้ว่าไฟล์ที่เหมาะสมจะแสดงตามการเชื่อมต่อและขนาดหน้าจอของผู้ดู ช่องนี้รองรับเฉพาะใน
|
trackerUrls[] |
URL ติดตามสำหรับผู้ให้บริการวิเคราะห์หรือผู้ให้บริการเทคโนโลยีโฆษณาบุคคลที่สาม URL ต้องขึ้นต้นด้วย https (ยกเว้นในพื้นที่โฆษณาที่ไม่ต้องเป็นไปตามข้อกำหนด SSL) หากใช้มาโครใน URL ให้ใช้เฉพาะมาโครที่ Display & Video 360 รองรับเท่านั้น URL มาตรฐานเท่านั้น ไม่มีแท็ก IMG หรือ script ช่องนี้เขียนได้ใน
|
jsTrackerUrl |
URL การวัดผลของ JavaScript จากผู้ให้บริการยืนยันที่เป็นบุคคลที่สามที่รองรับ (ComScore, DoubleVerify, IAS, Moat) ไม่รองรับแท็กสคริปต์ HTML ช่องนี้เขียนได้ใน
|
cmTrackingAd |
โฆษณาเพื่อการติดตามของ Campaign Manager 360 ที่เชื่อมโยงกับครีเอทีฟโฆษณา ไม่บังคับสำหรับ
เอาต์พุตเฉพาะสำหรับกรณีอื่นๆ |
obaIcon |
ระบุไอคอน OBA สำหรับครีเอทีฟโฆษณาวิดีโอ ช่องนี้รองรับเฉพาะใน
|
thirdPartyTag |
ไม่บังคับ แท็กของบุคคลที่สามเดิมที่ใช้สำหรับครีเอทีฟโฆษณา ต้องระบุและใช้ได้สำหรับโฆษณาแท็กของบุคคลที่สามเท่านั้น ครีเอทีฟโฆษณาแท็กของบุคคลที่สามเป็นครีเอทีฟโฆษณาที่มี
รวมกับ
|
requireMraid |
ไม่บังคับ ระบุว่าโฆษณาต้องใช้ MRAID (ระบบ Mobile Rich Media Ad Interface Definitions) ตั้งค่านี้หากครีเอทีฟโฆษณาใช้ท่าทางสัมผัสบนอุปกรณ์เคลื่อนที่สำหรับการโต้ตอบ เช่น การปัดหรือการแตะ ไม่บังคับและใช้ได้เฉพาะสำหรับโฆษณาแท็กของบุคคลที่สาม ครีเอทีฟโฆษณาแท็กของบุคคลที่สามเป็นครีเอทีฟโฆษณาที่มี
รวมกับ
|
requireHtml5 |
ไม่บังคับ บ่งบอกว่าครีเอทีฟโฆษณาใช้ HTML5 เพื่อแสดงผลอย่างถูกต้อง ไม่บังคับและใช้ได้เฉพาะสำหรับโฆษณาแท็กของบุคคลที่สาม ครีเอทีฟโฆษณาแท็กของบุคคลที่สามเป็นครีเอทีฟโฆษณาที่มี
รวมกับ
|
requirePingForAttribution |
ไม่บังคับ ระบุว่าครีเอทีฟโฆษณาจะรอคำสั่ง ping สำหรับการระบุแหล่งที่มา ใช้ได้เมื่อใช้โฆษณาเพื่อการติดตามของ Campaign Manager 360 ที่มีพารามิเตอร์เซิร์ฟเวอร์โฆษณาของบุคคลที่สามและมาโคร ${DC_DBM_TOKEN} เท่านั้น ไม่บังคับและใช้ได้กับครีเอทีฟโฆษณาแบบแท็กของบุคคลที่สามหรือครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเท่านั้น ครีเอทีฟโฆษณาแท็กของบุคคลที่สามเป็นครีเอทีฟโฆษณาที่มี
รวมกับ
ครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเป็นครีเอทีฟโฆษณาที่มี
รวมกับ
|
expandingDirection |
ไม่บังคับ ระบุทิศทางการขยายของครีเอทีฟโฆษณา ต้องระบุและใช้ได้เฉพาะกับโฆษณาที่ขยายได้ของบุคคลที่สามเท่านั้น ครีเอทีฟโฆษณาแบบขยายได้ของบุคคลที่สามคือครีเอทีฟโฆษณาที่มีแหล่งที่มาโฮสติ้งต่อไปนี้
รวมกับ
|
expandOnHover |
ไม่บังคับ บ่งบอกว่าครีเอทีฟโฆษณาจะขยายโดยอัตโนมัติเมื่อวางเมาส์เหนือโฆษณา ไม่บังคับและใช้ได้เฉพาะสำหรับโฆษณาที่ขยายได้ของบุคคลที่สาม ครีเอทีฟโฆษณาแบบขยายได้ของบุคคลที่สามคือครีเอทีฟโฆษณาที่มีแหล่งที่มาโฮสติ้งต่อไปนี้
รวมกับ
|
vastTagUrl |
ไม่บังคับ URL ของแท็ก VAST สำหรับครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สาม ต้องใช้และใช้ได้สำหรับครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเท่านั้น ครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเป็นครีเอทีฟโฆษณาที่มี
รวมกับ
|
vpaid |
เอาต์พุตเท่านั้น ระบุว่าครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามต้องใช้ VPAID (อินเทอร์เฟซโฆษณาโปรแกรมเล่นวิดีโอดิจิทัล) เอาต์พุตเท่านั้นและใช้ได้กับครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเท่านั้น ครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเป็นครีเอทีฟโฆษณาที่มี
รวมกับ
|
html5Video |
เอาต์พุตเท่านั้น ระบุว่าครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามต้องการการรองรับวิดีโอ HTML5 เอาต์พุตเท่านั้นและใช้ได้กับครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเท่านั้น ครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเป็นครีเอทีฟโฆษณาที่มี
รวมกับ
|
lineItemIds[] |
เอาต์พุตเท่านั้น รหัสของรายการโฆษณาที่เชื่อมโยงกับครีเอทีฟโฆษณานี้ หากต้องการเชื่อมโยงครีเอทีฟโฆษณากับรายการโฆษณา ให้ใช้ |
mp3Audio |
เอาต์พุตเท่านั้น บ่งบอกว่าครีเอทีฟโฆษณาเสียงของบุคคลที่สามรองรับ MP3 เอาต์พุตเท่านั้นและใช้ได้กับครีเอทีฟโฆษณาเสียงของบุคคลที่สามเท่านั้น ครีเอทีฟโฆษณาเสียงของบุคคลที่สามเป็นครีเอทีฟโฆษณาที่มี
รวมกับ
|
oggAudio |
เอาต์พุตเท่านั้น บ่งบอกว่าครีเอทีฟโฆษณาเสียงของบุคคลที่สามรองรับ OGG เอาต์พุตเท่านั้นและใช้ได้กับครีเอทีฟโฆษณาเสียงของบุคคลที่สามเท่านั้น ครีเอทีฟโฆษณาเสียงของบุคคลที่สามเป็นครีเอทีฟโฆษณาที่มี
รวมกับ
|
HostingSource
แหล่งที่มาโฮสติ้งที่เป็นไปได้สำหรับครีเอทีฟโฆษณา ระบุตำแหน่งที่สร้างและโฮสต์ครีเอทีฟโฆษณา
Enum | |
---|---|
HOSTING_SOURCE_UNSPECIFIED |
ไม่ได้ระบุแหล่งที่มาของโฮสติ้งหรือไม่รู้จักในเวอร์ชันนี้ |
HOSTING_SOURCE_CM |
ครีเอทีฟโฆษณาที่ซิงค์จาก Campaign Manager 360 ระบบไม่รองรับวิธีการสร้างและอัปเดตสำหรับประเภทโฮสติ้งนี้ |
HOSTING_SOURCE_THIRD_PARTY |
ครีเอทีฟโฆษณาที่โฮสต์โดยเซิร์ฟเวอร์โฆษณาของบุคคลที่สาม (3PAS) ระบบรองรับวิธีการสร้างและอัปเดตโฮสติ้งประเภทนี้หาก
|
HOSTING_SOURCE_HOSTED |
ครีเอทีฟโฆษณาที่สร้างใน DV360 และโฮสต์โดย Campaign Manager 360 ระบบรองรับวิธีการสร้างและอัปเดตโฮสติ้งประเภทนี้หาก
|
HOSTING_SOURCE_RICH_MEDIA |
ครีเอทีฟโฆษณาแบบริชมีเดียที่สร้างใน Studio และโฮสต์โดย Campaign Manager 360 ระบบไม่รองรับวิธีการสร้างและอัปเดตสำหรับประเภทโฮสติ้งนี้ |
CreativeAttribute
แอตทริบิวต์ที่เป็นไปได้ของโฆษณา
Enum | |
---|---|
CREATIVE_ATTRIBUTE_UNSPECIFIED |
ไม่ได้ระบุแอตทริบิวต์โฆษณาหรือไม่รู้จักในเวอร์ชันนี้ |
CREATIVE_ATTRIBUTE_VAST |
ครีเอทีฟโฆษณานี้เป็นครีเอทีฟโฆษณา VAST |
CREATIVE_ATTRIBUTE_VPAID_LINEAR |
ครีเอทีฟโฆษณานี้เป็นครีเอทีฟโฆษณา VPAID แบบเชิงเส้น |
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR |
ครีเอทีฟโฆษณานี้เป็นครีเอทีฟโฆษณา VPAID แบบไม่ใช่เชิงเส้น |
ReviewStatusInfo
สถานะการตรวจสอบของครีเอทีฟโฆษณา
การแสดง JSON |
---|
{ "approvalStatus": enum ( |
ช่อง | |
---|---|
approvalStatus |
แสดงการอนุมัติเบื้องต้นที่จำเป็นสำหรับครีเอทีฟโฆษณาเพื่อเริ่มแสดง สรุปของ |
creativeAndLandingPageReviewStatus |
สถานะการตรวจสอบครีเอทีฟโฆษณาและหน้า Landing Page ของครีเอทีฟโฆษณา |
contentAndPolicyReviewStatus |
สถานะการตรวจสอบเนื้อหาและนโยบายของครีเอทีฟโฆษณา |
exchangeReviewStatuses[] |
แลกเปลี่ยนสถานะการตรวจสอบครีเอทีฟโฆษณา |
publisherReviewStatuses[] |
สถานะการตรวจสอบของผู้เผยแพร่โฆษณาสำหรับครีเอทีฟโฆษณา |
ApprovalStatus
ประเภทสถานะการอนุมัติที่เป็นไปได้ เป็นข้อมูลสรุปของ creativeAndLandingPageReviewStatus
และ contentAndPolicyReviewStatus
Enum | |
---|---|
APPROVAL_STATUS_UNSPECIFIED |
ไม่ได้ระบุค่าประเภทหรือไม่รู้จักในเวอร์ชันนี้ |
APPROVAL_STATUS_PENDING_NOT_SERVABLE |
ครีเอทีฟโฆษณายังอยู่ระหว่างตรวจทานและแสดงไม่ได้ |
APPROVAL_STATUS_PENDING_SERVABLE |
ครีเอทีฟโฆษณาผ่านการตรวจสอบครีเอทีฟโฆษณาและหน้า Landing Page แล้ว และแสดงได้ แต่กำลังรอการตรวจสอบเนื้อหาและนโยบายเพิ่มเติม |
APPROVAL_STATUS_APPROVED_SERVABLE |
การตรวจสอบทั้งครีเอทีฟโฆษณาและหน้า Landing Page รวมถึงการตรวจสอบเนื้อหาและการตรวจสอบนโยบายได้รับอนุมัติแล้ว ครีเอทีฟโฆษณาแสดงได้ |
APPROVAL_STATUS_REJECTED_NOT_SERVABLE |
ครีเอทีฟโฆษณามีปัญหาซึ่งต้องได้รับการแก้ไขก่อนจึงจะแสดงได้ |
ReviewStatus
ประเภทสถานะการตรวจสอบที่เป็นไปได้
Enum | |
---|---|
REVIEW_STATUS_UNSPECIFIED |
ไม่ได้ระบุค่าประเภทหรือไม่รู้จักในเวอร์ชันนี้ |
REVIEW_STATUS_APPROVED |
ครีเอทีฟโฆษณาได้รับอนุมัติแล้ว |
REVIEW_STATUS_REJECTED |
ครีเอทีฟโฆษณาถูกปฏิเสธ |
REVIEW_STATUS_PENDING |
ครีเอทีฟโฆษณากำลังรอการตรวจสอบ |
ExchangeReviewStatus
แลกเปลี่ยนสถานะการตรวจสอบครีเอทีฟโฆษณา
การแสดง JSON |
---|
{ "exchange": enum ( |
ช่อง | |
---|---|
exchange |
Exchange ที่ตรวจสอบครีเอทีฟโฆษณา |
status |
สถานะของการตรวจสอบ Exchange |
PublisherReviewStatus
สถานะการตรวจสอบครีเอทีฟโฆษณาโดยผู้เผยแพร่โฆษณา
การแสดง JSON |
---|
{
"publisherName": string,
"status": enum ( |
ช่อง | |
---|---|
publisherName |
ผู้เผยแพร่โฆษณาที่ตรวจสอบครีเอทีฟโฆษณา |
status |
สถานะการตรวจสอบของผู้เผยแพร่โฆษณา |
AssetAssociation
การเชื่อมโยงเนื้อหาของครีเอทีฟโฆษณา
การแสดง JSON |
---|
{ "asset": { object ( |
ช่อง | |
---|---|
asset |
เนื้อหาที่เกี่ยวข้อง |
role |
บทบาทของเนื้อหานี้สำหรับครีเอทีฟโฆษณา |
ชิ้นงาน
เนื้อหาเดียว
การแสดง JSON |
---|
{ "mediaId": string, "content": string } |
ช่อง | |
---|---|
mediaId |
รหัสสื่อของเนื้อหาที่อัปโหลด นี่คือตัวระบุที่ไม่ซ้ำกันสำหรับเนื้อหา รหัสนี้สามารถส่งผ่านไปยังการเรียก API อื่นๆ เช่น พื้นที่รหัสสื่อที่อัปเดตเมื่อวันที่ 5 เมษายน 2023 อัปเดตรหัสสื่อที่แคชไว้ก่อน 5 เมษายน 2023 โดยการดึงข้อมูลรหัสสื่อใหม่จากทรัพยากรครีเอทีฟโฆษณาที่เกี่ยวข้อง หรืออัปโหลดชิ้นงานอีกครั้ง |
content |
เนื้อหา สำหรับเนื้อหาที่อัปโหลด เนื้อหาคือเส้นทางการแสดงโฆษณา |
AssetRole
บทบาทของเนื้อหานี้สำหรับครีเอทีฟโฆษณา
Enum | |
---|---|
ASSET_ROLE_UNSPECIFIED |
ไม่ได้ระบุบทบาทเนื้อหาหรือไม่รู้จักในเวอร์ชันนี้ |
ASSET_ROLE_MAIN |
เนื้อหาคือเนื้อหาหลักของครีเอทีฟโฆษณา |
ASSET_ROLE_BACKUP |
องค์ประกอบนี้เป็นเนื้อหาสำรองของโฆษณา |
ASSET_ROLE_POLITE_LOAD |
ชิ้นงานดังกล่าวเป็นเนื้อหาโหลดแบบ Polite ของครีเอทีฟโฆษณา |
ASSET_ROLE_HEADLINE |
บรรทัดแรกของครีเอทีฟโฆษณาเนทีฟ
บทบาทนี้ได้รับการสนับสนุนเฉพาะใน
|
ASSET_ROLE_LONG_HEADLINE |
บรรทัดแรกแบบยาวของครีเอทีฟโฆษณาเนทีฟ
บทบาทนี้ได้รับการสนับสนุนเฉพาะใน
|
ASSET_ROLE_BODY |
ข้อความส่วนเนื้อหาของครีเอทีฟโฆษณาเนทีฟ
บทบาทนี้ได้รับการสนับสนุนเฉพาะใน
|
ASSET_ROLE_LONG_BODY |
ข้อความเนื้อหาขนาดยาวของครีเอทีฟโฆษณาเนทีฟ
บทบาทนี้ได้รับการสนับสนุนเฉพาะใน
|
ASSET_ROLE_CAPTION_URL |
URL ของหน้า Landing Page เวอร์ชันสั้นๆ ที่ใช้งานง่ายเพื่อแสดงในครีเอทีฟโฆษณา URL นี้ช่วยให้ผู้ใช้ทราบคร่าวๆ ว่าจะไปยังที่ใดหลังจากคลิกครีเอทีฟโฆษณา
ตัวอย่างเช่น หาก URL ของหน้า Landing Page คือ "http://www.example.com/page" URL ของคำอธิบายภาพอาจเป็น "example.com" โปรโตคอลนี้ (http://) ไม่จำเป็นต้องระบุ แต่ URL ต้องไม่มีการเว้นวรรคหรือสัญลักษณ์พิเศษ บทบาทนี้ได้รับการสนับสนุนเฉพาะใน
|
ASSET_ROLE_CALL_TO_ACTION |
ข้อความที่จะใช้บนปุ่มคำกระตุ้นให้ดำเนินการของครีเอทีฟโฆษณาเนทีฟ
บทบาทนี้ได้รับการสนับสนุนเฉพาะใน
|
ASSET_ROLE_ADVERTISER_NAME |
ข้อความที่ระบุชื่อผู้ลงโฆษณาหรือชื่อแบรนด์
บทบาทนี้ได้รับการสนับสนุนเฉพาะใน
|
ASSET_ROLE_PRICE |
ราคาซื้อของแอปใน Google Play Store หรือ iOS App Store (เช่น $5.99) โปรดทราบว่าค่านี้จะไม่ซิงค์กับค่าจริงที่แสดงใน Store โดยอัตโนมัติ ซึ่งจะเป็นชื่อที่มีให้เมื่อบันทึกครีเอทีฟโฆษณาเสมอ
เนื้อหาของบทบาทนี้เป็นแบบอ่านอย่างเดียว |
ASSET_ROLE_ANDROID_APP_ID |
รหัสของแอป Android ใน Google Play Store คุณจะพบรหัสนี้ใน URL ของ Google Play Store ของแอปหลัง "id" ตัวอย่างเช่น ใน https://play.google.com/store/apps/details?id=com.company.appname ตัวระบุคือ com.company.appname เนื้อหาของบทบาทนี้เป็นแบบอ่านอย่างเดียว |
ASSET_ROLE_IOS_APP_ID |
รหัสของแอป iOS ใน Apple App Store หมายเลขรหัสนี้จะอยู่ใน URL ของ Apple App Store โดยเป็นสตริงตัวเลขอยู่ต่อจาก "id" โดยตรง ตัวอย่างเช่น ใน https://apps.apple.com/us/app/gmail-email-by-google/id422689480 รหัสคือ 422689480 เนื้อหาของบทบาทนี้เป็นแบบอ่านอย่างเดียว |
ASSET_ROLE_RATING |
การจัดประเภทแอปใน Google Play Store หรือ iOS App Store โปรดทราบว่าค่านี้จะไม่ซิงค์กับคะแนนจริงใน Store โดยอัตโนมัติ ซึ่งจะเป็นชื่อที่มีให้เมื่อบันทึกครีเอทีฟโฆษณาเสมอ เนื้อหาของบทบาทนี้เป็นแบบอ่านอย่างเดียว |
ASSET_ROLE_ICON |
ไอคอนของครีเอทีฟโฆษณา ระบบรองรับและต้องใช้บทบาทนี้ใน
|
ASSET_ROLE_COVER_IMAGE |
ภาพหน้าปกของครีเอทีฟโฆษณาวิดีโอเนทีฟ ระบบรองรับและต้องใช้บทบาทนี้ใน
|
ExitEvent
เหตุการณ์การออกของครีเอทีฟโฆษณา
การแสดง JSON |
---|
{
"type": enum ( |
ช่อง | |
---|---|
type |
ต้องระบุ ประเภทของเหตุการณ์การออก |
url |
ต้องระบุ URL การคลิกผ่านของเหตุการณ์ออก ต้องระบุเมื่อ
|
name |
ชื่อของแท็กคลิกของเหตุการณ์การออก ชื่อต้องไม่ซ้ำกันภายในโฆษณา 1 รายการ ปล่อยว่างไว้หรือไม่ได้ตั้งค่าสำหรับครีเอทีฟโฆษณาที่มีชิ้นงานรูปภาพเท่านั้น |
reportingName |
ชื่อที่ใช้ระบุเหตุการณ์นี้ในรายงาน ปล่อยว่างไว้หรือไม่ได้ตั้งค่าสำหรับครีเอทีฟโฆษณาที่มีชิ้นงานรูปภาพเท่านั้น |
ExitEventType
ประเภทของเหตุการณ์การออก
Enum | |
---|---|
EXIT_EVENT_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทเหตุการณ์การออกหรือไม่รู้จักในเวอร์ชันนี้ |
EXIT_EVENT_TYPE_DEFAULT |
เหตุการณ์การออกจะเป็นเหตุการณ์เริ่มต้น |
EXIT_EVENT_TYPE_BACKUP |
เหตุการณ์การออกคือเหตุการณ์การออกสํารอง อาจมีเหตุการณ์ทางออกสำรองหลายรายการในครีเอทีฟโฆษณา |
TimerEvent
เหตุการณ์ตัวจับเวลาของครีเอทีฟโฆษณา
การแสดง JSON |
---|
{ "name": string, "reportingName": string } |
ช่อง | |
---|---|
name |
ต้องระบุ ชื่อของเหตุการณ์ตัวจับเวลา |
reportingName |
ต้องระบุ ชื่อที่ใช้ระบุเหตุการณ์ตัวจับเวลานี้ในรายงาน |
CounterEvent
เหตุการณ์โต้แย้งของครีเอทีฟโฆษณา
การแสดง JSON |
---|
{ "name": string, "reportingName": string } |
ช่อง | |
---|---|
name |
ต้องระบุ ชื่อเหตุการณ์ของตัวนับ |
reportingName |
ต้องระบุ ชื่อที่ใช้ระบุเหตุการณ์ตัวนับนี้ในรายงาน |
AudioVideoOffset
ความยาวของเสียงหรือวิดีโอที่เล่น
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์การรวม offset ค่าของออฟเซ็ต offset ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
percentage |
ค่าออฟเซ็ตเป็นเปอร์เซ็นต์ของระยะเวลาของเสียงหรือวิดีโอ |
seconds |
ออฟเซ็ตเป็นวินาทีนับจากจุดเริ่มต้นของเสียงหรือวิดีโอ |
UniversalAdId
ตัวระบุครีเอทีฟโฆษณาที่มาจากองค์กรจัดการข้อมูลโดเมนซึ่งไม่ซ้ำกันในทุกแพลตฟอร์ม นี่เป็นส่วนหนึ่งของมาตรฐาน VAST 4.0
การแสดง JSON |
---|
{
"id": string,
"registry": enum ( |
ช่อง | |
---|---|
id |
ตัวระบุครีเอทีฟโฆษณาที่ไม่ซ้ำกัน |
registry |
องค์กรจัดการข้อมูลโดเมนมีตัวระบุครีเอทีฟโฆษณาที่ไม่ซ้ำกัน |
UniversalAdRegistry
องค์กรจัดการข้อมูลโดเมนมีตัวระบุครีเอทีฟโฆษณาที่ไม่ซ้ำกันในรหัสโฆษณาสากล
Enum | |
---|---|
UNIVERSAL_AD_REGISTRY_UNSPECIFIED |
ไม่ได้ระบุรีจิสทรีของโฆษณา Universal หรือไม่รู้จักในเวอร์ชันนี้ |
UNIVERSAL_AD_REGISTRY_OTHER |
ใช้ผู้ให้บริการที่กำหนดเองเพื่อระบุรหัสโฆษณาสากล |
UNIVERSAL_AD_REGISTRY_AD_ID |
ใช้รหัสโฆษณาเพื่อระบุรหัสโฆษณาสากล |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
ใช้ clearcast.co.uk เพื่อระบุรหัสโฆษณาสากล |
UNIVERSAL_AD_REGISTRY_DV360 |
ใช้ Display & Video 360 เพื่อระบุรหัสโฆษณาสากล |
UNIVERSAL_AD_REGISTRY_CM |
ใช้ Campaign Manager 360 เพื่อระบุรหัสโฆษณาสากล |
ThirdPartyUrl
ติดตาม URL จากบุคคลที่สามเพื่อติดตามการโต้ตอบกับครีเอทีฟโฆษณาเสียงหรือครีเอทีฟโฆษณาวิดีโอ
การแสดง JSON |
---|
{
"type": enum ( |
ช่อง | |
---|---|
type |
ประเภทของการโต้ตอบที่ต้องถูกติดตามโดย URL ติดตามผล |
url |
URL ติดตามที่ใช้เพื่อติดตามการโต้ตอบ ระบุ URL ที่มีเส้นทางหรือสตริงการค้นหาที่ไม่บังคับ โดยขึ้นต้นด้วย |
ThirdPartyUrlType
ประเภทของการโต้ตอบต้องได้รับการติดตามโดย URL ติดตามของบุคคลที่สาม
Enum | |
---|---|
THIRD_PARTY_URL_TYPE_UNSPECIFIED |
ไม่ได้ระบุหรือไม่ทราบประเภทของ URL ของบุคคลที่สามในเวอร์ชันนี้ |
THIRD_PARTY_URL_TYPE_IMPRESSION |
ใช้เพื่อนับการแสดงผลของครีเอทีฟโฆษณาหลังจากที่บัฟเฟอร์เสียงหรือวิดีโอเสร็จสมบูรณ์ |
THIRD_PARTY_URL_TYPE_CLICK_TRACKING |
ใช้เพื่อติดตามการคลิกของผู้ใช้บนเสียงหรือวิดีโอ |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
ใช้เพื่อติดตามจำนวนครั้งที่ผู้ใช้เริ่มเล่นเสียงหรือวิดีโอ |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE |
ใช้เพื่อติดตามจำนวนครั้งที่เสียงหรือวิดีโอเล่นถึง 25% ของความยาวทั้งหมด |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT |
ใช้เพื่อติดตามจำนวนครั้งที่เสียงหรือวิดีโอเล่นถึง 50% ของความยาวทั้งหมด |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE |
ใช้เพื่อติดตามจำนวนครั้งที่เสียงหรือวิดีโอเล่นถึง 75% ของความยาวทั้งหมด |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE |
ใช้เพื่อติดตามจำนวนครั้งที่เสียงหรือวิดีโอเล่นจนจบ |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE |
ใช้เพื่อติดตามจำนวนครั้งที่ผู้ใช้ปิดเสียงหรือวิดีโอ |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE |
ใช้เพื่อติดตามจำนวนครั้งที่ผู้ใช้หยุดเสียงหรือวิดีโอชั่วคราว |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND |
ใช้เพื่อติดตามจำนวนครั้งที่ผู้ใช้เล่นเสียงหรือวิดีโอซ้ำ |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN |
ใช้เพื่อติดตามจำนวนครั้งที่ผู้ใช้ขยายโปรแกรมเล่นเป็นขนาดเต็มหน้าจอ |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP |
ใช้เพื่อติดตามจำนวนครั้งที่ผู้ใช้หยุดเสียงหรือวิดีโอ |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM |
ใช้เพื่อติดตามจำนวนครั้งที่ผู้ใช้ทำการคลิกที่กำหนดเอง เช่น การคลิกฮอตสปอตของวิดีโอ |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP |
ใช้เพื่อติดตามจำนวนครั้งที่มีการข้ามเสียงหรือวิดีโอ |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS |
ใช้เพื่อติดตามจำนวนครั้งที่เสียงหรือวิดีโอเล่นถึงออฟเซ็ตที่ progressOffset กำหนด |
การแปลง
แสดงข้อมูลเกี่ยวกับไฟล์เสียงหรือวิดีโอที่แปลงแล้ว
การแสดง JSON |
---|
{
"name": string,
"mimeType": string,
"transcoded": boolean,
"dimensions": {
object ( |
ช่อง | |
---|---|
name |
ชื่อของไฟล์ที่แปลง |
mimeType |
ประเภท MIME ของไฟล์แปลง |
transcoded |
ระบุว่าการแปลงสำเร็จหรือไม่ |
dimensions |
ขนาดของวิดีโอที่แปลงแล้ว |
bitRateKbps |
อัตราบิตของการแปลงวิดีโอที่แปลงแล้วเป็นกิโลบิตต่อวินาที |
frameRate |
อัตราเฟรมของวิดีโอที่แปลงแล้วเป็นเฟรมต่อวินาที |
audioBitRateKbps |
อัตราบิตของสตรีมเสียงในวิดีโอที่แปลง หรืออัตราบิตของเสียงที่แปลงแล้วในหน่วยกิโลบิตต่อวินาที |
audioSampleRateHz |
อัตราตัวอย่างสำหรับสตรีมเสียงของวิดีโอที่แปลงแล้ว หรืออัตราตัวอย่างสำหรับเสียงที่แปลงแล้วในหน่วยเฮิรตซ์ |
fileSizeBytes |
ขนาดของไฟล์ที่แปลงหน่วยเป็นไบต์ |
CmTrackingAd
โฆษณาเพื่อการติดตามของ Campaign Manager 360
การแสดง JSON |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
ช่อง | |
---|---|
cmPlacementId |
รหัสตำแหน่งโฆษณาของ Campaign Manager 360 Tracking Ad |
cmCreativeId |
รหัสครีเอทีฟโฆษณาของโฆษณาเพื่อการติดตาม Campaign Manager 360 |
cmAdId |
รหัสโฆษณาของ Campaign Manager 360 Tracking Ad |
ObaIcon
ไอคอน OBA สำหรับโฆษณา
การแสดง JSON |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
ช่อง | |
---|---|
resourceUrl |
URL ของทรัพยากรไอคอน OBA |
resourceMimeType |
ประเภท MIME ของทรัพยากรไอคอน OBA |
position |
ตำแหน่งของไอคอน OBA บนครีเอทีฟโฆษณา |
dimensions |
ขนาดของไอคอน OBA |
program |
โปรแกรมของไอคอน OBA ตัวอย่างเช่น "ตัวเลือกโฆษณาอื่นๆ" |
landingPageUrl |
ต้องระบุ URL ของหน้า Landing Page ของไอคอน OBA อนุญาตเฉพาะ URL ของโดเมนต่อไปนี้เท่านั้น |
clickTrackingUrl |
ต้องระบุ URL ติดตามการคลิกของไอคอน OBA อนุญาตเฉพาะ URL ของโดเมนต่อไปนี้เท่านั้น |
viewTrackingUrl |
ต้องระบุ URL ติดตามการดูของไอคอน OBA อนุญาตเฉพาะ URL ของโดเมนต่อไปนี้เท่านั้น |
ObaIconPosition
ตำแหน่งของไอคอน OBA บนครีเอทีฟโฆษณา
Enum | |
---|---|
OBA_ICON_POSITION_UNSPECIFIED |
ไม่ได้ระบุตำแหน่งไอคอน OBA |
OBA_ICON_POSITION_UPPER_RIGHT |
ที่ด้านบนขวาของครีเอทีฟโฆษณา |
OBA_ICON_POSITION_UPPER_LEFT |
ที่ด้านซ้ายบนของโฆษณา |
OBA_ICON_POSITION_LOWER_RIGHT |
ที่ด้านล่างขวาของครีเอทีฟโฆษณา |
OBA_ICON_POSITION_LOWER_LEFT |
ที่ด้านซ้ายล่างของโฆษณา |
ExpandingDirection
ทิศทางการขยายโฆษณาที่ขยายได้ของบุคคลที่สาม
Enum | |
---|---|
EXPANDING_DIRECTION_UNSPECIFIED |
ไม่ได้ระบุทิศทางการขยาย |
EXPANDING_DIRECTION_NONE |
ไม่มีการขยายในทิศทางใดๆ |
EXPANDING_DIRECTION_UP |
ขยายขึ้น |
EXPANDING_DIRECTION_DOWN |
ขยายลง |
EXPANDING_DIRECTION_LEFT |
ขยายไปทางซ้าย |
EXPANDING_DIRECTION_RIGHT |
ขยายไปทางขวา |
EXPANDING_DIRECTION_UP_AND_LEFT |
ขยายขึ้นด้านบนและไปทางซ้าย |
EXPANDING_DIRECTION_UP_AND_RIGHT |
ขยายขึ้นและไปทางขวา |
EXPANDING_DIRECTION_DOWN_AND_LEFT |
ขยายลงด้านล่างและไปทางซ้าย |
EXPANDING_DIRECTION_DOWN_AND_RIGHT |
ขยายลงและไปทางขวา |
EXPANDING_DIRECTION_UP_OR_DOWN |
ขยายขึ้นหรือลง |
EXPANDING_DIRECTION_LEFT_OR_RIGHT |
ขยายไปทางซ้ายหรือขวา |
EXPANDING_DIRECTION_ANY_DIAGONAL |
สามารถขยายในทิศทางทแยงมุมใดก็ได้ |
วิธีการ |
|
---|---|
|
สร้างโฆษณาใหม่ |
|
ลบครีเอทีฟโฆษณา |
|
รับครีเอทีฟโฆษณา |
|
แสดงรายการครีเอทีฟโฆษณาในส่วนของผู้ลงโฆษณา |
|
อัปเดตครีเอทีฟโฆษณาที่มีอยู่ |