Présentation des diffusions en direct
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 assemblées directement dans une playlist de contenus multimédias HLS ou MPEG DASH visible par l'utilisateur.
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 de diffusion de médias sophistiqué, qui sort du cadre de cette documentation.
Conditions préalables
Avant de traiter une diffusion en direct via l'API de diffusion de séries d'annonces pour l'insertion dynamique d'annonce, vous devez créer un événement de diffusion en direct à l'aide de l'interface utilisateur de Google Ad Manager ou de l'API d'événements en direct.
Composants
Toute mise en œuvre de l'API de diffusion de séries d'annonces est composée de trois composants: Google Ad Manager, un lecteur vidéo client et un serveur de manipulation du fichier manifeste.
Ad Manager
Ad Manager est chargé de diffuser les annonces auprès de l'utilisateur et peut être géré via le SDK Ad Manager ou son interface Web. Le service assume les responsabilités suivantes:
- Réception de requêtes de flux depuis le lecteur vidéo client, prise de décision concernant les annonces et fourniture de rendus correspondant à vos profils d'encodage de contenu
- Répondre aux demandes de segment d'annonces du lecteur vidéo client et fournir la partie appropriée de la série d'annonces pour l'utilisateur donné
- Réception et traitement des pings de suivi en provenance 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 obtenu. Le joueur doit assumer les responsabilités suivantes:
- initialiser une ressource de flux depuis Ad Manager et recevoir un objet de flux qui représente une seule session de lecture d'un événement de diffusion en direct spécifique.
- Demander un fichier manifeste de flux au serveur de manipulation du fichier manifeste, qui lance la lecture
- l'interrogation périodique des métadonnées de séries d'annonces à partir d'Ad Manager décrivant les événements d'annonce intégrés aux segments d'annonces du flux
- Écouter les événements de métadonnées temporisés générés par le lecteur qui contiennent les ID d'éléments multimédias de l'annonce. Lorsqu'il rencontre ces événements, le lecteur les redirige vers Ad Manager pour vérifier s'ils se sont bien produits.
Pour découvrir comment implémenter correctement le lecteur vidéo client, consultez le guide de diffusion de séries d'annonces correspondant à votre plate-forme:
Pour les implémentations personnalisées, consultez notre guide client sur la diffusion de séries d'annonces pour l'API d'insertion dynamique d'annonce.
Serveur de manipulation du fichier manifeste
Le serveur de manipulation du fichier manifeste est le serveur chargé d'héberger le fichier manifeste de flux fourni au lecteur vidéo client. Le serveur a les responsabilités suivantes:
- Gérer l'envoi du fichier manifeste au lecteur vidéo 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 d'annonces hébergés par Ad Manager dans le fichier manifeste du flux vidéo (pour HLS) ou dans la période de l'annonce (pour MPEG DASH) pendant les coupures publicitaires.
- Diffusion du fichier manifeste modifié dans le lecteur vidéo client
Pour en savoir plus sur la mise en œuvre d'un serveur personnalisé de manipulation du fichier manifeste, consultez le guide de manipulation du fichier manifeste.
Glossaire
- Événement de diffusion en direct: événement qui stocke des données de configuration importantes pour la diffusion en direct, telles que des profils d'encodage. Les événements de diffusion en direct sont créés à l'aide d'Ad Manager.
- Objet de flux: objet qui représente une seule session de lecture d'un élément vidéo spécifique. Les propriétés notables incluent l'ID de flux et l'URL de validation multimédia.
- Série d'annonces: regroupement de vidéos publicitaires diffusées dans une coupure publicitaire
- Segments d'annonces: fichiers de segments multimédias pour la coupure publicitaire
- Métadonnées des séries d'annonces: métadonnées de la coupure publicitaire utilisées pour afficher l'UI de l'annonce sur le client (par exemple, masquage des boutons de recherche pendant l'annonce).
- ID du support de l'annonce: métadonnées encodées sous forme de tags ID3 dans les fichiers de segments d'annonce. Ces métadonnées permettent d'identifier quand des événements spécifiques liés à l'annonce se sont produits pendant la lecture, par exemple au début ou à la moitié de l'annonce.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/01 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/01 (UTC)."],[[["\u003cp\u003eThe Pod Serving API facilitates the integration of adaptive-bitrate video ad pods directly into HLS or MPEG DASH media playlists for advanced publishers and video technology partners.\u003c/p\u003e\n"],["\u003cp\u003eImplementing the Pod Serving API involves three core components: Google Ad Manager, which handles ad delivery and tracking; a client video player, which manages stream initialization and playback; and a manifest manipulation server, which modifies and serves the stream manifest.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, a livestream event must be created via the Google Ad Manager UI or the live-event API, serving as a configuration resource for the livestream.\u003c/p\u003e\n"],["\u003cp\u003eThe client video player is responsible for initializing the stream, requesting the manifest, polling for ad pod metadata, and forwarding timed metadata events to Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eThe manifest manipulation server handles manifest delivery, requests ad period templates, and inserts Ad Manager-hosted ad segment URLs or ad periods into the stream manifest during ad breaks.\u003c/p\u003e\n"]]],[],null,["# Overview for live streams\n\nThe Pod Serving API provides access to adaptive-bitrate video ad pods prepared\nin such a way that they can be stitched directly into a user-facing HLS or MPEG\nDASH media playlist.\n\nThis API is intended for advanced publishers and video technology partners.\nUsing this API at scale requires design and implementation of a sophisticated\nmedia serving workflow which is outside the scope of this documentation.\n\nPrerequisites\n-------------\n\nBefore processing a livestream through the DAI Podserving API, you\nwill need to create a\n[livestream event](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/manipulator#livestreamevent)\nusing the Google Ad Manager UI, or the live-event API.\n\nComponents\n----------\n\nThere are three components that make up any implementation of the Pod Serving\nAPI: Google Ad Manager, a client video player, and a manifest manipulation\nserver.\n\n### Ad Manager\n\nAd Manager is responsible for delivering ads to the user and can be managed\nthrough either the Ad Manager SDK or its web interface. The service has these\nresponsibilities:\n\n- Receiving stream requests from the client video player, decisioning ads, and providing renditions to match your content encoding profiles\n- Responding to ad segment requests from the client video player and providing the appropriate portion of the ad pod for the given user\n- Receiving and processing tracking pings from the client video player\n\n### Client video player\n\nThe client video player is the app or website that clients use to play the\nresulting video stream. The player has these responsibilities:\n\n- Initializing a stream resource from Ad Manager and receiving a stream object that represents a single playback session of a specific livestream event.\n- Requesting a stream manifest from the manifest manipulation server, which starts playback\n- Periodically polling ad pod metadata from Ad Manager that describes the ad events embedded in the stream's ad segments\n- Listening for timed metadata events raised by the player that contain ad media IDs. Upon encountering these events, the player forwards them to Ad Manager to verify that ad events have successfully occurred.\n\nTo learn more about the proper implementation of the client video player, see\nthe pod serving guide for your platform:\n\n- [Android](/ad-manager/dynamic-ad-insertion/sdk/android?service=pod)\n- [HTML5](/ad-manager/dynamic-ad-insertion/sdk/html5?service=pod)\n- [iOS](/ad-manager/dynamic-ad-insertion/sdk/ios?service=pod)\n- [tvOS](/ad-manager/dynamic-ad-insertion/sdk/tvos?service=pod)\n\nFor custom implementations, see our [pod serving client guide for the DAI\nAPI](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/client).\n\n### Manifest manipulation server\n\nThe manifest manipulation server is the server in charge of hosting the\nstream manifest provided to the client video player. The server has these\nresponsibilities:\n\n- Handling manifest delivery to the client video player\n- Requesting a period template from Ad Manager (for MPEG DASH streams only), to populate with ad segments.\n- Inserting Ad Manager-hosted ad segment URLs into the video stream manifest (for HLS) or ad period (for MPEG DASH) during ad breaks.\n- Serving the modified manifest to the client video player.\n\nTo learn more about implementing a custom manifest manipulator server, see the\n[manifest manipulation\nguide](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/manipulator).\n\nGlossary\n--------\n\n- **Livestream event**: An event that stores important configuration data for livestream, such as encoding profiles. Livestream events are created using Ad Manager.\n- **Stream object**: An object that represents a single playback session of a specific video asset. Notable properties include the stream ID and the media verification URL.\n- **Ad pod**: Grouping of ad videos shown in an ad break\n- **Ad segments**: Media segment files for the ad break\n- **Ad pod metadata**: Metadata for the ad break used to render ad UI on the client; for example, hide seek buttons during ad\n- **Ad media ID**: Metadata encoded as ID3 tags within ad segment files. This metadata is used to identify when specific ad-related events have occurred during playback, such as ad start or midpoint."]]
