Insérer des annonces dans une diffusion en direct avec l'API de diffusion de séries d'annonces

Pour implémenter l'insertion d'annonces côté serveur (SSAI) avec une diffusion en direct HLS ou DASH, utilisez l'API Pod Serving pour demander des séries d'annonces à débit adaptatif. Pour connaître les résolutions et les débits compatibles, consultez Formats vidéo et audio et transcodage.

Cette page explique comment utiliser l'API de diffusion de séries d'annonces pour les diffusions en direct.

Prérequis

Avant de continuer, vous devez disposer des éléments suivants :

• Configurez un événement en direct avec le type d'insertion dynamique d'annonces Redirection de diffusion de séries d'annonces. Choisissez l'une des options suivantes :

  • Configurez une diffusion en direct pour l'insertion dynamique d'annonce.
  • Sélectionnez une bibliothèque cliente de l'API SOAP et appelez la méthode LiveStreamEventService.createLiveStreamEvents avec un objet LiveStreamEvent et le type dynamicAdInsertionType défini sur l'énumération POD_SERVING_REDIRECT. Pour toutes les bibliothèques clientes, consultez Bibliothèques clientes et exemples de code.

• Une application cliente s'exécutant dans un navigateur Web, sur un appareil mobile ou sur un téléviseur, pour charger le flux et gérer les événements, tels que la lecture, la pause, le clic ou le geste tactile.

• Manipulateur de fichier manifeste pour gérer les requêtes de flux de l'application cliente. Important : Pour votre service de fichier manifeste, nous vous recommandons le flux de diffusion avancé.

• Un compte Google Ad Manager avec l'insertion dynamique de séries d'annonces activée.

Flux de diffusion de base

Pour diffuser votre flux, choisissez un protocole de streaming et procédez comme suit :

HLS

1. Pour enregistrer une session, envoyez une demande de flux depuis votre lecteur vidéo vers Google Ad Manager.

2. Commence à interroger les métadonnées des annonces pour les événements publicitaires à venir.

3. Demandez le fichier manifeste du flux en direct à votre outil de manipulation du fichier manifeste.

4. Facultatif : Envoyez une notification de coupure publicitaire anticipée à Google Ad Manager. Important : Nous vous recommandons de suivre cette étape pour améliorer votre taux de remplissage.

5. Lorsque votre outil de manipulation du fichier manifeste détecte un repère de coupure publicitaire, il construit les URL des segments publicitaires et les assemble dans le fichier manifeste.

   • Lors d'une coupure publicitaire, votre lecteur vidéo client demande un segment d'annonce et suit l'URL de redirection du segment pour télécharger le fichier du segment d'annonce.

6. Extrayez les ID d'événements publicitaires des tags ID3 pour trouver et envoyer des pings de validation des contenus multimédias à Google.

DASH

1. Suivez toutes les étapes de l'onglet "HLS".

2. Demandez un modèle de période DASH une seule fois et mettez-le en cache. Cette approche permet de créer les périodes pour toutes les coupures publicitaires de la session.

Processus de diffusion avancé

Pour diffuser votre flux, choisissez un protocole de streaming :

HLS

1. Pour enregistrer une session, envoyez une demande de flux depuis votre lecteur vidéo client vers Google Ad Manager.

2. Commence à interroger les métadonnées des annonces pour les événements publicitaires à venir.

3. Demandez le fichier manifeste du flux en direct à votre outil de manipulation du fichier manifeste.

4. Facultatif : envoyez une notification de coupure publicitaire anticipée à Google Ad Manager pour améliorer le taux de remplissage.

5. Envoyez une demande de métadonnées de minutage de groupe d'annonces (ATM) à Google Ad Manager.

6. Récupérez l'heure précise du bloc d'annonces et de l'ardoise pour construire les URL des segments d'annonces.

7. Insérez les URL des segments d'annonces dans le fichier manifeste.

8. Lorsque votre manipulateur de fichier manifeste détecte un repère d'insertion publicitaire, il construit les URL des segments publicitaires et les insère dans le fichier manifeste.

   • Lors d'une coupure publicitaire, votre lecteur vidéo client demande un segment d'annonce et suit l'URL de redirection du segment pour télécharger le fichier du segment d'annonce.

9. Extrayez les ID d'événements publicitaires des tags ID3 pour trouver et envoyer des pings de validation des contenus multimédias à Google.

DASH

1. Suivez toutes les étapes de l'onglet "HLS".

2. Utilisez les réponses des métadonnées de minutage des blocs d'annonces (ATM) pour créer les périodes DASH.

Instructions détaillées

Pour en savoir plus sur les points de terminaison de l'API, ainsi que sur les exemples de données de requête et de réponse, consultez Application de lecteur vidéo client pour les diffusions en direct et Manipulateur de fichier manifeste pour les diffusions en direct.