Reklam oynatma listelerini otomatikleştirme

Platform seçin: HTML5 Android iOS tvOS

SDK çalışma modları

SDK, reklam sunucusundan aldığı reklam yanıtına bağlı olarak bir veya daha fazla modda çalışabilir.

Tek reklam
Mesaj start IMAAdsManager gönderildiğinde dilediğiniz zaman oynatılabilen bir reklam. Tek bir reklamın oynatılması için özel bir başlatma işlemi gerekmez.
Reklam kapsülü
start mesajı IMAAdsManager adresine gönderildiğinde arka arkaya oynatılan birkaç reklam. Tek bir reklam kapsülü oynatmak için özel bir başlatma işlemi gerekmez.
Reklam kuralları
Belirli içeriklere karşı belirli zamanlarda planlanmış reklam aralarından oluşan bir oynatma listesi. start mesajı, reklam kuralları modunda yoksayılır. Tek bir oynatma listesinde planlanmış birkaç reklam arası olabilir (ör. videodan önce gösterilen reklam, videonun ortasında gösterilen reklam, 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'sı, tamamen otomatik reklam oynatma listelerini destekler. Bu özellik, reklamlarınız trafiğe eklenirken Google Ad Manager'da belirtildiği şekilde içeriğe reklam araları ekler. Ayrıca, videodan önce gösterilen reklamlar, videonun ortasında gösterilen reklamlar 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 reklam trafiği oluştururken "içeriğin başında her zaman reklam arası oynat" veya "her 30 dakikalık içerikte bir dakikalık reklam arası oynat" gibi çeşitli reklam kuralları belirleyebilirsiniz.
  • Reklam istendiğinde 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ırken IMAContentPlayhead nesnesi initializeWithContentPlayhead:adsRenderingSettings: çağrısı üzerinden iletilir. İçeriğinizi göstermek için AVPlayer kullanıyorsanız IMAAVPlayerContentPlayhead örneğini adDisplayContainer oluştururken SDK'ya iletirsiniz. Bu nesne, içerik oynatma ilerlemesini 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:

    1. IMAContentPlayhead arayüzünü uygulayın.
    2. Video oynatıcınızın geçerli saatini döndürmek için currentTime uygulayın.
    3. IMAAdsManager başlatma çağrısını initializeWithContentPlayhead:self kullanacak şekilde değiştirin.
  • Reklam araları oynatılırken içeriği duraklatmak ve devam ettirmek için IMAAdsManagerDelegate kullanılır.

Not: İçerik oynatıldıktan sonra veya kullanıcı oynatmayı durdurduktan sonra, içeriğin oynatılmasının tamamlandığını SDK'ya bildirmek için contentComplete IMAAdsLoader üzerinde çağrıldığından emin olun. SDK daha sonra, planlanmışsa videodan sonra gösterilen reklam arasını oynatır. Tüm reklam araları oynatıldığında ALL_ADS_COMPLETED etkinliği tetiklenir. Ayrıca, içerik izlemenin IMAAdsManager'nın initializeWithContentPlayhead:adsRenderingSettings yöntemi çağrıldığında başladığını ve içeriği oynatmadan önce her zaman initializeWithContentPlayhead:adsRenderingSettings'ı çağırmanız gerektiğini unutmayın.