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.