IMA DAI SDK, minimum HbbTV video oynatıcı uygulamasına entegrasyonu destekler. IMA DAI SDK, bir geniş bant reklam akışı için Google Ad Manager talebinin yayın içeriği akışına eşlik etmesini 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.
dash.js kullanılmaktadır.Diğer HbbTV dışı platformlarla entegrasyon hakkında bilgi 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.
- Önceden 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 Bilgileri Tablosu (AIT) verileri içeren bir yayın akışı hazırlayın. Ayrıca, yayın akışını TV'de alınacak şekilde 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 tarafından erişilebilen 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 ayarlayarak ilişkili JSON dizesi yükünü eklemeniz gerekir:
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 kendi akış kurulumunuzla ilgili uygulama bilgileri tablosu URL'sini güncellemeniz gerekir.
Pod yayınlı canlı yayın etkinliği oluşturma
HbbTV uygulamanızda 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.