Chaque requête de segment ou de manifeste effectuée à l'aide de la diffusion de pods doit inclure un jeton signé avec HMAC pour l'authentification, en tant que solution de secours pour les notifications anticipées de coupures publicitaires.
Ce jeton peut être calculé une fois par coupure publicitaire et partagé entre toutes les sessions de diffusion.
Collecter les paramètres du jeton
Collectez les informations suivantes à partir de la coupure publicitaire actuelle pour remplir le corps du jeton.
| Paramètres du jeton | ||
|---|---|---|
ad_break_id
|
Obligatoire si le paramètre pod_id n'est pas fourni.
|
Identifiant de chaîne de la coupure publicitaire. |
custom_asset_key
|
Obligatoire si le paramètre event n'est pas fourni.
|
Clé d'élément de diffusion en direct personnalisée, à partir de Google Ad Manager. |
cust_params
|
Facultatif | Paramètres de ciblage personnalisés pour la coupure publicitaire. |
event
|
Obligatoire si le paramètre custom_asset_key n'est pas fourni.
|
Clé d'élément de diffusion en direct, générée par Google Ad Manager. |
exp
|
Obligatoire | Timestamp d'expiration de ce jeton en secondes. |
network_code
|
Obligatoire si le paramètre custom_asset_key est fourni.
|
Code de réseau Ad Manager 360 pour ce réseau. |
pod_id
|
Obligatoire si le paramètre ad_break_id n'est pas fourni.
|
Identifiant numérique de la coupure publicitaire. |
pd
|
Obligatoire, sauf pour les événements avec des coupures publicitaires sans durée activées. | Durée de la coupure publicitaire en millisecondes. |
scte35
|
Facultatif | Signal SCTE-35 encodé en Base64 pour la coupure publicitaire. |
Créer une chaîne de jeton
Répertoriez chaque paramètre par ordre alphabétique, au format name=value, chaque paire nom-valeur étant séparée par un tilde (~).
Les paramètres facultatifs sans valeur peuvent être laissés en place avec une chaîne vide pour la valeur, ou supprimés entièrement.
Format de la chaîne de jeton
custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}
Générer une signature HMAC
La signature HMAC est un hachage SHA-256 de la chaîne de jeton au format HEX. La clé secrète est la clé d'authentification HMAC associée à votre événement de diffusion en direct dans Google Ad Manager.
Signer une chaîne de jeton
Une fois générée, ajoutez la signature HMAC à la chaîne de jeton au format suivant :
~hmac={HMAC signature}
Encoder une chaîne de jeton au format URL
Ce jeton est transmis en tant que paramètre d'URL. Il doit donc être encodé au format URL pour des raisons de sécurité.
Exemple 1
Voici un exemple dans lequel les paramètres facultatifs inutilisés sont inclus en tant que chaînes vides.
Chaîne de jeton
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
Clé secrète
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Signature HMAC
ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
Jeton signé
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
Jeton signé encodé au format URL :
cust_params%3D~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3Dea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
Exemple 2
Voici un exemple dans lequel les variables facultatives non remplies sont entièrement omises.
Chaîne de jeton
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5
Clé secrète
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Signature HMAC
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Jeton signé
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Jeton signé encodé au format URL
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Exemple 3
Voici un exemple avec ad_break_id.
Chaîne de jeton
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000
Clé secrète
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Signature HMAC
327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
Jeton signé
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~hmac=327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
Jeton signé encodé au format URL
ad_break_id%3Dadbreak1~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~hmac%3D327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29