Panoramica dei live streaming
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Pod Serving fornisce l'accesso a pod di annunci video a velocità in bit adattiva preparati
in modo da poter essere uniti direttamente a una playlist multimediale HLS o MPEG
DASH rivolta all'utente.
Questa API è destinata a publisher e partner di tecnologia video avanzati.
L'utilizzo di questa API su larga scala richiede la progettazione e l'implementazione di un sofisticato flusso di lavoro per la pubblicazione di contenuti multimediali che non rientra nell'ambito di questa documentazione.
Prerequisiti
Prima di elaborare un live streaming tramite l'API DAI Podserving, devi creare un evento in live streaming utilizzando l'interfaccia utente di Google Ad Manager o l'API dell'evento dal vivo.
Componenti
Esistono tre componenti che costituiscono qualsiasi implementazione dell'API Pod Serving: Google Ad Manager, un video player client e un server di manipolazione del manifest.
Ad Manager
Ad Manager è responsabile della pubblicazione degli annunci per l'utente e può essere gestito
tramite l'SDK di Ad Manager o la relativa interfaccia web. Il servizio ha le seguenti responsabilità:
- Ricezione di richieste di streaming dal video player del client, definizione degli annunci
e fornitura di versioni corrispondenti ai profili di codifica dei contenuti
- Rispondere alle richieste dei segmenti di annunci dal video player del client e fornire
la parte appropriata del pod di annunci all'utente
- Ricezione ed elaborazione dei ping di monitoraggio dal video player del client
Video player client
Il video player del client è l'app o il sito web che i client utilizzano per riprodurre il
video stream risultante. Il giocatore ha le seguenti responsabilità:
- Inizializzazione di una risorsa di streaming da Ad Manager e ricezione di un oggetto flusso che rappresenta una singola sessione di riproduzione di un evento live streaming specifico.
- Richiedere al server di manipolazione
del manifest di un manifest del flusso, che avvia la riproduzione
- Eseguire periodicamente il polling dei metadati dei pod di annunci di Ad Manager che descrivono gli eventi pubblicitari incorporati nei segmenti di annunci dello stream
- In ascolto di eventi di metadati a tempo generati dal player che contengono ID media pubblicitari. Quando si verificano questi eventi, il player li inoltra ad Ad Manager per verificare che gli eventi relativi agli annunci si siano verificati correttamente.
Per scoprire di più sulla corretta implementazione del video player del client, consulta la guida alla pubblicazione dei pod per la tua piattaforma:
Per le implementazioni personalizzate, consulta la nostra guida al client per la pubblicazione di pod per
l'API DAI.
Server di manipolazione del manifest
Il server di manipolazione del manifest è il server incaricato di ospitare il manifest dello stream fornito al video player del client. Il server ha le seguenti responsabilità:
- Gestione della pubblicazione del file manifest nel video player del client
- Richiedere un modello di periodo da Ad Manager (solo per stream MPEG DASH) al completamento dei segmenti di annunci.
- Inserire gli URL dei segmenti di annunci ospitati da Ad Manager nel manifest del video stream (per HLS) o nel periodo dell'annuncio (per MPEG DASH) durante le interruzioni pubblicitarie.
- Pubblicazione del manifest modificato nel video player del client.
Per ulteriori informazioni sull'implementazione di un server manipolatore del manifest personalizzato, consulta la guida alla manipolazione dei manifest.
Glossario
- Evento di live streaming: un evento che archivia dati di configurazione importanti per il live streaming, ad esempio i profili di codifica. Gli eventi di live streaming vengono creati
con Ad Manager.
- Oggetto stream: un oggetto che rappresenta una singola sessione di riproduzione di un
asset video specifico. Le proprietà degne di nota includono l'ID streaming e
l'URL di verifica dei contenuti multimediali.
- Pod di annunci: raggruppamento di video di annunci mostrati durante un'interruzione pubblicitaria.
- Segmenti di annunci: file di segmenti multimediali per l'interruzione pubblicitaria.
- Metadati pod di annunci: metadati per l'interruzione pubblicitaria utilizzati per visualizzare l'interfaccia utente dell'annuncio sul client; ad esempio, nascondi i pulsanti di ricerca durante l'annuncio
- ID elemento multimediale annuncio: metadati codificati come tag ID3 all'interno dei file dei segmenti di annunci. Questi metadati vengono utilizzati per identificare quando durante la riproduzione si sono verificati eventi specifici relativi agli annunci, ad esempio l'inizio o il punto centrale dell'annuncio.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-01 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
