REST Resource: advertisers.creatives

แหล่งข้อมูล: ครีเอทีฟโฆษณา

ครีเอทีฟโฆษณาเดียว

การแสดง JSON 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean,
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของครีเอทีฟโฆษณา
advertiserId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่เป็นเจ้าของครีเอทีฟโฆษณา
creativeId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของครีเอทีฟโฆษณา กำหนดโดยระบบ
cmPlacementId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของตำแหน่งโฆษณา Campaign Manager 360 ที่เชื่อมโยงกับครีเอทีฟโฆษณา ช่องนี้ใช้ได้กับครีเอทีฟโฆษณาที่ซิงค์จาก Campaign Manager เท่านั้น
displayName

string

ต้องระบุ ชื่อที่แสดงของครีเอทีฟโฆษณา

ต้องเข้ารหัส UTF-8 โดยมีขนาดสูงสุด 240 ไบต์
entityStatus

enum (EntityStatus)

ต้องระบุ ควบคุมว่าจะแสดงครีเอทีฟโฆษณาได้หรือไม่

ค่าที่ยอมรับมีดังนี้

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาที่อัปเดตครีเอทีฟโฆษณาครั้งล่าสุด ไม่ว่าจะโดยผู้ใช้หรือระบบ (เช่น การตรวจสอบครีเอทีฟโฆษณา) กำหนดโดยระบบ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาเมื่อสร้างครีเอทีฟโฆษณา กำหนดโดยระบบ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
creativeType

enum (CreativeType)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเภทของครีเอทีฟโฆษณา
hostingSource

enum (HostingSource)

ต้องระบุ ระบุตำแหน่งที่โฮสต์ครีเอทีฟโฆษณา
dynamic

boolean

เอาต์พุตเท่านั้น ระบุว่าครีเอทีฟโฆษณาเป็นแบบไดนามิกหรือไม่
dimensions

object (Dimensions)

ต้องระบุ มิติข้อมูลหลักของครีเอทีฟโฆษณา ใช้ได้กับครีเอทีฟโฆษณาทุกประเภท ค่าของ widthPixels และ heightPixels จะมีค่าเริ่มต้นเป็น 0 เมื่อ creativeType เป็นค่าใดค่าหนึ่งต่อไปนี้

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

ไม่บังคับ มิติข้อมูลเพิ่มเติม ใช้ได้เมื่อ creativeType เป็นค่าใดค่าหนึ่งต่อไปนี้

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

หากระบุช่องนี้ คุณต้องระบุทั้ง widthPixels และ heightPixels และต้องมีค่ามากกว่าหรือเท่ากับ 0
mediaDuration

string (Duration format)

เอาต์พุตเท่านั้น ระยะเวลาของสื่อของครีเอทีฟโฆษณา ใช้ได้เมื่อ creativeType เป็นค่าใดค่าหนึ่งต่อไปนี้

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมสูงสุด 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"
creativeAttributes[]

enum (CreativeAttribute)

เอาต์พุตเท่านั้น รายการแอตทริบิวต์ของครีเอทีฟโฆษณาที่ระบบสร้างขึ้น
reviewStatus

object (ReviewStatusInfo)

เอาต์พุตเท่านั้น สถานะปัจจุบันของกระบวนการตรวจสอบครีเอทีฟโฆษณา
assets[]

object (AssetAssociation)

ต้องระบุ ชิ้นงานที่เชื่อมโยงกับครีเอทีฟโฆษณานี้
exitEvents[]

object (ExitEvent)

ต้องระบุ เหตุการณ์การออกสำหรับครีเอทีฟโฆษณานี้ ทางออก (หรือที่เรียกว่าแท็กการคลิก) คือพื้นที่ใดก็ได้ในครีเอทีฟโฆษณาที่ผู้ใช้สามารถคลิกหรือแตะเพื่อเปิดหน้า Landing Page ของผู้ลงโฆษณา ครีเอทีฟโฆษณาทุกรายการต้องมีทางออกอย่างน้อย 1 ทาง คุณเพิ่มทางออกให้กับครีเอทีฟโฆษณาได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้

  • ใช้พื้นที่การแตะของ Google Web Designer
  • กำหนดตัวแปร JavaScript ที่ชื่อ "clickTag"
  • ใช้ Enabler (Enabler.exit()) เพื่อติดตามการออกในรูปแบบริชมีเดีย
timerEvents[]

object (TimerEvent)

ไม่บังคับ เหตุการณ์ที่กำหนดเองของตัวจับเวลาสำหรับครีเอทีฟโฆษณาแบบริชมีเดีย ตัวจับเวลาจะติดตามเวลาที่ผู้ใช้ดูและโต้ตอบกับส่วนใดส่วนหนึ่งของครีเอทีฟโฆษณาแบบริชมีเดีย ครีเอทีฟโฆษณา 1 รายการอาจมีเหตุการณ์ของเครื่องควบคุมเวลาหลายเหตุการณ์ แต่ละเหตุการณ์มีการจับเวลาแยกกัน ปล่อยว่างไว้หรือไม่ได้ตั้งค่าสำหรับครีเอทีฟโฆษณาที่มีชิ้นงานรูปภาพเท่านั้น
counterEvents[]

object (CounterEvent)

ไม่บังคับ เหตุการณ์ตัวนับสำหรับครีเอทีฟโฆษณาแบบริชมีเดีย ตัวนับจะติดตามจำนวนครั้งที่ผู้ใช้โต้ตอบกับส่วนใดก็ตามของครีเอทีฟโฆษณาแบบริชมีเดียในลักษณะเฉพาะ (การวางเมาส์เหนือ การเลื่อนเมาส์ออก การคลิก การแตะ การโหลดข้อมูล การป้อนข้อมูลด้วยแป้นพิมพ์ เป็นต้น) เหตุการณ์ใดก็ตามที่จับภาพได้ในครีเอทีฟโฆษณาจะสามารถบันทึกเป็นตัวนับได้ ปล่อยว่างไว้หรือไม่ได้ตั้งค่าสำหรับครีเอทีฟโฆษณาที่มีชิ้นงานรูปภาพเท่านั้น
appendedTag

string

ไม่บังคับ แท็กติดตาม HTML ของบุคคลที่สามที่จะเพิ่มต่อท้ายแท็กครีเอทีฟโฆษณา
integrationCode

string

ไม่บังคับ ข้อมูลรหัสที่ใช้ลิงก์ครีเอทีฟโฆษณานี้กับระบบภายนอก ต้องเข้ารหัสแบบ UTF-8 โดยมีความยาวไม่เกิน 10,000 อักขระ
notes

string

ไม่บังคับ หมายเหตุของผู้ใช้สำหรับครีเอทีฟโฆษณานี้ ต้องเข้ารหัส UTF-8 โดยมีความยาวไม่เกิน 20,000 อักขระ
iasCampaignMonitoring

boolean

ไม่บังคับ ระบุว่าเปิดใช้การตรวจสอบแคมเปญ Integral Ad Science (IAS) หรือไม่ หากต้องการเปิดใช้ฟีเจอร์นี้สำหรับครีเอทีฟโฆษณา ให้ตรวจสอบว่าได้ตั้งค่า Advertiser.creative_config.ias_client_id เป็นรหัสไคลเอ็นต์ IAS แล้ว
companionCreativeIds[]

string (int64 format)

ไม่บังคับ รหัสของครีเอทีฟโฆษณาที่แสดงร่วมสำหรับครีเอทีฟโฆษณาวิดีโอ

คุณสามารถกำหนดครีเอทีฟโฆษณา Display ที่มีอยู่ (ซึ่งมีชิ้นงานรูปภาพหรือ HTML5) ให้แสดงรอบๆ วิดีโอเพลเยอร์ของผู้เผยแพร่โฆษณาได้ โฆษณาที่แสดงร่วมจะแสดงรอบๆ วิดีโอเพลเยอร์ขณะที่วิดีโอกำลังเล่น และจะยังคงอยู่หลังจากที่วิดีโอเล่นจบแล้ว

ครีเอทีฟโฆษณาที่มี additional dimensions จะเป็นครีเอทีฟโฆษณาที่แสดงร่วมไม่ได้

ช่องนี้รองรับเฉพาะ creativeType ต่อไปนี้

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

ไม่บังคับ ผู้ใช้เลือกข้ามครีเอทีฟโฆษณาวิดีโอได้หรือไม่

ช่องนี้รองรับเฉพาะ creativeType ต่อไปนี้

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

ไม่บังคับ ระยะเวลาที่ต้องเล่นวิดีโอก่อนที่ปุ่มข้ามจะปรากฏขึ้น

ต้องระบุข้อมูลในช่องนี้เมื่อ skippable เป็น "true"

ช่องนี้รองรับเฉพาะ creativeType ต่อไปนี้

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

ไม่บังคับ ระยะเวลาที่ต้องเล่นวิดีโอก่อนที่จะนับเป็นยอดดู

ต้องระบุข้อมูลในช่องนี้เมื่อ skippable เป็นจริง

ช่องนี้รองรับเฉพาะ creativeType ต่อไปนี้

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

ไม่บังคับ ตัวระบุครีเอทีฟโฆษณาที่ไม่บังคับซึ่งระบุโดยรีจิสทรีที่ไม่ซ้ำกันในทุกแพลตฟอร์ม

รหัสโฆษณาสากลเป็นส่วนหนึ่งของมาตรฐาน VAST 4.0 โดยจะแก้ไขได้หลังจากสร้างครีเอทีฟโฆษณาแล้ว

ช่องนี้รองรับเฉพาะ creativeType ต่อไปนี้

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

ไม่บังคับ URL ติดตามจากบุคคลที่สามเพื่อติดตามการโต้ตอบกับครีเอทีฟโฆษณาวิดีโอ

ช่องนี้รองรับเฉพาะ creativeType ต่อไปนี้

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

เอาต์พุตเท่านั้น การแปลงเสียง/วิดีโอ

Display & Video 360 จะแปลงชิ้นงานหลักเป็นเวอร์ชันอื่นๆ จำนวนหนึ่งซึ่งใช้รูปแบบไฟล์ที่แตกต่างกันหรือมีพร็อพเพอร์ตี้ที่แตกต่างกัน (ความละเอียด, อัตราบิตของเสียง และอัตราบิตของวิดีโอ) โดยแต่ละเวอร์ชันได้รับการออกแบบมาสำหรับวิดีโอเพลเยอร์หรือแบนด์วิดท์ที่เฉพาะเจาะจง

การแปลงเหล่านี้ช่วยให้ระบบของผู้เผยแพร่โฆษณามีตัวเลือกมากขึ้นในการเลือกการแสดงผลแต่ละครั้งในวิดีโอ และช่วยให้มั่นใจว่าระบบจะแสดงไฟล์ที่เหมาะสมตามการเชื่อมต่อและขนาดหน้าจอของผู้ชม

ช่องนี้รองรับเฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

ไม่บังคับ URL ติดตามสำหรับผู้ให้บริการข้อมูลวิเคราะห์หรือผู้ให้บริการเทคโนโลยีโฆษณาบุคคลที่สาม

URL ต้องขึ้นต้นด้วย https: (ยกเว้นในพื้นที่โฆษณาที่ไม่ต้องเป็นไปตามข้อกำหนด SSL) หากใช้มาโครใน URL ให้ใช้เฉพาะมาโครที่ Display & Video 360 รองรับ

URL มาตรฐานเท่านั้น ไม่มีแท็ก IMG หรือ SCRIPT

ช่องนี้เขียนได้เฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

ไม่บังคับ URL การวัดผล JavaScript จากผู้ให้บริการตรวจสอบบุคคลที่สามที่รองรับ (ComScore, DoubleVerify, IAS, Moat) ระบบไม่รองรับแท็กสคริปต์ HTML

ช่องนี้เขียนได้เฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

ไม่บังคับ โฆษณาเพื่อการติดตามของ Campaign Manager 360 ที่เชื่อมโยงกับครีเอทีฟโฆษณา

ไม่บังคับสำหรับcreativeTypeต่อไปนี้เมื่อสร้างโดยผู้ลงโฆษณาที่ใช้ทั้ง Campaign Manager 360 และการแสดงโฆษณาของบุคคลที่สาม

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

เอาต์พุตเท่านั้นสำหรับกรณีอื่นๆ
obaIcon

object (ObaIcon)

ไม่บังคับ ระบุไอคอน OBA สำหรับครีเอทีฟโฆษณาวิดีโอ

ช่องนี้รองรับเฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

ไม่บังคับ แท็กจากบุคคลที่สามเดิมที่ใช้สำหรับครีเอทีฟโฆษณา

ต้องระบุและใช้ได้กับครีเอทีฟโฆษณาแท็กจากบุคคลที่สามเท่านั้น

ครีเอทีฟโฆษณาแท็กจากบุคคลที่สามคือครีเอทีฟโฆษณาที่มีhostingSourceต่อไปนี้

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

ไม่บังคับ ระบุว่าครีเอทีฟโฆษณาต้องใช้ MRAID (ระบบ Mobile Rich Media Ad Interface Definitions)

ตั้งค่านี้หากครีเอทีฟโฆษณาอาศัยท่าทางสัมผัสบนอุปกรณ์เคลื่อนที่เพื่อการโต้ตอบ เช่น การปัดหรือการแตะ

ไม่บังคับและใช้ได้กับครีเอทีฟโฆษณาแท็กจากบุคคลที่สามเท่านั้น

ครีเอทีฟโฆษณาแท็กจากบุคคลที่สามคือครีเอทีฟโฆษณาที่มีhostingSourceต่อไปนี้

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

ไม่บังคับ ระบุว่าครีเอทีฟโฆษณาอาศัย HTML5 เพื่อแสดงผลอย่างถูกต้อง

ไม่บังคับและใช้ได้กับครีเอทีฟโฆษณาแท็กจากบุคคลที่สามเท่านั้น ครีเอทีฟโฆษณาแท็กจากบุคคลที่สามคือครีเอทีฟโฆษณาที่มีhostingSourceต่อไปนี้

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

ไม่บังคับ ระบุว่าครีเอทีฟโฆษณาจะรอการส่งคําสั่ง ping กลับเพื่อระบุแหล่งที่มา

ใช้ได้เฉพาะเมื่อใช้โฆษณาเพื่อการติดตามของ Campaign Manager 360 กับพารามิเตอร์เซิร์ฟเวอร์โฆษณาบุคคลที่สามและมาโคร ${DC_DBM_TOKEN}

ไม่บังคับและใช้ได้กับครีเอทีฟโฆษณาแท็กจากบุคคลที่สามหรือครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเท่านั้น

ครีเอทีฟโฆษณาแท็กจากบุคคลที่สามคือครีเอทีฟโฆษณาที่มีhostingSourceต่อไปนี้

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

ครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามคือครีเอทีฟโฆษณาที่มีลักษณะดังต่อไปนี้hostingSource

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

ไม่บังคับ ระบุทิศทางการขยายของครีเอทีฟโฆษณา

ต้องระบุและใช้ได้กับครีเอทีฟโฆษณาแบบขยายได้ของบุคคลที่สามเท่านั้น

ครีเอทีฟโฆษณาแบบขยายได้ของบุคคลที่สามคือครีเอทีฟโฆษณาที่มีแหล่งที่มาของโฮสติ้งต่อไปนี้

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

ไม่บังคับ ระบุว่าครีเอทีฟโฆษณาจะขยายโดยอัตโนมัติเมื่อวางเมาส์เหนือโฆษณา

ไม่บังคับและใช้ได้กับครีเอทีฟโฆษณาแบบขยายได้ของบุคคลที่สามเท่านั้น ครีเอทีฟโฆษณาแบบขยายได้ของบุคคลที่สามคือครีเอทีฟโฆษณาที่มีแหล่งที่มาของโฮสติ้งต่อไปนี้

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

ไม่บังคับ URL ของแท็ก VAST สำหรับครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สาม

ต้องระบุและใช้ได้กับครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเท่านั้น

ครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามคือครีเอทีฟโฆษณาที่มีลักษณะดังต่อไปนี้hostingSource

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

เอาต์พุตเท่านั้น ระบุว่าครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามต้องใช้ VPAID (อินเทอร์เฟซการแสดงโฆษณาบนวิดีโอเพลเยอร์ดิจิทัล)

เอาต์พุตเท่านั้นและใช้ได้กับครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเท่านั้น

ครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามคือครีเอทีฟโฆษณาที่มีลักษณะดังต่อไปนี้hostingSource

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

เอาต์พุตเท่านั้น ระบุว่าครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามต้องรองรับวิดีโอ HTML5

เอาต์พุตเท่านั้นและใช้ได้กับครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามเท่านั้น

ครีเอทีฟโฆษณาแท็ก VAST ของบุคคลที่สามคือครีเอทีฟโฆษณาที่มีลักษณะดังต่อไปนี้hostingSource

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

เอาต์พุตเท่านั้น รหัสของรายการโฆษณาที่เชื่อมโยงกับครีเอทีฟโฆษณานี้

หากต้องการเชื่อมโยงครีเอทีฟโฆษณากับรายการโฆษณา ให้ใช้ LineItem.creative_ids แทน
mp3Audio

boolean

เอาต์พุตเท่านั้น ระบุว่าครีเอทีฟโฆษณาเสียงของบุคคลที่สามรองรับ MP3

เอาต์พุตเท่านั้นและใช้ได้กับครีเอทีฟโฆษณาเสียงของบุคคลที่สามเท่านั้น

ครีเอทีฟโฆษณาเสียงของบุคคลที่สามคือครีเอทีฟโฆษณาที่มีลักษณะดังต่อไปนี้hostingSource

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

เอาต์พุตเท่านั้น ระบุว่าครีเอทีฟโฆษณาเสียงของบุคคลที่สามรองรับ OGG

เอาต์พุตเท่านั้นและใช้ได้กับครีเอทีฟโฆษณาเสียงของบุคคลที่สามเท่านั้น

ครีเอทีฟโฆษณาเสียงของบุคคลที่สามคือครีเอทีฟโฆษณาที่มีลักษณะดังต่อไปนี้hostingSource

  • HOSTING_SOURCE_THIRD_PARTY

รวมกับ creativeType ต่อไปนี้

  • CREATIVE_TYPE_AUDIO
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

ไม่บังคับ เลือกว่าจะเพิ่มป้ายกำกับลงในครีเอทีฟโฆษณาว่าสร้างหรือแก้ไขโดยใช้ AI หรือไม่เมื่อแสดงในภูมิภาคที่มีกฎระเบียบการติดป้ายกำกับ AI ในท้องถิ่น

HostingSource

แหล่งที่มาของการโฮสต์ที่เป็นไปได้สำหรับครีเอทีฟโฆษณา ระบุตำแหน่งที่สร้างและโฮสต์ครีเอทีฟโฆษณา

Enum
HOSTING_SOURCE_UNSPECIFIED ไม่ได้ระบุแหล่งที่มาของโฮสติ้งหรือไม่ทราบแหล่งที่มาในเวอร์ชันนี้
HOSTING_SOURCE_CM

ครีเอทีฟโฆษณาที่ซิงค์จาก Campaign Manager 360

ระบบไม่รองรับเมธอดการสร้างและอัปเดตสำหรับโฮสติ้งประเภทนี้
HOSTING_SOURCE_THIRD_PARTY

ครีเอทีฟโฆษณาที่โฮสต์โดยเซิร์ฟเวอร์โฆษณาบุคคลที่สาม (3PAS)

ระบบรองรับเมธอดการสร้างและการอัปเดตสำหรับโฮสติ้งประเภทนี้หาก creativeType เป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

ครีเอทีฟโฆษณาที่สร้างใน DV360 และโฮสต์โดย Campaign Manager 360

ระบบรองรับเมธอดการสร้างและการอัปเดตสำหรับประเภทโฮสติ้งนี้หาก creativeType เป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
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": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ]
}
ช่อง
approvalStatus

enum (ApprovalStatus)

แสดงถึงการอนุมัติพื้นฐานที่จำเป็นสำหรับครีเอทีฟโฆษณาเพื่อเริ่มแสดง สรุป creativeAndLandingPageReviewStatus และ contentAndPolicyReviewStatus
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

สถานะการตรวจสอบครีเอทีฟโฆษณาและหน้า Landing Page สำหรับครีเอทีฟโฆษณา
contentAndPolicyReviewStatus

enum (ReviewStatus)

สถานะการตรวจสอบเนื้อหาและนโยบายสำหรับครีเอทีฟโฆษณา
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

สถานะการตรวจสอบ Exchange สำหรับครีเอทีฟโฆษณา

สถานะการอนุมัติ

ประเภทสถานะการอนุมัติที่เป็นไปได้ ซึ่งเป็นข้อมูลสรุปของ 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

สถานะการตรวจสอบ Exchange สำหรับครีเอทีฟโฆษณา

การแสดง JSON 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
ช่อง
exchange

enum (Exchange)

Exchange ที่ตรวจสอบครีเอทีฟโฆษณา
status

enum (ReviewStatus)

สถานะการตรวจสอบการแลกเปลี่ยน

AssetAssociation

การเชื่อมโยงชิ้นงานสำหรับครีเอทีฟโฆษณา

การแสดง JSON 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
ฟิลด์
asset

object (Asset)

ไม่บังคับ เนื้อหาที่เกี่ยวข้อง
role

enum (AssetRole)

ไม่บังคับ บทบาทของชิ้นงานนี้สำหรับครีเอทีฟโฆษณา

ชิ้นงาน

ชิ้นงานเดียว

การแสดง JSON 
{
  "mediaId": string,
  "content": string
}
ช่อง
mediaId

string (int64 format)

รหัสสื่อของชิ้นงานที่อัปโหลด ซึ่งเป็นตัวระบุที่ไม่ซ้ำกันสำหรับเนื้อหา คุณสามารถส่งรหัสนี้ไปยังการเรียก API อื่นๆ ได้ เช่น creatives.create เพื่อเชื่อมโยงชิ้นงานกับครีเอทีฟโฆษณา

พื้นที่รหัสสื่ออัปเดตเมื่อวันที่ 5 เมษายน 2023 อัปเดตรหัสสื่อที่แคชไว้ก่อนวันที่ 5 เมษายน 2023 โดยดึงรหัสสื่อใหม่จากทรัพยากรครีเอทีฟโฆษณาที่เกี่ยวข้องหรืออัปโหลดชิ้นงานอีกครั้ง
content

string

เนื้อหาของชิ้นงาน สำหรับชิ้นงานที่อัปโหลด เนื้อหาคือเส้นทางการแสดงผล

AssetRole

บทบาทของชิ้นงานนี้สำหรับครีเอทีฟโฆษณา

Enum
ASSET_ROLE_UNSPECIFIED ไม่ได้ระบุบทบาทของเนื้อหาหรือไม่ทราบในเวอร์ชันนี้
ASSET_ROLE_MAIN ชิ้นงานเป็นชิ้นงานหลักของครีเอทีฟโฆษณา
ASSET_ROLE_BACKUP ชิ้นงานเป็นชิ้นงานสำรองของครีเอทีฟโฆษณา
ASSET_ROLE_POLITE_LOAD ชิ้นงานเป็นชิ้นงานที่โหลดแบบ Polite ของครีเอทีฟโฆษณา
ASSET_ROLE_HEADLINE

บรรทัดแรกของครีเอทีฟโฆษณาเนทีฟ

content ต้องเข้ารหัสแบบ UTF-8 โดยมีความยาวไม่เกิน 25 อักขระ

บทบาทนี้ใช้ได้เฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

บรรทัดแรกแบบยาวของครีเอทีฟโฆษณาเนทีฟ

content ต้องเข้ารหัสแบบ UTF-8 โดยมีความยาวไม่เกิน 50 อักขระ

บทบาทนี้ใช้ได้เฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

ข้อความเนื้อหาของครีเอทีฟโฆษณาเนทีฟ

content ต้องเข้ารหัสแบบ UTF-8 โดยมีความยาวไม่เกิน 90 อักขระ

บทบาทนี้ใช้ได้เฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

ข้อความเนื้อหาแบบยาวของครีเอทีฟโฆษณาเนทีฟ

content ต้องเข้ารหัสแบบ UTF-8 โดยมีความยาวไม่เกิน 150 อักขระ

บทบาทนี้ใช้ได้เฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

URL ของหน้า Landing Page เวอร์ชันสั้นและเข้าใจง่ายที่จะแสดงในครีเอทีฟโฆษณา URL นี้ช่วยให้ผู้ใช้ทราบคร่าวๆ ว่าตนจะไปถึงที่ใดเมื่อคลิกครีเอทีฟโฆษณา

content ต้องเข้ารหัสแบบ UTF-8 โดยมีความยาวไม่เกิน 30 อักขระ

เช่น หาก URL ของหน้า Landing Page คือ "http://www.example.com/page" URL คำอธิบายภาพอาจเป็น "example.com" โปรโตคอล (http://) เป็นแบบไม่บังคับ แต่ URL ต้องไม่มีเว้นวรรคหรือสัญลักษณ์พิเศษ

บทบาทนี้ใช้ได้เฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

ข้อความที่จะใช้บนปุ่มกระตุ้นให้ดำเนินการของครีเอทีฟโฆษณาเนทีฟ

content ต้องเข้ารหัสแบบ UTF-8 โดยมีความยาวไม่เกิน 15 อักขระ

บทบาทนี้ใช้ได้เฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

ข้อความที่ระบุชื่อผู้ลงโฆษณาหรือชื่อแบรนด์

content ต้องเข้ารหัสแบบ UTF-8 โดยมีความยาวไม่เกิน 25 อักขระ

บทบาทนี้ใช้ได้เฉพาะใน creativeType ต่อไปนี้

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

ราคาซื้อแอปใน Google Play Store หรือ iOS App Store (เช่น $5.99)

โปรดทราบว่าระบบจะไม่ซิงค์ค่านี้กับค่าจริงที่แสดงในร้านค้าโดยอัตโนมัติ โดยจะเป็นรหัสที่ระบุไว้เมื่อบันทึกครีเอทีฟโฆษณาเสมอ

content ต้องเข้ารหัสแบบ UTF-8 โดยมีความยาวไม่เกิน 15 อักขระ

ชิ้นงานของบทบาทนี้เป็นแบบอ่านอย่างเดียว
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

ไอคอนของครีเอทีฟโฆษณา

บทบาทนี้รองรับและจำเป็นต้องใช้ใน creativeType ต่อไปนี้เท่านั้น

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

ภาพหน้าปกของครีเอทีฟโฆษณาวิดีโอเนทีฟ

บทบาทนี้รองรับและจำเป็นต้องใช้ใน creativeType ต่อไปนี้เท่านั้น

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

สีหลักที่จะใช้ในครีเอทีฟโฆษณา

บทบาทนี้รองรับและจำเป็นต้องใช้ใน creativeType ต่อไปนี้เท่านั้น

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

สีเฉพาะจุดที่จะใช้ในครีเอทีฟโฆษณา

บทบาทนี้รองรับและจำเป็นต้องใช้ใน creativeType ต่อไปนี้เท่านั้น

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

ครีเอทีฟโฆษณาต้องใช้ชิ้นงานรูปภาพหรือไม่

บทบาทนี้รองรับและจำเป็นต้องใช้ใน creativeType ต่อไปนี้เท่านั้น

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

ใช้การเพิ่มประสิทธิภาพชิ้นงานกับครีเอทีฟโฆษณาได้หรือไม่

บทบาทนี้รองรับและจำเป็นต้องใช้ใน creativeType ต่อไปนี้เท่านั้น

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

เหตุการณ์ทางออกของครีเอทีฟโฆษณา

การแสดง JSON 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
ช่อง
type

enum (ExitEventType)

ต้องระบุ ประเภทของเหตุการณ์การออก
url

string

ต้องระบุ URL การคลิกผ่านของเหตุการณ์การออก ต้องระบุเมื่อ type มีค่าเป็น

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

ไม่บังคับ ชื่อแท็กการคลิกของเหตุการณ์ทางออก

ชื่อต้องไม่ซ้ำกันภายในครีเอทีฟโฆษณา 1 รายการ

ปล่อยว่างไว้หรือไม่ได้ตั้งค่าสำหรับครีเอทีฟโฆษณาที่มีชิ้นงานรูปภาพเท่านั้น
reportingName

string

ไม่บังคับ ชื่อที่ใช้ระบุเหตุการณ์นี้ในรายงาน ปล่อยว่างไว้หรือไม่ได้ตั้งค่าสำหรับครีเอทีฟโฆษณาที่มีชิ้นงานรูปภาพเท่านั้น

ExitEventType

ประเภทของเหตุการณ์การออก

Enum
EXIT_EVENT_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทเหตุการณ์การออกหรือไม่รู้จักในเวอร์ชันนี้
EXIT_EVENT_TYPE_DEFAULT เหตุการณ์การออกเป็นเหตุการณ์เริ่มต้น
EXIT_EVENT_TYPE_BACKUP เหตุการณ์ทางออกเป็นเหตุการณ์ทางออกสํารอง ครีเอทีฟโฆษณาอาจมีเหตุการณ์ทางออกสำรองหลายรายการ

TimerEvent

เหตุการณ์ของเครื่องควบคุมเวลาของครีเอทีฟโฆษณา

การแสดง JSON 
{
  "name": string,
  "reportingName": string
}
ช่อง
name

string

ต้องระบุ ชื่อเหตุการณ์ตัวจับเวลา
reportingName

string

ต้องระบุ ชื่อที่ใช้ระบุเหตุการณ์ตัวจับเวลานี้ในรายงาน

CounterEvent

เหตุการณ์ตัวนับของครีเอทีฟโฆษณา

การแสดง JSON 
{
  "name": string,
  "reportingName": string
}
ช่อง
name

string

ต้องระบุ ชื่อเหตุการณ์ตัวนับ
reportingName

string

ต้องระบุ ชื่อที่ใช้ระบุเหตุการณ์ตัวนับนี้ในรายงาน

AudioVideoOffset

ระยะเวลาที่เล่นเสียงหรือวิดีโอ

การแสดง JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "percentage": string,
  "seconds": string
  // End of mutually exclusive fields.
}
ช่อง
ค่าของออฟเซ็ต ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
percentage

string (int64 format)

ไม่บังคับ ออฟเซ็ตเป็นเปอร์เซ็นต์ของระยะเวลาเสียงหรือวิดีโอ
seconds

string (int64 format)

ไม่บังคับ ออฟเซ็ตเป็นวินาทีจากจุดเริ่มต้นของเสียงหรือวิดีโอ
สิ้นสุดฟิลด์ที่แยกกัน

UniversalAdId

ตัวระบุครีเอทีฟโฆษณาที่ได้จากรีจิสทรีซึ่งไม่ซ้ำกันในทุกแพลตฟอร์ม ซึ่งเป็นส่วนหนึ่งของมาตรฐาน VAST 4.0

การแสดง JSON 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
ฟิลด์
id

string

ไม่บังคับ ตัวระบุครีเอทีฟโฆษณาที่ไม่ซ้ำกัน
registry

enum (UniversalAdRegistry)

ไม่บังคับ รีจิสทรีจะระบุตัวระบุครีเอทีฟโฆษณาที่ไม่ซ้ำกัน

UniversalAdRegistry

รีจิสทรีจะระบุตัวระบุครีเอทีฟโฆษณาที่ไม่ซ้ำกันในรหัสโฆษณาสากล

Enum
UNIVERSAL_AD_REGISTRY_UNSPECIFIED ไม่ได้ระบุรีจิสทรี Universal Ad หรือไม่รู้จักในเวอร์ชันนี้
UNIVERSAL_AD_REGISTRY_OTHER ใช้ผู้ให้บริการที่กำหนดเองเพื่อระบุรหัสโฆษณาสากล
UNIVERSAL_AD_REGISTRY_AD_ID ใช้ 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 (ThirdPartyUrlType),
  "url": string
}
ฟิลด์
type

enum (ThirdPartyUrlType)

ไม่บังคับ ประเภทการโต้ตอบที่ต้องติดตามโดย URL ติดตาม
url

string

ไม่บังคับ URL ติดตามที่ใช้เพื่อติดตามการโต้ตอบ

ระบุ URL ที่มีเส้นทางหรือสตริงการค้นหา (ไม่บังคับ) ซึ่งขึ้นต้นด้วย https: เช่น https://www.example.com/path

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 (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
ฟิลด์
name

string

ไม่บังคับ ชื่อไฟล์ที่แปลงแล้ว
mimeType

string

ไม่บังคับ ประเภท MIME ของไฟล์ที่แปลงแล้ว
transcoded

boolean

ไม่บังคับ ระบุว่าการแปลงรหัสสำเร็จหรือไม่
dimensions

object (Dimensions)

ไม่บังคับ ขนาดของวิดีโอที่แปลง
bitRateKbps

string (int64 format)

ไม่บังคับ อัตราบิตการแปลงของวิดีโอที่แปลงแล้ว มีหน่วยเป็นกิโลบิตต่อวินาที
frameRate

number

ไม่บังคับ อัตราเฟรมของวิดีโอที่แปลงแล้ว มีหน่วยเป็นเฟรมต่อวินาที
audioBitRateKbps

string (int64 format)

ไม่บังคับ อัตราบิตสำหรับสตรีมเสียงของวิดีโอที่แปลงแล้ว หรืออัตราบิตสำหรับเสียงที่แปลงแล้ว โดยมีหน่วยเป็นกิโลบิตต่อวินาที
audioSampleRateHz

string (int64 format)

ไม่บังคับ อัตราการสุ่มตัวอย่างสำหรับสตรีมเสียงของวิดีโอที่แปลงแล้ว หรืออัตราการสุ่มตัวอย่างสำหรับเสียงที่แปลงแล้วในหน่วยเฮิรตซ์
fileSizeBytes

string (int64 format)

ไม่บังคับ ขนาดของไฟล์ที่แปลงในหน่วยไบต์

CmTrackingAd

โฆษณาเพื่อการติดตามของ Campaign Manager 360

การแสดง JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
ฟิลด์
cmPlacementId

string (int64 format)

ไม่บังคับ รหัสตำแหน่งของโฆษณาเพื่อการติดตามของ Campaign Manager 360
cmCreativeId

string (int64 format)

ไม่บังคับ รหัสครีเอทีฟโฆษณาของโฆษณาเพื่อการติดตามของ Campaign Manager 360
cmAdId

string (int64 format)

ไม่บังคับ รหัสโฆษณาของโฆษณาเพื่อการติดตามของ Campaign Manager 360

ObaIcon

ไอคอน OBA สำหรับครีเอทีฟโฆษณา

การแสดง JSON 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
ฟิลด์
resourceUrl

string

ไม่บังคับ URL ของทรัพยากรไอคอน OBA
resourceMimeType

string

ไม่บังคับ ประเภท MIME ของทรัพยากรไอคอน OBA
position

enum (ObaIconPosition)

ไม่บังคับ ตำแหน่งของไอคอน OBA ในครีเอทีฟโฆษณา
dimensions

object (Dimensions)

ไม่บังคับ ขนาดของไอคอน OBA
program

string

ไม่บังคับ โปรแกรมของไอคอน OBA เช่น "AdChoices"
landingPageUrl

string

ต้องระบุ URL ของหน้า Landing Page ของไอคอน OBA

อนุญาตเฉพาะ URL ของโดเมนต่อไปนี้

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

ต้องระบุ URL ติดตามการคลิกของไอคอน OBA

อนุญาตเฉพาะ URL ของโดเมนต่อไปนี้

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

ต้องระบุ URL ติดตามการดูของไอคอน OBA

อนุญาตเฉพาะ URL ของโดเมนต่อไปนี้

  • https://info.evidon.com
  • https://l.betrad.com

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 ขยายได้ในแนวทแยงทุกทิศทาง

เมธอด

create

 สร้างครีเอทีฟโฆษณาใหม่

delete

 ลบครีเอทีฟโฆษณา

get

 รับครีเอทีฟโฆษณา

list

 แสดงรายการครีเอทีฟโฆษณาในผู้ลงโฆษณา

patch

 อัปเดตครีเอทีฟโฆษณาที่มีอยู่