L'API d'insertion dynamique de séries d'annonces fournit des fichiers manifestes de séries d'annonces vidéo à débit adaptatif, préparés de manière à pouvoir être assemblés directement dans une playlist de contenus multimédias HLS ou MPEG-DASH visible par l'utilisateur.
Une intégration type avec l'API d'insertion dynamique de séries d'annonces comporte trois composants principaux : Google Ad Manager, une application de lecteur vidéo cliente, généralement conçue à l'aide du SDK IMA (Interactive Media Ads), et un outil de manipulation du fichier manifeste.
Ad Manager
Ad Manager est chargé de diffuser les séries d'annonces à l'outil de manipulation du fichier manifeste. Il interagit avec l'API de diffusion de pods d'Ad Manager pour demander les séries d'annonces. Le service a les responsabilités suivantes:
- Créer une session de diffusion pour chaque requête de l'application de lecteur vidéo cliente, sélectionner des annonces, créer des séries d'annonces et fournir des rendus correspondant à vos profils d'encodage de contenu, également appelé "fractionnement des créations vidéo". (Étapes 1 et 2 du schéma ci-dessus.)
- Répondre aux demandes de séries d'annonces envoyées par l'outil de manipulation des fichiers manifestes et fournir des fichiers manifestes de séries d'annonces correctement encodés pour les assembler dans les flux (Étapes 4 et 5).
- Répondre aux demandes de métadonnées de séries d'annonces provenant de l'application de lecteur vidéo cliente et fournir un tableau de conversion pour les événements d'annonce (Étapes 7 et 8).
- Réception et traitement des pings de suivi reçus par l'application de lecteur vidéo du client (étape 10)
Application de lecteur vidéo cliente
Il peut s'agir d'une application TV, mobile ou Web dans laquelle les utilisateurs regardent le flux vidéo. Le joueur doit assumer les responsabilités suivantes:
- Demander une ressource de flux à Ad Manager et recevoir un objet de flux qui représente une seule session de lecture d'un élément vidéo spécifique (Étapes 1 et 2)
- Demander un fichier manifeste de flux à l'outil de manipulation du fichier manifeste et lancer la lecture (Étapes 3 et 6).
- demander à Ad Manager des métadonnées de séries d'annonces, qui décrit les événements d'annonce intégrés aux événements de métadonnées minutés du flux ; (Étapes 7 et 8).
- Écouter le lecteur vidéo pour les rappels avec des événements de métadonnées minutés intégrés dans le flux audio ou vidéo contenant les ID d'éléments multimédias publicitaires (Étape 9)
- rechercher les URL de validation en faisant correspondre ces ID intégrés aux événements d'annonce et en informant Ad Manager que ces événements ont bien eu lieu ; (Étape 10)
Pour en savoir plus sur la mise en œuvre de l'application de lecteur vidéo cliente, consultez le guide du SDK IMA correspondant à votre plate-forme : Android, HTML5, iOS ou tvOS. Pour les implémentations personnalisées, consultez notre guide de l'application de lecteur vidéo cliente pour l'API de diffusion de séries d'annonces VOD pour l'insertion dynamique d'annonce.
Manipulation du fichier manifeste
L'outil de manipulation du fichier manifeste est le serveur chargé d'héberger le fichier manifeste de flux fourni à l'application de lecteur vidéo cliente. Le serveur a les responsabilités suivantes:
- Demander des fichiers manifestes de séries d'annonces à Ad Manager. (Étapes 4 et 5).
- Assemblage de ces fichiers manifestes d'annonce dans le flux de contenu VOD existant et envoi du fichier manifeste final à l'application de lecteur vidéo cliente (étapes 3 et 6)
Pour en savoir plus sur la mise en œuvre d'un outil personnalisé de manipulation du fichier manifeste, consultez le guide de manipulation du fichier manifeste de l'API de diffusion de pods d'insertion dynamique de fichiers à la demande.