Każde żądanie segmentu wysłane za pomocą bloku reklamowego z przekierowaniem segmentu musi zawierać parametr Token podpisany przez HMAC do uwierzytelniania, jeśli nie jest używany wczesnych powiadomień o przerwie na reklamę.
Ten token można obliczyć raz na każdą przerwę na reklamę i udostępnić w całym strumieniu sesji.
Zbierz parametry tokenów
Zbierz poniższe informacje z bieżącej przerwy na reklamę, aby wypełnić pole treść tokena.
| Parametry tokena | ||
|---|---|---|
custom_asset_key
|
Wymagane | Klucz pliku niestandardowej transmisji na żywo z Google Ad Managera. |
cust_params
|
Opcjonalnie | Parametry kierowania niestandardowego. Zobacz cust_params.
|
exp
|
Wymagane | Sygnatura czasowa wygaśnięcia tego tokena w sekundach. |
network_code
|
Wymagane | Kod sieci Ad Managera 360 dla tej sieci. |
pod_id
|
Wymagane | Identyfikator przerwy na reklamę. Musi być liczbą całkowitą, zaczynając od
1 i zwiększa się o 1 na każdą przerwę na reklamę.
Ta wartość musi być taka sama u wszystkich użytkowników, którzy oglądają tę samą przerwę na reklamę w: bieżące wydarzenie. |
pd
|
Wymagane, z wyjątkiem zdarzeń z włączonymi przerwami na reklamę bez ustalonego czasu trwania. | Czas trwania przerwy na reklamę w milisekundach. Określone powyżej jako
ad_pod_duration
|
scte35
|
Opcjonalnie | Sygnał SCTE-35 zakodowany w standardzie Base64. Obowiązkiem klienta jest zapewnienie
czy sygnał jest prawidłowy. Jeśli będzie nieprawidłowa, do
nagłówek HTTP X-Ad-Manager-Dai-Warning w odpowiedzi oraz
jest rozpowszechniany i służy do utworzenia przerwy na reklamę. Zobacz obsługiwane
Znaczniki reklam, by dowiedzieć się więcej o tym, jak DAI korzysta z sygnału SCTE-35.
|
Utwórz ciąg tokena
podaj każdy parametr w porządku alfabetycznym w formacie name=value, z każdym z nich
para nazwa-wartość rozdzielana znakiem tyldy (~).
Opcjonalne parametry bez wartości można pozostawić puste tę wartość lub całkowicie usunąć.
format ciągu tokena
custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}
Wygeneruj podpis HMAC
Podpis HMAC to hasz SHA-256 ciągu tokena w formacie szesnastkowym. tajny klucz to Klucz uwierzytelniania HMAC powiązane z wydarzeniem na żywo w usłudze Google Ad Manager.
Ciąg tokena podpisywania
Po wygenerowaniu dołącz podpis HMAC do ciągu tokena w poniższym format
~hmac={HMAC signature}
Ciąg tokena kodowania adresu URL
Ten token jest przekazywany jako parametr adresu URL, dlatego ze względów bezpieczeństwa musi być zakodowany pod tym adresem.
Przykład 1
Oto przykład, w którym nieużywane parametry opcjonalne zostały umieszczone jako puste ciągi tekstowe.
Ciąg tokena
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
Klucz obiektu tajnego
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Podpis HMAC
86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
Podpisany token
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
Podpisany token zakodowany w adresie URL:
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~cust_params%3D~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3D86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
Przykład 2
Oto przykład, w którym niewypełniane opcjonalne zmienne są całkowicie pomijane.
Ciąg tokena
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g3~exp=1489680000~network_code=6062~pd=180000~pod_id=5
Klucz obiektu tajnego
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Podpis HMAC
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Podpisany token
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Podpisany token zakodowany w adresie URL
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9