คำขอแต่ละกลุ่มหรือคำขอไฟล์ Manifest ที่สร้างขึ้นโดยใช้การแสดงพ็อดต้องมีโทเค็นที่ลงนามด้วย HMAC สำหรับการตรวจสอบสิทธิ์ ซึ่งเป็นตัวเลือกสำรองของการแจ้งเตือนช่วงพักโฆษณาล่วงหน้า
โทเค็นนี้จะคำนวณได้ 1 ครั้งต่อช่วงพักโฆษณา และแชร์ในเซสชันสตรีมทั้งหมด
รวบรวมพารามิเตอร์โทเค็น
รวบรวมข้อมูลต่อไปนี้จากช่วงพักโฆษณาปัจจุบันเพื่อสร้าง เนื้อหาโทเค็น
| พารามิเตอร์โทเค็น | ||
|---|---|---|
ad_break_id
|
ต้องระบุหากไม่ได้ระบุพารามิเตอร์ pod_id
|
ตัวระบุสตริงสำหรับช่วงพักโฆษณา |
custom_asset_key
|
ต้องระบุหากไม่ได้ระบุพารามิเตอร์ event
|
คีย์ชิ้นงานไลฟ์สดที่กำหนดเองจาก Google Ad Manager |
cust_params
|
ไม่บังคับ | พารามิเตอร์การกำหนดเป้าหมายที่กำหนดเองสำหรับช่วงพักโฆษณา |
event
|
ต้องระบุหากไม่ได้ระบุพารามิเตอร์ custom_asset_key
|
คีย์ชิ้นงานของไลฟ์สดที่สร้างโดย Google Ad Manager |
exp
|
ต้องระบุ | การประทับเวลาการหมดอายุของโทเค็นนี้เป็นวินาที |
network_code
|
ต้องระบุหากระบุพารามิเตอร์ custom_asset_key
|
รหัสเครือข่าย Ad Manager 360 สำหรับเครือข่ายนี้ |
pod_id
|
ต้องระบุหากไม่ได้ระบุพารามิเตอร์ ad_break_id
|
ตัวระบุที่เป็นตัวเลขสำหรับช่วงพักโฆษณา |
pd
|
ต้องระบุ ยกเว้นกิจกรรมที่เปิดใช้ช่วงพักโฆษณาแบบไม่ระบุระยะเวลา | ระยะเวลาของช่วงพักโฆษณาเป็นมิลลิวินาที |
scte35
|
ไม่บังคับ | สัญญาณ SCTE-35 ที่เข้ารหัส Base64 สำหรับช่วงพักโฆษณา |
สร้างสตริงโทเค็น
แสดงพารามิเตอร์แต่ละรายการตามลำดับตัวอักษรในรูปแบบ 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
ตัวอย่างต่อไปนี้แสดงให้เห็นว่าพารามิเตอร์ที่ไม่บังคับที่ไม่ได้ใช้จะรวมเป็นสตริงว่าง
สตริงโทเค็น
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
คีย์รหัสลับ
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
ลายเซ็น HMAC
ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
โทเค็นที่ลงชื่อ
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
โทเค็นที่ลงนามซึ่งเข้ารหัส URL
cust_params%3D~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3Dea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
ตัวอย่างที่ 2
ต่อไปนี้เป็นตัวอย่างที่ละเว้นตัวแปรที่ไม่บังคับซึ่งไม่ได้ระบุค่าทั้งหมด
สตริงโทเค็น
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~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
ตัวอย่างที่ 3
ตัวอย่างการใช้ ad_break_id
สตริงโทเค็น
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000
คีย์รหัสลับ
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
ลายเซ็น HMAC
327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
โทเค็นที่ลงชื่อ
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~hmac=327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
โทเค็นที่ลงนามซึ่งเข้ารหัส URL
ad_break_id%3Dadbreak1~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~hmac%3D327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29