Jede Segment- oder Manifestanfrage, die über die Pod-Bereitstellung erfolgt, muss ein HMAC-signiertes Token zur Authentifizierung enthalten, als Fallback für Benachrichtigungen über frühe Werbeunterbrechungen.
Dieses Token kann einmal pro Werbeunterbrechung berechnet und für alle Streamsitzungen freigegeben werden.
Token-Parameter erfassen
Erfassen Sie die folgenden Informationen aus der aktuellen Werbeunterbrechung, um den Token-Body zu füllen.
| Tokenparameter | ||
|---|---|---|
ad_break_id
|
Erforderlich, wenn der Parameter pod_id nicht angegeben wird.
|
Die String-Kennung für die Werbeunterbrechung. |
custom_asset_key
|
Erforderlich, wenn der Parameter event nicht angegeben wird.
|
Der benutzerdefinierte Asset-Schlüssel für Livestreams 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 wird.
|
Der von Google Ad Manager generierte Asset-Schlüssel des Livestreams. |
exp
|
Erforderlich | Ablaufzeitstempel für dieses Token in Sekunden. |
network_code
|
Erforderlich, wenn der Parameter custom_asset_key angegeben wird.
|
Der Ad Manager 360-Netzwerkcode für dieses Netzwerk. |
pod_id
|
Erforderlich, wenn der Parameter ad_break_id nicht angegeben wird.
|
Die numerische Kennung 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.
Token-Stringformat
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 geheime Schlüssel ist der HMAC-Authentifizierungsschlüssel, der mit Ihrem Livestream-Event in Google Ad Manager verknüpft ist.
Token-String signieren
Hängen Sie nach der Generierung die HMAC-Signatur im folgenden Format an den Tokenstring an:
~hmac={HMAC signature}
Token-String URL-codieren
Dieses Token wird als URL-Parameter übergeben und muss daher aus Sicherheitsgründen URL-codiert werden.
Beispiel 1
Hier 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 ein Beispiel, in dem die nicht ausgefüllten optionalen Variablen vollständig ausgelassen 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 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