l'API Google d'insertion dynamique de séries d'annonces.
L'API Pod Serving permet d'accéder à des séries d'annonces vidéo à débit adaptatif préparées de manière à pouvoir être insérées directement dans une playlist multimédia HLS ou MPEG-DASH destinée aux utilisateurs.
Cette API est destinée aux éditeurs avancés et aux partenaires technologiques vidéo. L'utilisation de cette API à grande échelle nécessite la conception et l'implémentation d'un workflow sophistiqué de diffusion de contenu multimédia, qui ne fait pas l'objet de cette documentation.
Prérequis
Avant de traiter une diffusion en direct avec l'API DAI Podserving, vous devez créer un événement de diffusion en direct à l'aide de l'UI Google Ad Manager ou de l'API live-event.
Composants
Toute implémentation de l'API Pod Serving se compose de trois éléments : Google Ad Manager, un lecteur vidéo client et un serveur de manipulation du fichier manifeste.
Ad Manager
Ad Manager est responsable de la diffusion des annonces auprès de l'utilisateur. Il peut être géré à l'aide du SDK Ad Manager ou de son interface Web. Le service a les responsabilités suivantes :
- Recevoir les demandes de flux du lecteur vidéo client, prendre des décisions concernant les annonces et fournir des rendus correspondant à vos profils d'encodage de contenu
- Répondre aux demandes de segments d'annonces du lecteur vidéo client et fournir la partie appropriée du bloc d'annonces pour l'utilisateur concerné
- Réception et traitement des pings de suivi du lecteur vidéo client
Lecteur vidéo client
Le lecteur vidéo client est l'application ou le site Web que les clients utilisent pour lire le flux vidéo résultant. Le lecteur a les responsabilités suivantes :
- Initialisation d'une ressource de flux à partir d'Ad Manager et réception d'un objet de flux qui représente une session de lecture unique d'un événement de diffusion en direct spécifique.
- Demande d'un fichier manifeste de flux au serveur de manipulation de fichiers manifestes, qui lance la lecture
- Interrogation périodique des métadonnées des blocs d'annonces depuis Ad Manager, qui décrivent les événements publicitaires intégrés dans les segments d'annonces du flux
- Écoute des événements de métadonnées temporelles déclenchés par le lecteur et contenant des ID de contenus multimédias publicitaires. Lorsqu'il rencontre ces événements, le lecteur les transmet à Ad Manager pour vérifier que les événements publicitaires se sont bien produits.
Pour en savoir plus sur l'implémentation appropriée du lecteur vidéo client, consultez le guide de diffusion de pods pour votre plate-forme :
Pour les implémentations personnalisées, consultez notre guide client sur la diffusion d'annonces dans des pods pour l'API DAI.
Serveur de manipulation du fichier manifeste
Le serveur de manipulation du fichier manifeste est le serveur chargé d'héberger le fichier manifeste du flux fourni au lecteur vidéo du client. Le serveur a les responsabilités suivantes :
- Gérer la diffusion du fichier manifeste au lecteur vidéo du client
- Demander un modèle de période à Ad Manager (pour les flux MPEG-DASH uniquement) afin de le remplir avec des segments d'annonces.
- Insertion d'URL de segments publicitaires hébergés dans Ad Manager dans le fichier manifeste du flux vidéo (pour HLS) ou dans la période publicitaire (pour MPEG-DASH) pendant les coupures publicitaires.
- Diffuser le fichier manifeste modifié au lecteur vidéo du client.
Pour en savoir plus sur l'implémentation d'un serveur de manipulation de fichier manifeste personnalisé, consultez le guide sur la manipulation de fichier manifeste.
Glossaire
- Événement de diffusion en direct : événement qui stocke des données de configuration importantes pour la diffusion en direct, comme les profils d'encodage. Les événements de diffusion en direct sont créés à l'aide d'Ad Manager.
- Objet Stream : objet représentant une session de lecture unique d'un élément vidéo spécifique. Les propriétés notables incluent l'ID du flux et l'URL de validation du contenu multimédia.
- Série d'annonces : groupe de vidéos publicitaires diffusées pendant une coupure publicitaire
- Segments d'annonces : fichiers de segments média pour la coupure publicitaire
- Métadonnées du bloc d'annonces : métadonnées de la coupure publicitaire utilisées pour afficher l'UI des annonces sur le client (par exemple, masquer les boutons de recherche pendant la diffusion d'une annonce)
- ID d'annonce multimédia : métadonnées encodées sous forme de tags ID3 dans les fichiers de segments d'annonces. Ces métadonnées permettent d'identifier le moment où des événements spécifiques liés aux annonces se sont produits pendant la lecture, comme le début ou le milieu d'une annonce.