DAI için IMA SDK'sını ayarlama

Platform seçin: HTML5 Android iOS tvOS Cast Roku

IMA SDK'ları, multimedya reklamları web sitelerinize ve uygulamalarınıza entegre etmenizi kolaylaştırır. IMA SDK'ları, VAST uyumlu herhangi bir reklam sunucusundan reklam isteğinde bulunabilir ve uygulamalarınızda reklam oynatmayı yönetebilir. IMA DAI SDK'ları ile uygulamalar, reklam ve içerik videosu için (VOD veya canlı içerik) bir akış isteğinde bulunur. SDK daha sonra birleşik bir video akışı döndürür. Böylece uygulamanızda reklam ve içerik videosu arasında geçişi yönetmeniz gerekmez.

İlgilendiğiniz DAI çözümünü seçin

Kapsül yayınlama DAI

IMA SDK'ları, multimedya reklamları web sitelerinize ve uygulamalarınıza entegre etmenizi kolaylaştırır. IMA SDK'ları, VAST uyumlu herhangi bir reklam sunucusundan reklam isteğinde bulunabilir ve uygulamalarınızda reklam oynatmayı yönetebilir. IMA DAI SDK'ları ile uygulamalar, reklam ve içerik videosu için (VOD veya canlı içerik) bir akış isteğinde bulunur. SDK daha sonra birleşik bir video akışı döndürür. Böylece uygulamanızda reklam ve içerik videosu arasında geçişi yönetmeniz gerekmez.

Bu kılavuzda, canlı ve seç-izle akış oynatma için bir video oynatıcıyla IMA DAI SDK'sı kullanılarak DAI kapsül yayınlama akışının nasıl oynatılacağı gösterilmektedir. Tamamlanmış bir örnek entegrasyonu görüntülemek veya takip etmek için kapsül yayınlama örneğini indirin.

IMA DAI Kapsül Yayınlamaya Genel Bakış

  • StreamRequest: Google'ın reklam sunucularına yönelik bir yayın isteğini tanımlayan nesne. Kapsül yayınlamanın etkinleştirilmesi için ImaSdkFactory.createPodStreamRequest() veya ImaSdkFactory.createPodVodStreamRequest() kullanılarak oluşturulmalıdır. Bu yöntemler için Ağ Kodu gerekir. createPodStreamRequest için ise Özel Öğenin Anahtarı ve isteğe bağlı API anahtarı gerekir. Her ikisi de diğer isteğe bağlı parametreleri içerir.

  • StreamManager: İzleme ping'lerini tetikleme ve yayın içi etkinlikleri yayıncıya yönlendirme gibi video akışı ile IMA DAI SDK arasındaki iletişimi yöneten bir nesne.

Ön koşullar

Kapsül yayınlama değişkenlerinizi ayarlama

Kapsül yayınlama için gereken tüm değişiklikler SampleAdsWrapper.java içinde yapılır. İlk adım, sabit değişkenleri güncellemektir.

Eklenecek reklam kapsülü yayın isteği sabitleri şunlardır:

  • STREAM_URL: Yalnızca canlı yayınlar için kullanılır: Kapsül yayınlama kullanılarak bildirim dosyanızı işleyen veya üçüncü taraf iş ortağınız tarafından sağlanan video akışı URL'si. İstek yapmadan önce IMA DAI SDK'nın sağladığı yayın kimliğini girmenizi gerektirmelidir. Bu durumda, yayın URL'si bir yer tutucu içerir. "[[STREAMID]]", istekte bulunmadan önce yayın kimliğiyle değiştirilir.

  • NETWORK_CODE: Ad Manager 360 hesabınızın ağ kodu.

  • CUSTOM_ASSET_KEY: Yalnızca canlı yayınlar için kullanılır: Ad Manager 360'taki Pod Serving etkinliğinizi tanımlayan özel öğe anahtarı. Bu, manifest düzenleyiciniz veya üçüncü taraf kapsül yayınlama iş ortağınız tarafından oluşturulabilir.

  • API_KEY: Yalnızca canlı yayınlar için kullanılır: IMA DAI SDK'dan akış kimliği almak için gerekebilecek isteğe bağlı bir API anahtarıdır.

Android DAI BasicExample, çeşitli akış türlerini oynatmak için tasarlanmıştır ancak kapsül yayınlama için yalnızca tek bir akış oynatacak şekilde ayarlanmıştır. Örneğin değişken bölümünü aşağıdakiyle eşleşecek şekilde değiştirin:

/** This class implements IMA to add pod ad-serving support to SampleVideoPlayer */
@SuppressLint("UnsafeOptInUsageError")
/* @SuppressLint is needed for new media3 APIs. */
public class SampleAdsWrapper
    implements AdEvent.AdEventListener, AdErrorEvent.AdErrorListener, AdsLoader.AdsLoadedListener {

  // Set up the pod serving variables.
  private static final String NETWORK_CODE = "";
  private static final String CUSTOM_ASSET_KEY = "";
  private static final String API_KEY = "";
  private static final String STREAM_URL = "";
  private static final StreamFormat STREAM_FORMAT = StreamFormat.HLS;

Kapsül yayınlamayı etkinleştirmek için canlı veya VOD kapsül akışı isteği oluşturma

Canlı yayın kapsülü yayınlama

Çeşitli akış türleri oluşturma arasında geçiş yapmak için kullanılan yöntemi buildStreamRequest() kaldırın. Ardından, requestAndPlayAds() öğesini ImaSdkFactory.createPodStreamRequest() olarak değiştirerek canlı pod yayınlama reklamı isteği oluşturun.

// Live pod stream request.
request = sdkFactory.createPodStreamRequest(NETWORK_CODE, CUSTOM_ASSET_KEY, API_KEY);

VOD akışı kapsülü yayınlama

Çeşitli akış türleri oluşturma arasında geçiş yapmak için kullanılan yöntemi buildStreamRequest() kaldırın. Ardından, requestAndPlayAds() öğesini değiştirerek ImaSdkFactory.createPodVodStreamRequest() öğesini çağırın ve bir VOD pod yayınlama reklamı isteği oluşturun.

// VOD pod stream request.
request = sdkFactory.createPodVodStreamRequest(NETWORK_CODE);

Akış isteği örneğini oluşturduktan sonra AdsLoader.requestStream() kullanarak akışı isteyin:

request.setFormat(STREAM_FORMAT);
adsLoader.requestStream(request);

Akış URL'sini düzenleme ve ayarlama

Canlı yayın kapsülü yayınlama

Akış kimliğini almak için StreamManager.getStreamId() yöntemini çağırın. Bu, "[[STREAMID]]" yerine STEAM_URL içine eklenmelidir. Bu değişiklik yapıldıktan sonra videoPlayer.setStreamUrl() yöntemini kullanarak yeni yayın URL'sini ayarlayın ve yayın oynatmayı başlatmak için videoPlayer.play() yöntemini çağırın.

// Play the live pod stream.
streamID = streamManager.getStreamId();
String liveStreamUrl = STREAM_URL.replace("[[STREAMID]]", streamID);
// Call videoPlayer.play() here, because IMA doesn't call the VideoStreamPlayer.loadUrl()
// function for livestreams.
videoPlayer.setStreamUrl(liveStreamUrl);
videoPlayer.play();

VOD akışı kapsülü yayınlama

  1. Akış kimliğini almak için StreamManager.getStreamId() yöntemini çağırın.
  2. Video teknolojisi iş ortağınızdan (VTP) bir yayın URL'si isteyin.
  3. VTP'nizden URL'yi aldıktan sonra akışı yüklemek için URL ile birlikte StreamManager.loadThirdPartyStream() yöntemini çağırın. VTP'nizin döndürdüğü tüm altyazılar da yüklenir.
// Play the VOD pod stream.
streamID = streamManager.getStreamId();
String vodStreamUrl = "";
// Refer to your Video Tech Partner (VTP) or video stitching guide to fetch the stream URL
// and the subtitles for a the ad stitched VOD stream.

// In the following commented out code, 'vtpInterface' is a place holder
// for your own video technology partner (VTP) API calls.
// vodStreamUrl = vtpInterface.requestStreamURL(streamID);
List<Map<String, String>> subtitles = new ArrayList<>();
streamManager.loadThirdPartyStream(vodStreamUrl, subtitles);

VOD pod yayınlama istekleri için IMA, akış yüklendiğinde VideoStreamPlayer.loadUrl() geri çağırma işlevini çağırır. Yayın oynatmayı başlatmak için videoPlayer.setStreamUrl() ve videoPlayer.play() çağrılarını VideoStreamPlayer.loadUrl() geri çağırma işlevine ekleyin:

private VideoStreamPlayer createVideoStreamPlayer() {
  return new VideoStreamPlayer() {
    @Override
    public void loadUrl(String url, List<HashMap<String, String>> subtitles) {
      // IMA doesn't make calls to VideoStreamPlayer.loadUrl() for pod serving live streams.
      // The following code is for VOD streams.
      videoPlayer.setStreamUrl(url);
      videoPlayer.play();
    }

IMA DAI öğelerini temizleme

IMA DAI SDK ile bir pod yayınlama akışında reklam isteme ve görüntüleme işlemlerini başarıyla tamamladığınızda, pod yayınlama oturumu tamamlandıktan sonra tüm kaynakları temizlemenizi öneririz. Akış oynatmayı durdurmak, tüm reklam izlemeyi durdurmak ve yüklenen tüm akış öğelerini serbest bırakmak için StreamManager.destroy() işlevini çağırın.

Android SDK'nın kullanıldığı diğer örnekleri görmek için GitHub'daki örneklere bakın.