Bu sayfa, Cloud Translation API ile çevrilmiştir.

IMA DAI SDK'sını kullanmaya başlama

IMA SDK'ları, multimedya reklamlarını web sitelerinize ve uygulamalarınıza entegre etmenizi kolaylaştırır. IMA SDK'ları, VAST uyumlu herhangi bir reklam sunucusundan reklam isteyebilir ve uygulamalarınızda reklam oynatmayı yönetebilir. IMA DAI SDK'larıyla uygulamalar, reklam ve içerik videosu (VOD veya canlı içerik) için akış isteğinde bulunur. Daha sonra SDK, uygulamanızın içinde reklam ve içerik videosu arasında geçişi yönetmek zorunda kalmamanız için birleştirilmiş video akışı döndürür.

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

Kapsül yayınlama DAI

Bu kılavuzda, basit bir video oynatıcıda tvOS için IMA DAI SDK'sı kullanılarak canlı veya VOD yayın yapan DAI Kapsül Yayınlama gösterilmektedir. Tamamlanmış bir örnekle birlikte devam etmek isterseniz Kapsül Yayınlama örnek uygulamasını indirin (Obj C veya Swift).

IMA DAI Kapsül Yayınlamaya genel bakış

tvOS için IMA DAI SDK'sını kullanarak kapsül yayınlamanın uygulanması iki ana bileşen içerir:

StreamRequest: Google'ın reklamcılık sunucularına yapılan akış isteğini tanımlayan bir nesnedir. Kapsül sunmayı etkinleştirmek için IMAPodStreamRequest veya IMAPodVODStreamRequest kullanılarak oluşturulmalıdır. Her iki yöntem de bir Ağ Kodu ve IMAPodStreamRequest bir Özel Öğe Anahtarı gerektirir. İsteğe bağlı olarak API anahtarı kullanılabilir.
IMAStreamManager: Video akışı ile IMA DAI SDK'sı arasındaki iletişimi (ör. izleme ping'lerini tetikleme ve akış etkinliklerini yayıncıya yönlendirme) yöneten bir nesnedir.

Ön koşullar

Başlamadan önce aşağıdakilere ihtiyacınız vardır:

Xcode 13 veya sonraki sürümler.
CocoaPods (tercih edilen), Swift Package Manager veya tvOS için IMA DAI SDK'sının indirilmiş bir kopyası.
DAI reklamlarıyla video akışları oynatmak için IMA DAI SDK'sı ile oluşturulmuş bir tvOS uygulaması. Böyle bir uygulamanız yoksa başlangıç noktası olarak tvOS DAI BasicExample'i kullanmanızı öneririz. BasicExample, bu kılavuzda referans verilen kod tabanını içerir. IMA DAI SDK'sını uygulama hakkında daha fazla bilgi edinmek için Hızlı başlangıç kılavuzunu inceleyin.

Kapsül sunma değişkenlerinizi ayarlama

Kapsül yayınlama için gereken tüm değişiklikler Swift'te ViewController.swift veya Objective-C'de ViewController.m yapılır. Bu kılavuzdaki snippet'lerde varsayılan olarak Swift dili kullanılır. İlk adım, sabit değişkenleri güncellemektir.

Eklenecek reklam kapsülü akış isteği sabit değerleri aşağıda verilmiştir:

STREAM_URL (Yalnızca canlı yayınlar için kullanılır): Manifest düzenleyiciniz veya kapsül yayınlama kullanan üçüncü taraf iş ortağı tarafından sağlanan video akışı URL'si. İstekte bulunmadan önce IMA DAI SDK'sı tarafından sağlanan akış kimliğini girmeniz gerekir. Bu durumda akış URL'si, istekte bulunmadan önce akış kimliğiyle değiştirilen bir yer tutucu ("[[STREAMID]]") içerir.
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'ta kapsül yayınlama etkinliğinizi tanımlayan özel öğe anahtarı. Bu, manifest düzenleyiciniz veya 3. taraf kapsül sunma iş ortağınız tarafından oluşturulabilir.
API_KEY (Yalnızca canlı yayınlar için kullanılır): IMA DAI SDK'sından akış kimliği almak için gerekli olabilecek isteğe bağlı bir API anahtarı.

Örneğin değişken bölümünü aşağıdakiyle eşleşecek şekilde değiştirin:

...
class ViewController:
  UIViewController,
  IMAAdsLoaderDelegate,
  IMAStreamManagerDelegate,
  AVPlayerViewControllerDelegate
{
  static let streamUrl =
    "https://encodersim.sandbox.google.com/masterPlaylist/9c654d63-5373-4673-8c8d-6d92b66b9d46/master.m3u8?gen-seg-redirect=true&network=51636543&event=google-sample&pids=devrel4628000,devrel896000,devrel3528000,devrel1428000,devrel2628000,devrel1928000&seg-host=dai.google.com&stream_id=[[STREAMID]]"
  static let networkCode = "51636543"
  static let customAssetKey = "google-sample"
  static let APIKey = ""
  static let backupStreamURLString =
    "http://googleimadev-vh.akamaihd.net/i/big_buck_bunny/bbb-,480p,720p,1080p,.mov.csmil/master.m3u8"

  var adsLoader: IMAAdsLoader?
  ...

Canlı veya VOD kapsül akış isteği oluşturma

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

IMAPodStreamRequest özelliğini tetikleyerek requestStream yöntemini değiştirerek canlı kapsül yayını isteği oluşturun.

  ...

  func requestStream() {
    guard let playerViewController = self.playerViewController else return
    guard let adContainerView = self.adContainerView else return
    guard let adsLoader = self.adsLoader else return

    self.videoDisplay = IMAAVPlayerVideoDisplay(avPlayer: playerViewController.player)
    adDisplayContainer = IMAAdDisplayContainer(
      adContainer: adContainerView, viewController: self)

    // Create a podserving stream request.
    request = IMAPodStreamRequest(
      networkCode: self.networkCode,
      customAssetKey: self.customAssetKey,
      adDisplayContainer: adDisplayContainer,
      videoDisplay: self.videoDisplay,
      userContext: nil)

    adsLoader.requestStream(with: request)
  }

  ...

VOD akış kapsülü yayınlama

IMAPodVODStreamRequest öğesini tetikleyerek requestStream yöntemini değiştirerek VOD kapsül akışı isteği oluşturun.

  ...

  func requestStream() {
    guard let playerViewController = self.playerViewController else return
    guard let adContainerView = self.adContainerView else return
    guard let adsLoader = self.adsLoader else return

    self.videoDisplay = IMAAVPlayerVideoDisplay(avPlayer: playerViewController.player)
    adDisplayContainer = IMAAdDisplayContainer(
      adContainer: adContainerView, viewController: self)

    // Create a podserving stream request.
    request = IMAPodVODStreamRequest(
      networkCode: self.networkCode,
      adDisplayContainer: adDisplayContainer,
      videoDisplay: self.videoDisplay,
      userContext: nil)

    adsLoader.requestStream(with: request)
  }

  ...

Akış URL'sini düzenleme ve ayarlama

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

Akış kimliğini almak için streamManager.streamId kullanarak IMAAdsLoaderDelegate yöntemlerini değiştirin. Ardından, "[[STREAMID]]" kısmını değiştirerek akış kimliğini STREAM_URL alanına girin. Bu değişiklik yapıldıktan sonra yeni yayın URL'si, videoDisplay.loadStream() kullanılarak ayarlanabilir.

  ...

  // MARK: - IMAAdsLoaderDelegate
  func adsLoader(_ loader: IMAAdsLoader!, adsLoadedWith adsLoadedData: IMAAdsLoadedData!) {
    let streamManager = adsLoadedData.streamManager
    let streamId = streamManager.streamId
    let urlString = streamUrl.replacingOccurrences(of: "[[STREAMID]]", with: streamId)
    let loadedStreamUrl = URL(string:urlString)
    self.videoDisplay.loadStream(loadedStreamUrl, subtitles:@[])
    self.videoDisplay.play()
    streamManager.delegate = self
    streamManager.initialize(with: nil)
    self.streamManager = streamManager
  }

  ...

VOD akış kapsülü yayınlama

Akış kimliğini almak için streamManager.streamId kullanarak IMAAdsLoaderDelegate yöntemlerini değiştirin. Ardından, video teknolojisi iş ortağınızdan (VTP) bir akış URL'si isteyin ve akış URL'sini ve TVP'niz tarafından döndürülen altyazıları IMA yüklemesini sağlamak için IMAStreamManager.loadThirdPartyStream() hizmetini çağırın.

  ...

  // MARK: - IMAAdsLoaderDelegate
  func adsLoader(_ loader: IMAAdsLoader!, adsLoadedWith adsLoadedData: IMAAdsLoadedData!) {
    let streamManager = adsLoadedData.streamManager
    let streamId = streamManager.streamId
    // 'vtpInterface' is a place holder for your own video technology partner
    // (VTP) API calls.
    let streamUrl = vtpInterface.requestStreamURL(streamID)
    self.streamManager.loadThirdPartyStream(streamUrl, streamSubtitles:@[])
    streamManager.delegate = self
    streamManager.initialize(with: nil)
    self.streamManager = streamManager
  }

İşte bu kadar. Şu anda tvOS için IMA DAI SDK'sı ile kapsül yayınlama akışında reklam istiyor ve bu reklamları gösteriyorsunuz. Kullanılan IMA DAI SDK'sının diğer örneklerini görmek için GitHub'daki örneklere bakın.