มาโครสําหรับการแทรกโฆษณาแบบไดนามิก

ดูข้อมูลเพิ่มเติมเกี่ยวกับมาโคร ซึ่งรวมถึงวิธีการทำงานกับ Ad Manager และรายการที่สมบูรณ์ของมาโครการแสดงผล มาโครการติดตาม และมาโครวิดีโออื่นๆ

ข้ามไปยังมาโครที่เฉพาะเจาะจงในรายการ

มาโครคำขอโฆษณา _{เฟรมเวิร์ก API App Bundle คีย์เนื้อหา ระยะเวลาสูงสุดของช่วงพักโฆษณา} ตำแหน่งช่วงพักโฆษณา _{การป้องกันแคช รหัสลูกค้า รหัส CMS โดเมน FW Ciad GDPR (ความยินยอมตาม GDPR) Nonce โฆษณาวิดีโอในสตรีมของ Google}	_{IFA ประเภท IFA จํากัดการติดตาม Media mIme โฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้ พาร์ทเนอร์ OMID URL ของหน้าเว็บ ประเภทตำแหน่ง กฎระเบียบ SCTE-35 ฝั่งเซิร์ฟเวอร์ รหัสสตรีม TFCD}	_{TFUA การประทับเวลา รหัสธุรกรรม ความเป็นส่วนตัวในสหรัฐอเมริกา User Agent ที่อยู่ IP ของผู้ใช้ ระยะเวลาของวิดีโอ ระยะเวลาของวิดีโอในหน่วยวินาที รหัสวิดีโอ ชื่อวิดีโอ}
มาโครการติดตาม VAST _{การป้องกันแคช รหัสข้อผิดพลาด}

ขยายทั้งหมด ยุบทั้งหมด

มาโครคำขอโฆษณา

มาโครคำขอโฆษณาที่แสดงที่นี่ใช้ได้เฉพาะในแท็กโฆษณาสำหรับการแทรกโฆษณาแบบไดนามิก (DAI) สำหรับแหล่งที่มาของเนื้อหาวิดีโอออนดีมานด์หรือสตรีมแบบสดเท่านั้น โดยจะไม่ทํางานในบริบทของครีเอทีฟโฆษณา VAST

โดยทั่วไปจะต้องใช้มาโครวงเล็บเหลี่ยมเพื่อให้ผ่านการตรวจสอบของมาโคร Ad Manager สำหรับการเปลี่ยนเส้นทาง

เฟรมเวิร์ก API

มาโคร
`[APIFRAMEWORKS]`

พารามิเตอร์ sdk_apis

APP Bundle

มาโคร
`[APPBUNDLE]`

พารามิเตอร์ an

คีย์เนื้อหา

มาโคร
`%%ASSET_KEY%%`

ขยายเป็นรหัสเหตุการณ์ไลฟ์สด

ตำแหน่งช่วงพักโฆษณา

มาโคร
`[BREAKPOSITION]`

มาโคร VAST 4.1 ค่าที่แสดงผล

1: สำหรับโฆษณาตอนต้น
2: สำหรับโฆษณาตอนกลาง
3: สำหรับโฆษณาตอนท้าย
4: สำหรับโฆษณาแบบสแตนด์อโลน
0: สำหรับที่ไม่ใช่ทั้งหมดข้างต้น/อื่นๆ

ระยะเวลาสูงสุดของช่วงพักโฆษณา

มาโคร
`%%BREAK_DURATION%%`
`[BREAKMAXDURATION]`

ระยะเวลาของช่วงพักโฆษณาปัจจุบัน หน่วยเป็นวินาที

[BREAKMAXDURATION] ควรใช้เฉพาะกับการเปลี่ยนเส้นทาง Ad Manager ที่ไม่อนุญาต %%BREAK_DURATION%% เท่านั้น

การป้องกันแคช

มาโคร
`[CACHEBUSTING]`

เลขสุ่ม

รหัสลูกค้า

มาโคร
`[CLIENTUA]`

รหัสของโปรแกรมเล่นและ VAST ที่ลูกค้าใช้

รหัส CMS

มาโคร
`%%CMS_ID%%`

ขยายเป็นรหัสแหล่งที่มาของเนื้อหา Ad Manager ("รหัส CMS") ที่เล่นอยู่ในขณะนั้น ค่านี้ไม่ปรากฏในฟีด MRSS แต่มองเห็นได้ในอินเทอร์เฟซของ Ad Manager

โดเมน

มาโคร
`[DOMAIN]`

มาโคร VAST 4.1 โดเมนของ URL ที่มาของการสร้างสตรีม

มาโคร
`%%FW_CAID%%`

สำหรับ VOD เท่านั้น - รหัสชิ้นงานที่กำหนดเองของ FreeWheel จากฟีด MRSS

GDPR

มาโคร
`%%GDPR%%`

พารามิเตอร์ gdpr

(ความยินยอมตาม GDPR)

มาโคร
`[GDPRCONSENT]`

พารามิเตอร์ gdpr_consent

Nonce โฆษณาวิดีโอในสตรีมของ Google

มาโคร
`[GOOGLE_INSTREAM_VIDEO_NONCE]`

พารามิเตอร์ givn

IFA

มาโคร
`[IFA]`

รหัสโฆษณาที่รีเซ็ตได้ซึ่งนํามาจากพารามิเตอร์ rdid ระบบจะส่งรหัสโฆษณาไปยังคําขอโฆษณาหลักก็ต่อเมื่อได้รับอนุญาตจากแฟล็กความเป็นส่วนตัว (เช่น tfcd และ is_lat)

ประเภท IFA

มาโคร
`[IFATYPE]`

พารามิเตอร์ DAI idtype ระบบจะส่งประเภท IFA ไปยังคําขอโฆษณาหลักก็ต่อเมื่อได้รับอนุญาตจากแฟล็กความเป็นส่วนตัว (เช่น tfcd และ is_lat)

การติดตามแบบจํากัด

มาโคร
`[LIMITEDTRACKING]`

พารามิเตอร์ ltd

Mediamime

มาโคร
`[MEDIAMIME]`

มาโคร VAST 4.1: รายการประเภท MIME ของสื่อที่รองรับโดยคั่นด้วยคอมมา

โฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้

มาโคร
`%%NPA%%`

ขยายเป็นค่า 1 เพื่อแท็กคำขอเป็นโฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้

มาโครนี้ใช้กับคําขอโฆษณาที่อยู่ภายใต้ GDPR และใช้ได้เฉพาะในแท็กโฆษณาสําหรับการแทรกโฆษณาแบบไดนามิก ดูมาโครสําหรับ GDPR อื่นๆ

พาร์ทเนอร์ OMID

มาโคร
`[OMIDPARTNER]`

มาโคร VAST 4.1: พารามิเตอร์ omid_p

URL ของหน้าเว็บ

มาโคร
`[PAGEURL]`

มาโคร VAST 4.1: URL ที่มาของการสร้างสตรีม

ประเภทตำแหน่ง

มาโคร
`[PLACEMENTTYPE]`

มาโคร VAST 4.1: สำหรับ DAI ค่าจะเป็น 1 (ในสตรีม) เสมอ

ดูวิดีโอประเภทย่อยของตำแหน่ง AdCOM

กฎระเบียบ

มาโคร
`[REGULATIONS]`

มาโคร VAST 4.1: รายการกฎระเบียบที่เกี่ยวข้องซึ่งคั่นด้วยเครื่องหมายจุลภาค โดยอิงตามพารามิเตอร์ การมี tfcd=1 จะเพิ่ม "coppa" และ gdpr=1 จะเพิ่ม "gdpr"

ฝั่งเซิร์ฟเวอร์

มาโคร
`[SERVERSIDE]`

มาโคร VAST 4.1 - เป็นค่า 1 เสมอ

SCTE-35

มาโคร
`%%SPLICE_INSERT_EVENT_ID%%`
`%%SPLICE_INSERT_UPID%%`
`%%TIME_SIGNAL_EVENT_ID%%`
`%%TIME_SIGNAL_UPID%%`
`%%TIME_SIGNAL_UPID_RAW%%`
`%%AFMM_CBC%%`

ขยายเป็นสัญญาณ SCTE-35

รหัสสตรีม

มาโคร
`%%STREAM_ID%%`

ขยายเป็นรหัสสตรีมเซสชันสำหรับแหล่งที่มาของเนื้อหาที่กำลังเล่นอยู่

TFCD

มาโคร
`%%TFCD%%`

ขยายเป็นค่าของพารามิเตอร์ tfcd

TFUA

มาโคร
`%%TFUA%%`

พารามิเตอร์ tfua

การประทับเวลา

มาโคร
`[TIMESTAMP]`

มาโคร VAST 4.0 - การประทับเวลาปัจจุบันที่จัดรูปแบบตาม ISO 8601

รหัสธุรกรรม

มาโคร
`[TRANSACTIONID]`

มาโคร VAST 4.1 - ตัวระบุที่ใช้เพื่อเชื่อมโยงเชนคำขอโฆษณาจากจุดเริ่มต้น

ความเป็นส่วนตัวในสหรัฐอเมริกา

มาโคร
`%%US_PRIVACY%%`

ขยายเป็นค่าของพารามิเตอร์ us_privacy

User Agent

มาโคร
`%%USER_AGENT%%`
`[DEVICEUA]`

User Agent ของอุปกรณ์ที่แสดงโฆษณาต่อผู้ใช้ปลายทาง

ในกรณีของการเปลี่ยนเส้นทาง VAST เฉพาะมาโคร [DEVICEUA] เท่านั้นที่จะทำงานตามที่คาดไว้

ที่อยู่ IP ของผู้ใช้

มาโคร
`%%USER_IP%%`
`[DEVICEIP]`
`[IP_ADDRESS]`

ขยายเป็นที่อยู่ IP ของผู้ใช้

[IP_ADDRESS] ควรใช้เฉพาะสำหรับการเปลี่ยนเส้นทาง Ad Manager ที่ไม่อนุญาตให้ใช้ %%USER_IP%% เท่านั้น

ระยะเวลาของวิดีโอ

มาโคร
`%%VIDEO_DURATION%%`

VOD เท่านั้น - ระยะเวลาของวิดีโอเป็นมิลลิวินาทีจากฟีด MRSS

ระยะเวลาของวิดีโอ หน่วยเป็นวินาที

มาโคร
`%%VIDEO_DURATION_SEC%%`

ขยายเป็นระยะเวลาของวิดีโอ หน่วยเป็นวินาที

รหัสวิดีโอ

มาโคร
`%%VIDEO_ID%%`

VOD เท่านั้น - รหัสเนื้อหา CMS จากฟีด MRSS

ชื่อวิดีโอ

มาโคร
`%%VIDEO_TITLE%%`

VOD เท่านั้น - ชื่อวิดีโอจากฟีด MRSS

มาโครการติดตาม VAST

ทั้งมาโคร [CACHEBUSTING] และมาโคร [ERRORCODE] เป็นไปตามข้อกำหนด VAST 4.0 (ดูส่วน "2.3.7 มาโคร")

การป้องกันแคช

มาโคร
`[CACHEBUSTING]`

ขยายเป็นตัวเลขแบบสุ่ม 8 หลัก

รหัสข้อผิดพลาด

มาโคร
`[ERRORCODE]`

ขยายเป็นรหัสข้อผิดพลาด VAST

หากมีปัญหาใดๆ เกี่ยวกับการแก้ปัญหาหรือการหยุดทำงานของ DAI โปรดติดต่อทีมสนับสนุนผู้เผยแพร่โฆษณา

ข้อมูลนี้มีประโยชน์ไหม

เราจะปรับปรุงได้อย่างไร

มาโครสําหรับการแทรกโฆษณาแบบไดนามิก

ข้ามไปยังมาโครที่เฉพาะเจาะจงในรายการ

มาโครคำขอโฆษณา

มาโครการติดตาม VAST

ข้อมูลนี้มีประโยชน์ไหม

หากต้องการความช่วยเหลือเพิ่มเติม

ลองทำตามขั้นตอนต่อไปนี้