Authentifier les demandes de flux vidéo d'insertion dynamique d'annonce

Les clés d'authentification pour l'insertion dynamique d'annonce permettent de prouver que les demandes de flux vidéo émanent de vous. Elles offrent une sécurité accrue lors de la diffusion d'annonces. Une clé est une chaîne ininterrompue de 64 caractères et chiffres. Certaines clés plus anciennes peuvent comporter 25 caractères ou chiffres.

Exemple

0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B

Clés API statiques : les clés API sont prioritaires sur les clés HMAC lorsque les deux sont incluses. Les clés API sont moins sécurisées que les clés HMAC. Il est donc recommandé d'utiliser des clés HMAC.

HMAC : l'authentification par jeton HMAC est plus sécurisée que celle des clés API statiques. Les jetons HMAC utilisent une clé secrète et ont une durée limitée. Il est donc difficile de les partager entre plusieurs utilisateurs ou plusieurs sessions.

Conseil : Avant d'authentifier les demandes de flux, assurez-vous de disposer des éléments suivants :

• Clé d'authentification pour l'insertion dynamique d'annonce de type HMAC
• Diffusion en direct configurée pour l'insertion dynamique d'annonces

Ajouter une clé d'authentification HMAC pour l'insertion dynamique d'annonces

Générez et ajoutez une clé d'authentification pour l'insertion dynamique d'annonces de type HMAC :

1. Connectez-vous à Google Ad Manager.
2. Cliquez sur Admin, puis sur Vidéo et audio.
3. Sélectionnez "Clés d'authentification pour l'insertion dynamique d'annonces".
4. Cliquez sur Nouvelle clé d'authentification pour l'insertion dynamique d'annonces.
5. Saisissez le nom de la nouvelle clé. Sélectionnez le type "HMAC".
6. Cliquez sur Enregistrer.

Cette clé est associée à votre diffusion en direct lorsque vous activez l'authentification.

Activer l'authentification pour les requêtes adressées aux API d'insertion dynamique d'annonce

Associez votre clé HMAC à votre flux :

1. Connectez-vous à Google Ad Manager.
2. Cliquez sur Vidéo, puis sur Diffusions en direct.
3. Sélectionnez votre diffusion en direct dans la liste ou cliquez sur Nouvelle diffusion en direct. Découvrez comment créer une diffusion en direct.
4. Sous "Paramètres généraux",
   1. sélectionnez "Activé" pour "Clés d'authentification des ressources de série d'annonces" afin d'authentifier les demandes de série d'annonces ; et/ou
   2. sélectionnez "Activé" pour "Clés d'authentification pour la création de flux" afin d'authentifier les demandes de session de streaming.
5. Sélectionnez la clé HMAC que vous avez créée.
6. Cliquez sur Enregistrer.

Pour afficher et copier votre clé, revenez à la page d'informations. Après avoir créé une clé d'authentification active pour l'insertion dynamique d'annonces, vous pouvez l'utiliser immédiatement Intégrez la clé dans l'application vidéo cliente, où vous effectuez des demandes de flux d'insertion dynamique d'annonces.

Conseil : Nous vous recommandons de générer des clés d'authentification d'insertion dynamique d'annonces distinctes pour chacune de vos plates-formes clientes (par exemple, iOS, Android et le Web).

Les clés sont automatiquement définies sur l'état "Actif". Seules les clés à l'état "Actif" correctement intégrées permettent de valider des demandes.

Les demandes qui utilisent des clés désactivées sont refusées Ne désactivez une clé que si elle a été piratée ou si elle ne doit pas être utilisée.

Désactiver une clé d'authentification existante

Pour désactiver une clé d'authentification, procédez comme suit :

1. Connectez-vous à Google Ad Manager.
2. Cliquez sur Admin, Vidéo et audio, puis sur "Clés d'authentification pour l'insertion dynamique d'annonces".
3. Dans la liste, sélectionnez la clé que vous souhaitez désactiver.
4. Sélectionnez l'état "Inactif".
5. Cliquez sur Enregistrer.

Intégrer une clé d'authentification

Clés HMAC

Découvrez comment intégrer l'authentification HMAC.

Clés API

Le SDK IMA vous permet de définir la propriété apiKey pour l'objet IMAStreamRequest. Pour en savoir plus, consultez la documentation destinée aux développeurs iOS, Android, Chromecast ou tvOS.

Pour le balisage côté serveur, utilisez le paramètre de requête api-key :

curl "https://dai.google.com/ondemand/hls/content/CMS_ID/vid/VIDEO_ID/master.m3u8?api-key=<api-authentication-key>"

Pour tout problème ou interruption concernant l'insertion dynamique d'annonce, contactez l'assistance pour les éditeurs.