Signiertes HMAC-Token generieren

Jede Segmentanfrage, die über die Pod-Auslieferung mit Segmentweiterleitung gestellt wird, muss Folgendes enthalten: HMAC-signiertes Token zur Authentifizierung, falls nicht verwendet Frühzeitige Benachrichtigungen zu Werbeunterbrechungen.

Dieses Token kann einmal pro Werbeunterbrechung berechnet und für den gesamten Stream verwendet werden Sitzungen.

Tokenparameter erfassen

Erfassen Sie die folgenden Informationen aus der aktuellen Werbeunterbrechung, um den Tokentext.

Tokenparameter
custom_asset_key Erforderlich Der benutzerdefinierte Livestream-Asset-Schlüssel aus Google Ad Manager
cust_params Optional Benutzerdefinierte Targeting-Parameter. cust_params ansehen.
exp Erforderlich Ablaufzeitstempel für dieses Token in Sekunden.
network_code Erforderlich Das ist der Ad Manager 360-Netzwerkcode für das Netzwerk.
pod_id Erforderlich Die ID für die Werbeunterbrechung. Muss eine Ganzzahl sein, die bei beginnt 1 und wird für jede Werbeunterbrechung um eins erhöht.

<ph type="x-smartling-placeholder"></ph> Dieser Wert muss für alle Nutzer gleich sein, die dieselbe Werbeunterbrechung in über das aktuelle Ereignis.

pd Erforderlich, mit Ausnahme von Ereignissen, für die Werbeunterbrechungen ohne Dauer aktiviert sind. Die Dauer der Werbeunterbrechung in Millisekunden. Oben als ad_pod_duration
scte35 Optional Base64-codiertes SCTE-35-Signal. Es liegt in der Verantwortung des Kunden, dass das Signal korrekt ist. Ist dies nicht korrekt, wird eine Nachricht an die X-Ad-Manager-Dai-Warning-HTTP-Header in der Antwort und im wird trotzdem weitergegeben, um eine Werbeunterbrechung zu erstellen. Weitere Informationen finden Sie in der unterstützten Anzeigenmarkierungen, um weitere Informationen zur Verwendung des SCTE-35-Signals bei der dynamischen Anzeigenbereitstellung zu erhalten.

Tokenstring erstellen

die einzelnen Parameter in alphabetischer Reihenfolge im Format name=value aufführen, wobei Name/Wert-Paar, das durch ein Tildezeichen (~) getrennt ist.

Optionale Parameter ohne Wert können durch einen leeren String ersetzt werden für den Wert oder vollständig entfernt.

Format des Tokenstrings

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 Tokenstrings im Hexadezimalformat. Die geheimer Schlüssel ist der HMAC-Authentifizierungsschlüssel die mit Ihrem Livestream-Ereignis in Google Ad Manager verknüpft sind.

Tokenstring signieren

Hängen Sie nach der Generierung die HMAC-Signatur an den Tokenstring im folgenden Beispiel an: Format

~hmac={HMAC signature}

Tokenstring mit URL-Codierung

Dieses Token wird als URL-Parameter übergeben, daher muss es aus Sicherheitsgründen URL-codiert werden.

Beispiel 1

In diesem Beispiel werden nicht verwendete optionale Parameter als leer eingefügt. Zeichenfolgen.

Token string

custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=

Secret-Schlüssel

A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F

HMAC-Signatur

86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88

Signiertes Token

custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88

URL-codiertes signiertes Token:

custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~cust_params%3D~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3D86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88

Beispiel 2

Im folgenden Beispiel werden die nicht ausgefüllten optionalen Variablen ganz weggelassen.

Token string

custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g3~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