Canlı yayınlara genel bakış
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kapsül Yayınlama API'si, doğrudan kullanıcıya yönelik HLS veya MPEG DASH medya oynatma listesine eklenebilecek şekilde hazırlanan uyarlanabilir bit hızına sahip video reklam kapsüllerine erişim sağlar.
Bu API, ileri düzey yayıncılar ve video teknolojisi iş ortakları için tasarlanmıştır.
Bu API'nin geniş ölçekte kullanılması, bu belgenin kapsamı dışında olan karmaşık bir medya sunma iş akışının tasarlanmasını ve uygulanmasını gerektirir.
Ön koşullar
DAI Podserving API aracılığıyla bir canlı yayını işlemeden önce Google Ad Manager kullanıcı arayüzünü veya canlı etkinlik API'sini kullanarak bir canlı yayın etkinliği oluşturmanız gerekir.
Bileşenler
Kapsül Yayınlama API'sinin herhangi bir uygulamasını oluşturan üç bileşen vardır: Google Ad Manager, istemci video oynatıcısı ve manifest değiştirme sunucusu.
Ad Manager
Ad Manager, kullanıcılara reklam yayınlamaktan sorumludur ve Ad Manager SDK'sı veya web arayüzü üzerinden yönetilebilir. Hizmetin şu sorumlulukları vardır:
- İstemci video oynatıcısından akış istekleri alma, reklamları karar verme ve içerik kodlama profillerinizle eşleşecek işlemler sağlama
- İstemci video oynatıcısından gelen reklam segmenti isteklerine yanıt verme ve ilgili kullanıcıya reklam kapsülünün uygun kısmını sağlama
- İstemci video oynatıcısından izleme ping'leri alma ve işleme
Müşteri video oynatıcısı
İstemci video oynatıcısı, müşterilerin sonuçta ortaya çıkan video akışını oynatmak için kullandığı uygulama veya web sitesidir. Oyuncu şu sorumluluklara sahiptir:
- Ad Manager'dan bir akış kaynağının başlatılması ve belirli bir canlı yayın etkinliğinin tek bir oynatma oturumunu temsil eden akış nesnesinin alınması.
- Oynatmayı başlatan manifest manipülasyon sunucusundan bir akış manifesti isteme
- Ad Manager'dan düzenli olarak akışın reklam segmentlerine yerleştirilmiş reklam etkinliklerini açıklayan reklam kapsülü meta verilerini yoklama
- Reklam medyası kimlikleri içeren oynatıcı tarafından oluşturulan zamanlı meta veri etkinliklerini dinleme. Bu etkinliklerle karşılaştığında, oynatıcı reklam etkinliklerinin başarıyla gerçekleştiğini doğrulamak için bunları Ad Manager'a yönlendirir.
İstemci video oynatıcının doğru şekilde uygulanması hakkında daha fazla bilgi edinmek için platformunuza ait kapsül yayınlama kılavuzunu inceleyin:
Özel uygulamalar için DAI API'sine yönelik kapsül yayınlama istemci rehberimize bakın.
Manifest değiştirme sunucusu
Manifest değiştirme sunucusu, istemci video oynatıcısına sağlanan akış manifestini barındırmaktan sorumlu olan sunucudur. Sunucu şu sorumluluklara
sahiptir:
- İstemci video oynatıcısına manifest yayınlamayı işleme
- Reklam segmentleriyle doldurmak için Ad Manager'dan dönem şablonu (yalnızca MPEG DASH akışları için) isteme.
- Reklam araları sırasında video akışı manifest dosyasına (HLS için) veya reklam dönemine (MPEG DASH için) Ad Manager tarafından barındırılan reklam segmenti URL'leri ekleme.
- Değiştirilen manifest, istemci video oynatıcısına sunuluyor.
Özel manifest düzenleme sunucusu uygulama hakkında daha fazla bilgi edinmek için manifest değiştirme kılavuzuna bakın.
Sözlük
- Canlı yayın etkinliği: Canlı yayın için kodlama profilleri gibi önemli yapılandırma verilerini depolayan etkinliktir. Canlı yayın etkinlikleri, Ad Manager kullanılarak oluşturulur.
- Akış nesnesi: Belirli bir video öğesinin tek bir oynatma oturumunu temsil eden nesne. Önemli mülkler arasında akış kimliği ve medya doğrulama URL'si yer alır.
- Reklam kapsülü: Reklam arasında gösterilen reklam videolarının gruplanması
- Reklam segmentleri: Reklam arası için medya segment dosyaları
- Reklam kapsülü meta verileri: İstemcide reklam kullanıcı arayüzünü oluşturmak için kullanılan reklam arasıyla ilgili meta veriler; örneğin, reklam sırasında arama düğmelerini gizleme
- Reklam medya kimliği: Reklam segment dosyaları içinde ID3 etiketleri olarak kodlanmış meta veriler. Bu meta veriler, oynatma sırasında reklam başlangıcı veya orta noktası gibi reklamla ilgili belirli etkinliklerin ne zaman gerçekleştiğini tanımlamak için kullanılır.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-01 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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."]]
