Jede Segment- oder Manifestanfrage, die über die Pod-Bereitstellung erfolgt, muss ein HMAC-signiertes Token für die Authentifizierung enthalten, als Fallback für frühe Benachrichtigungen zu Werbeunterbrechungen.
Dieses Token kann einmal pro Werbeunterbrechung berechnet und für alle Stream sitzungen freigegeben werden.
Tokenparameter erfassen
Erfassen Sie die folgenden Informationen aus der aktuellen Werbeunterbrechung, um den Token-Body zu füllen.
| Tokenparameter | ||
|---|---|---|
ad_break_id
|
Erforderlich, wenn der pod_id Parameter nicht angegeben ist.
|
Die String-ID für die Werbeunterbrechung. |
custom_asset_key
|
Erforderlich, wenn der Parameter event nicht angegeben ist.
|
Der benutzerdefinierte Livestream-Asset-Schlüssel aus Google Ad Manager. |
cust_params
|
Optional | Die benutzerdefinierten Targeting-Parameter für die Werbeunterbrechung. |
event
|
Erforderlich, wenn der Parameter custom_asset_key nicht angegeben ist.
|
Der Livestream-Asset-Schlüssel, der von Google Ad Manager generiert wurde. |
exp
|
Erforderlich | Der Ablauf-Zeitstempel für dieses Token in Sekunden. |
network_code
|
Erforderlich, wenn der Parameter custom_asset_key angegeben ist.
|
Der Ad Manager 360-Netzwerkcode für dieses Netzwerk. |
pod_id
|
Erforderlich, wenn der Parameter ad_break_id nicht angegeben ist.
|
Die numerische ID für die Werbeunterbrechung. |
pd
|
Erforderlich, außer bei Ereignissen, bei denen Werbeunterbrechungen ohne Dauer aktiviert sind. | Die Dauer der Werbeunterbrechung in Millisekunden. |
scte35
|
Optional | Das Base64-codierte SCTE-35-Signal für die Werbeunterbrechung. |
Token-String erstellen
Listen Sie jeden Parameter in alphabetischer Reihenfolge im Format name=value auf. Trennen Sie die einzelnen
Name-Wert-Paare durch eine Tilde (~).
Optionale Parameter ohne Wert können mit einem leeren String für den Wert beibehalten oder vollständig entfernt werden.
Format des Token-Strings
custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}
HMAC-Signatur generieren
Die HMAC-Signatur ist ein SHA-256-Hash des Token-Strings im HEX-Format. Der Secret-Schlüssel ist der HMAC-Authentifizierungsschlüssel , der mit Ihrem Livestream-Ereignis in Google Ad Manager verknüpft ist.
Token-String signieren
Hängen Sie die HMAC-Signatur nach der Generierung im folgenden Format an den Token-String an:
~hmac={HMAC signature}
Token-String URL-codieren
Dieses Token wird als URL-Parameter übergeben und muss daher aus Sicherheitsgründen URL-codiert sein.
Beispiel 1
Hier sehen Sie ein Beispiel, in dem nicht verwendete optionale Parameter als leere Strings enthalten sind.
Token-String
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
Secret-Schlüssel
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
HMAC-Signatur
ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
Signiertes Token
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
URL-codiertes signiertes Token:
cust_params%3D~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3Dea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
Beispiel 2
Hier sehen Sie ein Beispiel, in dem die nicht gefüllten optionalen Variablen vollständig weggelassen werden.
Token-String
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5
Secret-Schlüssel
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
HMAC-Signatur
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Signiertes Token
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
URL-codiertes signiertes Token
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Beispiel 3
Hier sehen Sie ein Beispiel mit ad_break_id.
Token-String
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000
Secret-Schlüssel
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
HMAC-Signatur
327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
Signiertes Token
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~hmac=327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
URL-codiertes signiertes Token
ad_break_id%3Dadbreak1~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~hmac%3D327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29