Jede Segmentanfrage, bei der die Pod-Auslieferung mit der Segmentweiterleitung verwendet wird, muss ein HMAC-signiertes Token für die Authentifizierung enthalten, wenn keine frühen Benachrichtigungen zu Werbeunterbrechungen verwendet werden.
Dieses Token kann einmal pro Werbeunterbrechung berechnet und für alle Streamsitzungen verwendet werden.
Tokenparameter erfassen
Erfassen Sie die folgenden Informationen aus der aktuellen Werbeunterbrechung, um den Tokentext auszufüllen.
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 | Der Ad Manager 360-Netzwerkcode für dieses Netzwerk. |
pod_id
|
Erforderlich | ID der Werbeunterbrechung. Sollte eine Ganzzahl sein, die bei 1 beginnt und für jede Werbeunterbrechung um eins erhöht wird.
Dieser Wert muss für alle Nutzer, die im aktuellen Ereignis dieselbe Werbeunterbrechung sehen, gleich sein. |
pd
|
Erforderlich, außer bei Ereignissen, bei denen Werbeunterbrechungen aktiviert sind. | Die Dauer der Werbeunterbrechung in Millisekunden. Oben oben als ad_pod_duration bezeichnet.
|
scte35
|
Optional | Base64-codiertes SCTE-35-Signal. Der Client ist dafür verantwortlich, dass das Signal korrekt ist. Ist dies nicht der Fall, wird in der Antwort eine Nachricht an den HTTP-Header X-Ad-Manager-Dai-Warning gesendet und das Signal wird trotzdem weitergegeben, um eine Werbeunterbrechung zu erstellen. Weitere Informationen dazu, wie das SCTE-35-Signal bei der dynamischen Anzeigenbereitstellung verwendet wird, finden Sie unter Unterstützte Anzeigenmarkierungen.
|
Tokenstring erstellen
alle Parameter in alphabetischer Reihenfolge im Format name=value
auflisten, wobei jedes Name/Wert-Paar durch ein Tildezeichen (~
) getrennt wird.
Optionale Parameter ohne Wert können mit einem leeren String für den Wert beibehalten oder vollständig entfernt werden.
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. Der geheime Schlüssel ist der HMAC-Authentifizierungsschlüssel, der mit Ihrem Livestream-Ereignis in Google Ad Manager verknüpft ist.
Tokenstring signieren
Hängen Sie nach der Generierung die HMAC-Signatur im folgenden Format an den Tokenstring an.
~hmac={HMAC signature}
URL-Codierungs-Tokenstring
Dieses Token wird als URL-Parameter übergeben. Aus Sicherheitsgründen muss es daher URL-codiert werden.
Beispiel 1
In diesem Beispiel sind nicht verwendete optionale Parameter als leere Strings enthalten.
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
In diesem Beispiel werden die nicht ausgefüllten optionalen Variablen gänzlich 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