IMA DAI SDK, minimum HbbTV video oynatıcı uygulamasına entegrasyonu destekler. IMA DAI SDK, Google Ad Manager talebinin bir yayın içeriği akışına eşlik edecek geniş bant reklam akışı için kullanılmasını sağlar. Bu kılavuzda, yayın akışındaki reklam etkinliği verilerine dayalı olarak reklam manifesti yükleme konusu ele alınmaktadır.
Tamamlanmış bir örnek entegrasyonu görüntülemek veya takip etmek için IMA HTML5 DAI SDK'sı ile HbbTV Linear Örnek Uygulaması'nı indirin. Eski TV cihazlarını desteklemek için bu kılavuz ve GitHub örnek uygulaması ES5 JavaScript'te yazılmıştır.
HbbTV dışındaki diğer platformlarla entegrasyon hakkında bilgi edinmek için Interactive Media Ads SDK'ları başlıklı makaleyi inceleyin.
Ön koşullar
Bu kılavuzla devam etmeden önce aşağıdakilere sahip olduğunuzu onaylayın:
- IMA DAI'yi kullanmak için Ad Manager 360 Advanced hesabınız olmalıdır. Ad Manager hesabınız varsa daha fazla bilgi için hesap yöneticinizle iletişime geçin. Ad Manager'a kaydolma hakkında bilgi edinmek için Ad Manager Yardım Merkezi'ni ziyaret edin.
- Medya oynatma için yayın nesnesiyle etkileşimde bulunan bir HbbTV uygulaması. Daha ayrıntılı bilgi için HbbTV Broadcast AV object bölümüne bakın.
- Ön yüklemeyi destekleyen bir dash.js sürümü. 4.6.0 veya sonraki bir sürümü kullanmanızı öneririz.
- Uygulamayı barındırmak için bir web sunucusu.
- DVB yayın akışına sahip bir test ortamı. Test ortamınızı ayarlamayla ilgili ayrıntılı talimatlar için HbbTV uygulaması çalıştırma başlıklı makaleyi inceleyin.
- Yayın Akışı: Özel Uygulama Bilgi Tablosu (AIT) verilerini içeren bir yayın akışı hazırlayın. Ayrıca, yayın akışını TV'nin alması için iletmeniz gerekir. Yayın akışını iletmek için DVB modülatörü veya başka yöntemler kullanabilirsiniz.
- Web sunucusu: HbbTV uygulamasını, TV'nin erişebileceği bir web sunucusunda barındırın.
- Kapsül yayınlama manifesti türünde bir canlı yayın etkinliği. Etkinlik oluşturmak için DAI için canlı yayın oluşturma başlıklı makaleyi inceleyin.
Uyumlu bir yayın akışı oluşturma
HbbTV uygulamanız, yayın akışınızdaki HbbTV akış etkinliklerini dinlemek için broadcastContainer.addStreamEventListener() kullanır. Reklamların düzgün şekilde yüklenip oynatılması için yayın akışınızı aşağıdaki etkinlik türleriyle ayarlamanız gerekir. Bu etkinlik türleri, ilişkili JSON dizesi yükünü içermelidir:
AD_BREAK_EVENT_ANNOUNCE-{"type":"adBreakAnnounce", "pod_id":1,"duration":90, "offset":10}AD_BREAK_EVENT_START-{"type":"adBreakStart"}AD_BREAK_EVENT_END-{"type":"adBreakEnd"}
Bu etkinlikler için streamEvent.type ile bir JSON dizesi yükü ekleyin. Reklam önceden yüklemeyi desteklemek için AD_BREAK_EVENT_ANNOUNCE etkinliği streamEvent.duration ve streamEvent.offset değerlerini içermelidir. Daha fazla bilgi için HbbTV yayın etkinliklerini dinleme başlıklı makaleyi inceleyin.
Yayın akışınızı ayarlamak için çoklu MPEG aktarım akışı örneğine bakın.
Örnek akışı kullanmak için uygulama bilgileri tablosu URL'sini kendi akış kurulumunuza göre güncellemeniz gerekir.
Pod yayınlı canlı yayın etkinliği oluşturma
HbbTV uygulamanıza reklam yayınlamak için kapsül yayınlama canlı yayın etkinliğine ihtiyacınız vardır. Etkinliği ayarlama hakkında bilgi edinmek için DAI için canlı yayın oluşturma başlıklı makaleyi inceleyin. Ayarladığınız akışa erişmek için uygulamada aşağıdaki değişkenler bulunmalıdır:
NETWORK_CODE: Reklam isteğinde bulunmak için kullanılan Ad Manager ağ kodu.CUSTOM_ASSET_KEY: DAI için canlı yayın kurulumu sırasında oluşturulan Ad Manager özel öğe anahtarı.
Uygulama dosyası yapısını oluşturma
Bu kılavuzda, IMA HbbTV örnek uygulamasında kullanılan dosya yapısına benzer bir yapı kullanılır. Bu kılavuzu takip etmek için aşağıdaki dosyaları oluşturun:
index.html: Uygulamanızın HTML dizini.Style.css: Uygulamanız için CSS stili.application.js: Ana JS giriş noktası. Oynatma durumunu ve reklam aralarını yönetir.video_player.js: Reklam oynatma için kullanılan dash.js oynatıcısını yönetir.ads_manager.js: IMA kurulumunu, yayın isteğini ve etkinlik işlemeyi yönetir.
ads_manager.js, IMA DAI SDK'sını kurar. Aşağıdaki bileşenler IMA DAI SDK'sını uygular:
PodStreamRequest: Google'ın reklam sunucularına yönelik bir akış isteğini tanımlayan nesne.StreamManager: Dinamik reklam ekleme akışlarını ve DAI arka ucuyla etkileşimleri işleyen bir nesne. Yayın yöneticisi, izleme ping'lerini de işler ve yayın ile reklam etkinliklerini yayıncıya yönlendirir.
Test ortamınızı ayarlama hakkında ayrıntılı talimatlar için HbbTV uygulaması çalıştırma hakkındaki bu kılavuza bakın.
IMA DAI SDK'sını ve DASH.js'yi yükleme
Yayın reklamı akışı oynatmayı başlatmak için IMA DAI SDK'sını ve dash.js'yi uygulamanıza yükleyin. application.js etiketinden önce, index.html içinde komut dosyası etiketlerini kullanarak dash.js'yi ve IMA çerçevesini ekleyin.
Ardından, dash.js oynatıcıyı başlatmak ve kontrol etmek için bir video oynatıcı sarmalayıcı sınıfı oluşturun.