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
}
ช่อง
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)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
createTime

string (Timestamp format)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
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.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 เป็นจริง

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

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

ระยะเวลาในการเล่นวิดีโอก่อนที่จะนับยอดดู

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

ช่องนี้ใช้ได้กับ creativeType ต่อไปนี้เท่านั้น

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

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

รหัสโฆษณาแบบ Universal เป็นส่วนหนึ่งของมาตรฐาน 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 (ระบบข้อกําหนดอินเทอร์เฟซโฆษณาแบบริชมีเดียบนอุปกรณ์เคลื่อนที่)

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

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

ครีเอทีฟโฆษณาแท็กของบุคคลที่สามคือครีเอทีฟโฆษณาที่มี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

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

ใช้ได้เฉพาะเมื่อใช้โฆษณาการติดตามของ 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

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)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
ช่อง
approvalStatus

enum (ApprovalStatus)

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

enum (ReviewStatus)

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

enum (ReviewStatus)

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

object (ExchangeReviewStatus)

แลกเปลี่ยนสถานะการตรวจสอบครีเอทีฟโฆษณา
publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

สถานะการตรวจสอบครีเอทีฟโฆษณาของผู้เผยแพร่โฆษณา

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

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

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

PublisherReviewStatus

สถานะการตรวจสอบครีเอทีฟโฆษณาของผู้เผยแพร่โฆษณา

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

string

ผู้เผยแพร่โฆษณาที่ตรวจสอบครีเอทีฟโฆษณา
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 ชิ้นงานนี้เป็นชิ้นงานที่โหลดอย่างสุภาพของครีเอทีฟโฆษณา
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 หรือ App Store ของ iOS (เช่น $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 ใน App Store ของ Apple

หมายเลขรหัสนี้จะอยู่ใน URL ของ Apple App Store เป็นสตริงตัวเลขที่อยู่หลัง "id" โดยตรง เช่น ใน https://apps.apple.com/th/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

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

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

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

เว้นว่างไว้หรือไม่ได้ตั้งค่าสำหรับครีเอทีฟโฆษณาที่มีเฉพาะชิ้นงานรูปภาพ
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 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
ช่อง
ช่องการรวม offset ค่าของออฟเซต offset ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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
UNIVERSAL_AD_REGISTRY_CM ใช้ Campaign Manager 360 เพื่อระบุรหัสโฆษณาแบบ Universal

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 ของโดเมนต่อไปนี้เท่านั้น
clickTrackingUrl

string

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

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

string

ต้องระบุ 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 สามารถขยายในทิศทางใดก็ได้ตามแนวทแยงมุม

เมธอด

create

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

delete

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

get

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

list

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

patch

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