DAI oynatıcı ve uygulama geliştirme kılavuzu

Aşağıdakilerden yararlanarak Dinamik Reklam Ekleme (DAI) için oynatıcı ve uygulama geliştirmenizi planlayabilir ve yönetebilirsiniz.

İlgili bölüme git

  DAI platform desteği
  Video oynatıcısı denetimleri desteği
  Varsayılan reklam etiketini geçersiz kılma
  Akış varyantı parametrelerini geçersiz kılma
  Sık sorulan sorular

DAI oynatıcı uygulama türlerini karşılaştırın.

Platform desteği

Dinamik Reklam Ekleme için sunulan destek (desteklenmediği platformlar da dahil) aşağıda gösterilmiştir. Örnek uygulamaları görüntülemek ve her bir platform hakkında daha fazla bilgi edinmek için tıklayabilirsiniz.

Temel örnek uygulamalar yalnızca video izleme etkinliklerini gösterir. Bunlar yalnızca videodan önce gösterilen reklamları kullanan yayıncılar için uygundur.

Gelişmiş örnek uygulamalar tüm temel uygulama işlevlerini ve bunun yanı sıra yer işareti koyma, reklam atlamayı önleme, altyazı, ilk kare gösterme ve geri sayım zamanlayıcıyı gösterir. Bunlar, uzun süreli içerikten para kazanan yayıncılar için ideal özelliklerdir.

Platform	SSB desteği	DAI özelliği etkin IMA SDK'sı	Örnek uygulamalar	Ek belgeler
iOS	Evet	iOS IMA SDK'sı	iOS örnek uygulamaları	iOS hızlı başlangıç rehberi iOS referansı
Android veya FireTV	Evet	Android IMA SDK'sı	Android örnek uygulamaları	Android hızlı başlangıç rehberi Android referansı
tvOS (Apple TV)	Evet	tvOS IMA SDK'sı	tvOS örnek uygulamaları	tvOS hızlı başlangıç rehberi tvOS referansı
Roku	Evet	Çalıştırma zamanında indirilen SDK	Roku örnek uygulamaları	Roku hızlı başlangıç rehberi
Chromecast	Evet	Çalıştırma zamanında indirilen SDK	Örnek alıcı uygulaması Genel olarak, Chromecast cihaza "yayın yapabilen" bir iOS veya Android uygulamanızın da olması gerekir. Örnek olarak, iOS veya Android için "gelişmiş örnek" uygulamalarına başvurabilirsiniz.	Chromecast hızlı başlangıç rehberi
HTML5	Evet	Çalıştırma zamanında indirilen SDK	HTML5 örnek uygulaması DAI demosu HTML5 oynatıcısı	HTML5 hızlı başlangıç rehberi

Video oynatıcısı denetimleri desteği

Video oynatıcı kontrolleri yalnızca IMA SDK'nın etkinleştirilmesiyle desteklenir. Tüm gelişmiş örnek uygulamalar, desteklenen çeşitli platformlarda özellik işlevi gösterir. İşaret noktası bilgileri özelliği de temel örnek uygulamalar dahilinde gösterilebilir.

• Toplam Reklam Geri Sayımı ve Reklam Başına Geri Sayım: Toplam reklam sayısı için kalan süreyi belirtmek üzere geri sayım ekleyebilme.

  iOS ve Android: IMA SDK'sında bu isteğe bağlı özellik bulunur.

  Roku ve tvOS: IMA SDK'sı kapsamında, gelişmiş örnek uygulama bu özelliğin bir örneğini içerir. Bu özellik gerekliyse özel kod eklemeniz gerekir.

• Altyazı: İçerik akışı dahilinde altyazı ekleyebilme. Desteklenen altyazı programları şunlardır:

  Zamanlanmış Metin Biçimlendirme Dili (TTML) (yardımcı dosya): TTML'nin kod dönüştürme veya hâlihazırda altyazı oluşturma işlevleri için kullanılan eski dağıtım içeriği biçimleri arasında zamanlanmış metin bilgilerinin alınıp verilmesini sağlama amacıyla kullanılması hedeflenmiştir.

  WebVTT (yardımcı dosya): WebVTT dosyaları video içeriği için altyazılar, metin biçiminde video açıklamaları, içerikte gezinme için bölümler ve daha genel kapsamda ses veya video içeriğiyle zaman uyumlu olan herhangi bir biçimdeki meta veriler sağlar.

• Yer İşareti Koyma: Yer işareti koyma, içerik akışında belirli bir noktayı kaydetme ve daha sonra bu noktaya dönme olanağıdır. Bir kullanıcının beş dakikalık içerik izlediğini, bu video akışından ayrıldığını ve daha sonra akışa döndüğünü varsayalım. Yer işareti koyma özelliği, kullanıcının akış içindeki konumunu kaydederek akışın kaldığı yerden devam edebilmesini sağlar ve böylece izleyiciye sorunsuz bir deneyim sunar.
• Reklam Atlamayı Önleme: Reklam atlamayı önleme, kullanıcıyı atladığı reklam arasının başlangıcına geri götürme ve reklam arası tamamlandıktan sonra daha önce gittiği oynatma konumuna döndürme özelliğidir.
• İlk Kare Gösterme: Genelde uzun süreli içerikler için kullanılan bu özellik kullanıcı içerik çubuğunda kaydırma yaptığı sırada ilk karenin gösterilebilmesidir.

Varsayılan reklam etiketini geçersiz kılma

Ad Manager'da VOD için DAI içerik kaynağı veya canlı doğrusal akış tanımlarken varsayılan video reklam etiketi belirtmeniz gerekir.

Video oynatıcınız bir akış isteğinde bulunduğunda bu reklam etiketi tam olarak kullanıcı arayüzünde belirttiğiniz şekilde kullanılacaktır. Ancak isterseniz akış isteğinizde bu etiketin parametrelerini geçersiz kılabilirsiniz.

Akışınıza hedefleme parametreleri sağlamayı öğrenin.

Akış varyantı parametrelerini geçersiz kılma

Varsayılan HLS oynatma listesi sırası, yayıncı tarafından belirlenir.

Varyant seçimi ve sırası parametrelerinin geçersiz kılınması, akış oluşturma sırasında belirtilebilir. Bu sayede, bir ana oynatma listesi isteğine verilen yanıta ve bu varyantların sırasına dahil edilmesi gereken bir varyant alt kümesi belirtebilirsiniz. Varyant alt kümesi ve sırası, açıkça geçersiz kılınmadığı sürece akışın ömrü boyunca aynı kalacaktır.

Akış varyantı parametrelerini geçersiz kılmayı öğrenin.

Sık sorulan sorular

Tümünü genişlet  Tümünü daralt

Videodan önce gösterilen reklamları nasıl gösterebilirim?

VOD akışlarında reklam kurallarını kullanarak videodan önce gösterilen reklamların gösterilip gösterilmeyeceğini yapılandırabilirsiniz.

Canlı doğrusal akışlarda, Ad Manager'ı videodan önce gösterilen reklamlar gösterecek şekilde yapılandırabilirsiniz. İsteğe bağlı olarak video oynatıcınız, Ad Manager DAI canlı akışını istemeden önce kullanıcıya videodan önce gösterilen reklam göstermek için istemci tarafı Ad Manager reklam isteğinde bulunur.

Reklam tatili belirleme

---

Canlı doğrusal akışlarda, izleyicilere videodan önce gösterilen reklam izlendikten hemen sonra başka bir DAI gösterilmesini önlemek için "reklam tatili" özelliğini kullanabilirsiniz.

Reklam tatili belirleme işlemi iki adımdan oluşur:

1. DAI için canlı yayın oluştururken "Reklam tatili süresi"ni belirtin.
2. Akış oluşturma isteğinizdeki adtagparameters dizisinde 1 olarak ayarlanmış dai-ah parametresini iletin. Bu, Ad Manager reklam etiketi parametrelerini geçersiz kıldığınızda ve akış varyantı parametreleri ayarladığınızda kullanılan dizidir.

Birden fazla CDN'den nasıl talebe bağlı video içeriği yayınlayabilirim?

Talebe bağlı video içeriğiniz için CDN yapılandırması oluşturduğunuzda, varsayılan CDN yapılandırması ve ek CDN yayınlanma ayarları tanımlayabilirsiniz. Bu, oturumun başında anahtar/değer çifti kullanarak birden fazla CDN oluşturmanıza ve hangisinden yayın yapılacağını dinamik olarak seçmenize olanak tanır.

CDN yapılandırmalarınızı oluşturduktan ve kaydettikten sonra Ad Manager her bir yapılandırmanıza ad atar. Bu ad, dai-dlid parametresinin bir değeri olarak akış oluşturma isteğine iletilmelidir. *

SSB için parametre dai-dlid=AaBbC1aaBa0obA1BABaaBA olarak iletilebilir (burada AaBbC1aaBa0obA1BABaaBA Ad Manager'da görünen addır).

IMA SDK kullanılırken bu SDK'yı reklam etiketi parametreleri aracılığıyla akış oluşturma isteğine iletmeniz gerekir.

_{* İsteğe herhangi bir ad iletilmezse Ad Manager varsayılan CDN'yi kullanır.}

Örnek uygulamada nasıl talebe bağlı video akışı isteğinde bulunabilirim?

VOD akış istekleri, video içeriğine reklam hedeflemenize olanak tanıyan cmsid ve vid değerlerini içerir.

Ad Manager'dan video içeriği alınırken sorun oluşursa ne yapmalıyım?

Uygulamanız Ad Manager'dan yanıt alırken bir sorun algılarsa mantığı, ham içeriği reklamsız oynatacak şekilde kodlamanız gerekir. VOD akışlarında bu işlemi, içerik kaynağı MRSS feed'inizde Ad Manager için belirtilmiş ingestUrl değeriyle yapabilirsiniz. Canlı doğrusal akışlarda ise kodlayıcınıza ait akışın URL'sini kullanabilirsiniz. DAI yedek akışları için en iyi uygulamalar hakkında daha fazla bilgi

Neden Sunucu Tarafı İşaretleme (SSB) özeliği yerine IMA SDK'ya geçmeliyim?

IMA SDK, yayıncının raporlama amacıyla sinyalleri zenginleştirmesine ve etkinlik izlemeyi daha doğru hale getirmesine olanak tanır. DAI için Sunucu Tarafı İşaretleme hakkında daha fazla bilgi

Sunucu tarafı akışlarla ilgili sorunları nasıl giderebilirim?

Video oynatıcınız Ad Manager DAI'dan her akış isteğinde bulunduğunda, akış bir oturum kimliği ile birlikte döndürülür. Akışınızdaki reklamlarda hata ayıklamanız gerektiğinde bu akış kimliğini uygulamanızda görebildiğinizden emin olmanız gerekir. Akış etkinliğini izlemek ve ilgili sorunları gidermek için bu akış kimliğini kullanabilirsiniz.

DAI sorunlarını giderme veya kesintilerle ilgili konular için yayıncı destek ekibiyle iletişime geçin.