Mỗi yêu cầu về phân đoạn hoặc tệp kê khai được thực hiện bằng tính năng phân phát nhóm quảng cáo phải bao gồm một mã thông báo được ký bằng HMAC để xác thực, như một phương án dự phòng cho thông báo sớm về điểm chèn quảng cáo.
Mã thông báo này có thể được tính toán một lần cho mỗi điểm chèn quảng cáo và được chia sẻ trên tất cả các phiên phát trực tiếp.
Thu thập các tham số mã thông báo
Thu thập thông tin sau đây từ điểm chèn quảng cáo hiện tại để điền vào nội dung mã thông báo.
| Tham số mã thông báo | ||
|---|---|---|
ad_break_id
|
Bắt buộc nếu bạn không cung cấp tham số pod_id.
|
Mã nhận dạng chuỗi cho điểm chèn quảng cáo. |
custom_asset_key
|
Bắt buộc nếu bạn không cung cấp tham số event.
|
Khoá tài sản phát trực tiếp tuỳ chỉnh, từ Google Ad Manager. |
cust_params
|
Không bắt buộc | Các tham số nhắm mục tiêu tuỳ chỉnh cho điểm chèn quảng cáo. |
event
|
Bắt buộc nếu bạn không cung cấp tham số custom_asset_key.
|
Khoá tài sản phát trực tiếp do Google Ad Manager tạo. |
exp
|
Bắt buộc | Dấu thời gian hết hạn cho mã thông báo này tính bằng giây. |
network_code
|
Bắt buộc nếu bạn cung cấp tham số custom_asset_key.
|
Mã mạng Ad Manager 360 cho mạng này. |
pod_id
|
Bắt buộc nếu bạn không cung cấp tham số ad_break_id.
|
Mã nhận dạng số cho điểm chèn quảng cáo. |
pd
|
Bắt buộc, ngoại trừ các sự kiện có điểm chèn quảng cáo không có thời lượng được bật. | Thời lượng của điểm chèn quảng cáo tính bằng mili giây. |
scte35
|
Không bắt buộc | Tín hiệu SCTE-35 được mã hoá Base64 cho điểm chèn quảng cáo. |
Tạo chuỗi mã thông báo
liệt kê từng tham số theo thứ tự bảng chữ cái, ở định dạng name=value, với mỗi
cặp tên-giá trị được phân tách bằng dấu ngã (~).
Bạn có thể giữ nguyên các tham số không bắt buộc mà không có giá trị bằng một chuỗi trống cho giá trị hoặc xoá hoàn toàn.
định dạng chuỗi mã thông báo
custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}
Tạo chữ ký HMAC
Chữ ký HMAC là hàm băm SHA-256 của chuỗi mã thông báo ở định dạng HEX. Khoá bí mật là khoá xác thực HMAC được liên kết với sự kiện phát trực tiếp của bạn trong Google Ad Manager.
Ký chuỗi mã thông báo
Sau khi tạo, hãy thêm chữ ký HMAC vào chuỗi mã thông báo theo định dạng sau
~hmac={HMAC signature}
Mã hoá URL chuỗi mã thông báo
Mã thông báo này được truyền dưới dạng tham số URL, vì vậy, bạn phải mã hoá URL để đảm bảo an toàn.
Ví dụ 1
Dưới đây là một ví dụ trong đó các tham số không bắt buộc không dùng được đưa vào dưới dạng chuỗi trống.
Chuỗi mã thông báo
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
Khoá bí mật
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Chữ ký HMAC
ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
Mã thông báo đã ký
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
Mã thông báo đã ký được mã hoá URL:
cust_params%3D~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3Dea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
Ví dụ 2
Dưới đây là một ví dụ trong đó các biến không bắt buộc chưa được điền sẽ bị bỏ qua hoàn toàn.
Chuỗi mã thông báo
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5
Khoá bí mật
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Chữ ký HMAC
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Mã thông báo đã ký
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Mã thông báo đã ký được mã hoá URL
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Ví dụ 3
Dưới đây là một ví dụ về ad_break_id.
Chuỗi mã thông báo
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000
Khoá bí mật
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Chữ ký HMAC
327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
Mã thông báo đã ký
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~hmac=327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
Mã thông báo đã ký được mã hoá URL
ad_break_id%3Dadbreak1~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~hmac%3D327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29