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"
  • ใช้ตัวเปิดการใช้งาน (Enabledr.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)

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

รหัสโฆษณาสากลเป็นส่วนหนึ่งของมาตรฐาน 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

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[]

object (PublisherReviewStatus)

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

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),
  "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 เนื้อหานี้เป็นเนื้อหาโหลดแบบ 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 หรือ App Store ของ iOS (เช่น $5.99)

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

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 หรือ App Store ของ iOS

โปรดทราบว่าค่านี้จะไม่ซิงค์กับคะแนนจริงใน 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

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

ชื่อต้องไม่ซ้ำกันภายในครีเอทีฟโฆษณา 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 
{

  // 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 ใช้รหัสโฆษณาเพื่อระบุรหัสโฆษณาสากล
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 Tracking Ad
cmAdId

string (int64 format)

รหัสโฆษณาของ Campaign Manager 360 Tracking Ad

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 ตัวอย่างเช่น "ตัวเลือกโฆษณาอื่นๆ"
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

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