Descripción general de las transmisiones en vivo
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Pod Serving proporciona acceso a grupos de anuncios de video con tasa de bits adaptable preparados de tal manera que se puedan unir directamente a una lista de reproducción multimedia HLS o MPEG DASH orientada al usuario.
Esta API está dirigida a publicadores avanzados y socios de tecnología de video.
El uso de esta API a gran escala requiere el diseño y la implementación de un flujo de trabajo sofisticado de entrega de contenido multimedia que está fuera del alcance de esta documentación.
Requisitos previos
Antes de procesar una transmisión en vivo a través de la API de DAI PodServing, deberás crear un evento de transmisión en vivo con la IU de Google Ad Manager o la API de eventos en vivo.
Componentes
Hay tres componentes que conforman cualquier implementación de la API de Pod Serving: Google Ad Manager, un reproductor de video del cliente y un servidor de manipulación de manifiestos.
Ad Manager
Ad Manager es responsable de publicar anuncios para el usuario y se puede administrar a través del SDK de Ad Manager o su interfaz web. El servicio tiene las siguientes responsabilidades:
- Recibir solicitudes de transmisión del reproductor de video del cliente, tomar decisiones y proporcionar formatos que coincidan con tus perfiles de codificación de contenido
- Responder a solicitudes de segmentos de anuncios del reproductor de video del cliente y proporcionar la parte adecuada del grupo de anuncios para el usuario determinado
- Recepción y procesamiento de pings de seguimiento del reproductor de video del cliente
Reproductor de video del cliente
El reproductor de video del cliente es la app o el sitio web que los clientes usan para reproducir la transmisión de video por Internet resultante. El jugador tiene las siguientes responsabilidades:
- Inicializar un recurso de transmisión desde Ad Manager y recibir un objeto de transmisión que represente una sola sesión de reproducción de un evento de transmisión en vivo específico
- Solicitud de un manifiesto de transmisión desde el servidor de manipulación de manifiestos, que inicia la reproducción
- Sondear de forma periódica los metadatos de grupos de anuncios de Ad Manager que describan los eventos de anuncios incorporados en los segmentos de anuncios de la transmisión
- Detectar eventos de metadatos temporizados generados por el reproductor que contienen IDs de contenido multimedia de anuncios Cuando encuentra estos eventos, el reproductor los reenvía a Ad Manager para verificar que se hayan producido correctamente los eventos de anuncios.
Para obtener más información sobre la implementación adecuada del reproductor de video cliente, consulta la guía de publicación de pods de tu plataforma:
Para implementaciones personalizadas, consulta nuestra guía del cliente sobre entrega de Pods de la API de DAI.
Servidor de manipulación de manifiestos
El servidor de manipulación de manifiestos es el servidor a cargo de alojar el manifiesto de transmisión que se proporciona al reproductor de video del cliente. El servidor tiene las siguientes responsabilidades:
- Cómo administrar la entrega del manifiesto al reproductor de video del cliente
- Solicita una plantilla de período de Ad Manager (solo para transmisiones de MPEG DASH) a fin de propagar segmentos de anuncios.
- Insertar URLs de segmentos de anuncios alojados en Ad Manager en el manifiesto de transmisión de video por Internet (para HLS) o en el período del anuncio (para MPEG DASH) durante las pausas publicitarias
- Entregar el manifiesto modificado al reproductor de video del cliente
Si deseas obtener más información para implementar un servidor manipulador de manifiestos personalizado, consulta la guía de manipulación de manifiestos.
Glosario
- Evento de transmisión en vivo: Un evento que almacena datos de configuración importantes para la transmisión en vivo, como los perfiles de codificación Los eventos de transmisión en vivo se crean con Ad Manager.
- Objeto de transmisión: Es un objeto que representa una sola sesión de reproducción de un elemento de video específico. Las propiedades destacadas incluyen el ID de transmisión y la URL de verificación de contenido multimedia.
- Grupo de anuncios: Es una agrupación de videos de anuncios que se muestran en una pausa publicitaria.
- Segmentos de anuncios: Archivos de segmentos de medios para la pausa publicitaria
- Metadatos de grupos de anuncios: Son los metadatos de la pausa publicitaria que se usan para renderizar la IU del anuncio en el cliente (por ejemplo, ocultar los botones de búsqueda durante el anuncio).
- ID de contenido multimedia del anuncio: Son metadatos codificados como etiquetas ID3 dentro de archivos de segmentos de anuncios. Estos metadatos se usan para identificar cuándo ocurrieron eventos específicos relacionados con anuncios durante la reproducción, como el inicio o el punto medio del anuncio.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-01 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
