SDK işlem modları
SDK, reklam sunucusundan aldığı reklam yanıtına bağlı olarak bir veya daha fazla modda çalışabilir.
- Tek reklam
start
mesajıIMAAdsManager
adlı cihaza gönderildiğinde herhangi bir zamanda oynatılabilen reklamdır. Tek bir reklamı oynatmak için özel bir başlatma yapılması gerekmez.- Reklam kapsülü
start
mesajıIMAAdsManager
adlı cihaza gönderildiğinde arka arkaya oynatılan birkaç reklam. Tek bir reklam kapsülünü oynatmak için özel başlatma gerekmez.- Reklam kuralları
- Belirli zamanlarda, belirli içerikler için planlanan reklam aralarından oluşan bir oynatma listesidir.
start
mesajı, reklam kuralları modunda yoksayılır. Tek bir oynatma listesi içinde birden fazla reklam arası planlanabilir (ör. videodan önce, videonun ortasında, videodan sonra gösterilen reklam). Uygulamayla ilgili daha fazla bilgi için aşağıdaki Reklam Kuralları bölümüne bakın.
Reklam kuralları
IMA tvOS SDK, tamamen otomatik reklam oynatma listelerini destekler. Bu özellik, reklamlarınız trafiğe eklenirken Google Ad Manager'da belirtildiği gibi içeriğe reklam araları ekler. Ayrıca videodan önce, videonun ortasında ve videodan sonra gösterilen reklamlar dahil olmak üzere reklam aralarını desteklemek için gereken video oynatıcı kodunu büyük ölçüde basitleştirir.
- Ad Manager'da reklamları trafiğe eklerken "her zaman içeriğin başında reklam arası oynat" veya "içerik her 30 dakikada bir bir dakikalık reklam arası oynat" gibi çeşitli reklam kuralları belirtmek mümkündür.
- Reklam isteğinde bulunulduğunda, reklam sunucusu bir reklam oynatma listesi döndürebilir. SDK, oynatma listesini işler ve belirtilen reklam aralarını otomatik olarak planlar.
AdsManager
başlatılırkeninitializeWithContentPlayhead:adsRenderingSettings:
çağrısıyla birIMAContentPlayhead
nesnesi aktarılır. İçeriğinizi görüntülemek için AVPlayer kullanıyorsanızadDisplayContainer
oluşturduğunuzda SDK'ya birIMAAVPlayerContentPlayhead
örneği iletirsiniz. Bu nesne, içerik oynatmanın ilerleme durumunu izlemek için kullanılır. Böylece reklam araları Ad Manager'da belirtilen zamanlarda otomatik olarak eklenir.
AVPlayer ile:
IMAContentPlayhead *contentPlayhead = [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer]; IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl adDisplayContainer:adDisplayContainer contentPlayhead:contentPlayhead userContext:nil];
AVPlayer olmadan:
IMAContentPlayhead
arayüzünü uygulayın.- Video oynatıcınızın geçerli zamanını döndürmek için
currentTime
uygulayın. initializeWithContentPlayhead:self
özelliğini kullanmak içinIMAAdsManager
başlatma çağrısını değiştirin.
- IMAAdsManagerDelegate, reklam araları oynatılırken içeriği duraklatmak ve devam ettirmek için kullanılır.
Not: İçeriğin oynatılması sona erdiğinde veya kullanıcı oynatmayı durdurduğunda, SDK'ya içeriğin oynatılmasının tamamlandığına dair sinyal vermek için IMAAdsLoader
üzerinde contentComplete
yöntemini çağırdığınızdan emin olun. SDK, planlanmışsa videodan sonra gösterilen reklam arasını oynatır.
Tüm reklam araları oynatıldığında ALL_ADS_COMPLETED
etkinliği yükseltilir. Ayrıca, içerik izlemenin IMAAdsManager
initializeWithContentPlayhead:adsRenderingSettings
yöntemi çağrıldığında başladığını ve içeriği oynatmadan önce her zaman initializeWithContentPlayhead:adsRenderingSettings
yöntemini çağırmanız gerektiğini unutmayın.