Mỗi yêu cầu về phân đoạn hoặc tệp kê khai được thực hiện bằng cách sử dụng tính năng phân phát nhóm phải bao gồm một mã thông báo được ký bằng HMAC để xác thực, làm phương án dự phòng cho thông báo sớm về điểm chèn quảng cáo.
Bạn có thể tính mã thông báo này một lần cho mỗi điểm chèn quảng cáo và chia sẻ trên tất cả các phiên phát trực tiếp.
Thu thập các thông số mã thông báo
Thu thập thông tin sau đây từ đoạn chèn quảng cáo hiện tại để điền vào phần 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.
|
Giá trị nhận dạng chuỗi của đ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 tuỳ chỉnh của sự kiện phát trực tiếp, từ Google Ad Manager. |
cust_params
|
Không bắt buộc | Thông số nhắm mục tiêu tuỳ chỉnh cho khoảng thời gian 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 của sự kiệ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 của 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.
|
Giá trị nhận dạng bằng số cho điểm chèn quảng cáo. |
pd
|
Bắt buộc, ngoại trừ những sự kiện đã bật điểm chèn quảng cáo không có thời lượng. | 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 thông số theo thứ tự bảng chữ cái, theo định dạng name=value, với mỗi cặp tên-giá trị được phân tách bằng ký tự dấu ngã (~).
Bạn có thể giữ nguyên các thông số không bắt buộc mà không có giá trị bằng cách đặt giá trị là một chuỗi trống 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.
Chuỗi mã thông báo chữ ký
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 một tham số URL, vì vậy, bạn phải mã hoá mã thông báo này thành URL để đảm bảo an toàn.
Ví dụ 1
Dưới đây là một ví dụ về các tham số không bắt buộc chưa 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
Sau đây là ví dụ về trường hợp 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
Sau đây là một ví dụ về cách dùng 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