คำขอของกลุ่มแต่ละรายการที่สร้างขึ้นโดยใช้การแสดงพ็อดการเปลี่ยนเส้นทางกลุ่มต้องมีฟิลด์ โทเค็นที่ลงนามโดย HMAC สำหรับการตรวจสอบสิทธิ์ หากไม่ได้ใช้ การแจ้งเตือนช่วงพักโฆษณาล่วงหน้า
ระบบคำนวณโทเค็นนี้ได้ 1 ครั้งต่อช่วงพักโฆษณา 1 รายการและแชร์ไปยังสตรีมทั้งหมด เซสชัน
รวบรวมพารามิเตอร์โทเค็น
รวบรวมข้อมูลต่อไปนี้จากช่วงพักโฆษณาปัจจุบันเพื่อป้อนข้อมูลให้กับ เนื้อหาของโทเค็น
| พารามิเตอร์โทเค็น | ||
|---|---|---|
custom_asset_key
|
ต้องระบุ | คีย์เนื้อหาสตรีมแบบสดที่กำหนดเองจาก Google Ad Manager |
cust_params
|
ไม่บังคับ | พารามิเตอร์การกำหนดเป้าหมายเอง ดูcust_params
|
exp
|
ต้องระบุ | การประทับเวลาการหมดอายุสำหรับโทเค็นนี้ในหน่วยวินาที |
network_code
|
ต้องระบุ | รหัสเครือข่าย Ad Manager 360 สำหรับเครือข่ายนี้ |
pod_id
|
ต้องระบุ | ตัวระบุช่วงพักโฆษณา ควรเป็นจำนวนเต็มที่เริ่มต้นที่
1 และเพิ่มขึ้น 1 รายการต่อช่วงพักโฆษณา
ค่านี้ต้องเหมือนกันสำหรับผู้ใช้ทั้งหมดที่ดูช่วงพักโฆษณาเดียวกันใน เหตุการณ์ปัจจุบัน |
pd
|
ต้องระบุ ยกเว้นเหตุการณ์ที่เปิดใช้ช่วงพักโฆษณาแบบไม่กำหนดระยะเวลา | ระยะเวลาเป็นมิลลิวินาทีของช่วงพักโฆษณา เรียกข้างต้นว่า
ad_pod_duration
|
scte35
|
ไม่บังคับ | สัญญาณ SCTE-35 ที่เข้ารหัส Base64 ลูกค้ามีหน้าที่ตรวจสอบ
ว่าสัญญาณถูกต้อง หากไม่ถูกต้อง ระบบจะส่งข้อความไปยัง
ส่วนหัว HTTP ของ X-Ad-Manager-Dai-Warning ในการตอบกลับและ
ยังคงกระจายสัญญาณเพื่อสร้างช่วงพักโฆษณา ดูที่ที่รองรับ
ตัวทำเครื่องหมายโฆษณาสำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ DAI ใช้สัญญาณ SCTE-35
|
สร้างสตริงโทเค็น
แสดงพารามิเตอร์แต่ละรายการตามลำดับตัวอักษรในรูปแบบ name=value โดยที่แต่ละรายการ
คู่ชื่อ-ค่าคั่นด้วยอักขระเครื่องหมายทิลเดอ (~)
สามารถวางพารามิเตอร์ที่ไม่บังคับโดยไม่มีค่าไว้ในสตริงว่าง สำหรับค่า หรือนำออกไปเลย
รูปแบบสตริงโทเค็น
custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}
สร้างลายเซ็น HMAC
ลายเซ็น HMAC คือแฮช SHA-256 ของสตริงโทเค็นในรูปแบบ HEX คีย์ลับคือ คีย์การตรวจสอบสิทธิ์ HMAC ที่เชื่อมโยงกับกิจกรรมสตรีมแบบสดใน Google Ad Manager
ลงนามสตริงโทเค็น
เมื่อสร้างแล้ว ให้ใส่ลายเซ็น HMAC ต่อท้ายสตริงโทเค็นต่อไปนี้ รูปแบบ
~hmac={HMAC signature}
สตริงโทเค็นที่เข้ารหัส URL
ระบบจะส่งโทเค็นนี้เป็นพารามิเตอร์ของ URL ดังนั้นจึงต้องเข้ารหัส URL เพื่อความปลอดภัย
ตัวอย่างที่ 1
ตัวอย่างพารามิเตอร์ที่ไม่บังคับซึ่งไม่มีการใช้งานซึ่งรวมไว้ว่าเป็นค่าว่าง สตริง
สตริงโทเค็น
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
คีย์รหัสลับ
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
ลายเซ็น HMAC
86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
โทเค็นที่ลงนามแล้ว
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
โทเค็นที่ลงชื่อซึ่งเข้ารหัส URL:
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~cust_params%3D~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3D86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
ตัวอย่างที่ 2
ต่อไปนี้เป็นตัวอย่างที่มีการละตัวแปรที่ไม่บังคับที่ไม่ได้สร้างไว้ทั้งหมด
สตริงโทเค็น
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g3~exp=1489680000~network_code=6062~pd=180000~pod_id=5
คีย์รหัสลับ
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
ลายเซ็น HMAC
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
โทเค็นที่ลงนามแล้ว
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
โทเค็นที่รับรองซึ่งเข้ารหัส URL
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9