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

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

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

มาโครคำขอโฆษณา _{เฟรมเวิร์ก API APP Bundle คีย์เนื้อหา ระยะเวลาสูงสุดของช่วงพักโฆษณา ตำแหน่งช่วงพักโฆษณา การป้องกันแคช รหัสลูกค้า รหัส CMS DAI_PRE โดเมน FW CAID 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

DAI_PRE

มาโคร
`%%DAI_PRE%%`

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

ใช้ได้กับการเข้าชมแบบไลฟ์สดเท่านั้น

โดเมน

มาโคร
`[DOMAIN]`

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

FW CAID

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

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

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

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

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

มาโคร
`[GDPRCONSENT]`

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

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

มาโคร
`[GOOGLE_INSTREAM_VIDEO_NONCE]`

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

IFA

มาโคร
`[IFA]`

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

ประเภท IFA

มาโคร
`[IFATYPE]`

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

จำกัดการติดตามโฆษณา

มาโคร
`[LIMITADTRACKING]`

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

Media MIME

มาโคร
`[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 โปรดติดต่อทีมสนับสนุนผู้เผยแพร่โฆษณา

มาโครในสตริงที่เข้ารหัส URL

หากต้องใช้มาโครในส่วนแท็กโฆษณาที่ควรเข้ารหัส URL ก็ไม่ควรเข้ารหัสมาโครเองเพื่อให้การเปลี่ยนมาโครทํางานอย่างถูกต้อง

ตัวอย่าง

การใช้มาโคร Nonce ของโฆษณาวิดีโอในสตรีมของ Google ในพารามิเตอร์การค้นหาที่ต้องเข้ารหัส URL

ถูกต้อง
http://www.some-adtag.com?encoded_param=[GOOGLE_INSTREAM_VIDEO_NONCE]%3D5

ไม่ถูกต้อง
http://www.some-adtag.com?encoded_param=%5BGOOGLE_INSTREAM_VIDEO_NONCE%5D%3D5

หน้านี้อาจมีเนื้อหาที่แปลโดยใช้เทคโนโลยี AI การแปลโดย AI อาจมีข้อผิดพลาด

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

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

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

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

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

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

มาโครในสตริงที่เข้ารหัส URL

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

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

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