สร้างโทเค็น HMAC ที่ลงนาม

คำขอของกลุ่มแต่ละรายการที่สร้างขึ้นโดยใช้การแสดงพ็อดการเปลี่ยนเส้นทางกลุ่มต้องมีฟิลด์ โทเค็นที่ลงนามโดย 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