IMA DAI SDK スタートガイド

IMA SDK を使用すると、ウェブサイトやアプリにマルチメディア広告を簡単に統合できます。IMA SDK は 任意のネットワークから広告をリクエストし、 <ph type="x-smartling-placeholder"></ph> VAST 準拠の広告サーバーを実装し、アプリでの広告再生を管理できます。IMA DAI SDK を使用すると、アプリは広告とコンテンツ動画（VOD またはライブ コンテンツ）のストリーム リクエストを行います。すると、SDK は 統合動画ストリームであるため、広告とコンテンツ動画の切り替えを管理する手間が省けます。 確認できます。

関心のある DAI ソリューションを選択する

Pod Serving DAI

このガイドでは、 tvOS 向け IMA DAI SDK とシンプルな動画プレーヤーが必要です。完成したサンプルに沿って学習する場合は、Pod Serving サンプルアプリ（Obj C または Swift）をダウンロードしてください。

IMA DAI Pod Serving の概要

tvOS 向け IMA DAI SDK を使用して連続配信広告を実装するには、主に次の 2 つの作業を行います。 components:

  • StreamRequest: ストリーミング リクエストを定義するオブジェクト。 Google の広告サーバー。次のいずれかを使用して作成する必要があります。 IMAPodStreamRequest または IMAPodVODStreamRequest 有効にする必要がありますどちらの方法でも、ネットワーク コードと IMAPodStreamRequest にはカスタム アセットキーも必要です。API キーは省略可能です。

  • IMAStreamManager: 動画ストリームと IMA DAI SDK 間の通信を処理するオブジェクト（トラッキング ピングの発行、ストリーム イベントのパブリッシャーへの転送など）。

前提条件

始める前に、次のものが必要になります。

  • Xcode 13 以降。
  • CocoaPods（推奨）、Swift Package Manager、または tvOS 用 IMA DAI SDK のダウンロード コピー。
  • DAI 広告付きの動画ストリームを再生するように IMA DAI SDK ですでに設定されている tvOS アプリ。該当するアプリがない場合は、 tvOS DAI BasicExample を 出発点になります。BasicExample には、このガイドで参照されているコードベースがあります。IMA DAI SDK を実装する方法について詳しくは、クイックスタート ガイドをご覧ください。

連続配信広告の変数を設定する

Pod サービングに必要な変更はすべて、Swift の ViewController.swift または Objective-C の ViewController.m で行います。このガイドのスニペットは、デフォルトで Swift 言語を使用します。最初のステップは 使用します。

追加する広告連続配信ストリーム リクエスト定数は次のとおりです。

  • STREAM_URL（ライブ配信にのみ使用）: 連続配信広告を使って マニフェストマニピュレータやパートナー事業者が本来は IMA DAI SDK で提供されるストリーム ID を挿入してから、 リクエストできます。この場合、ストリーム URL にはプレースホルダ "[[STREAMID]]" が含まれており、リクエストの前にストリーム ID に置き換えられます。
  • NETWORK_CODE: アド マネージャー 360 アカウントのネットワーク コード。
  • CUSTOM_ASSET_KEY（ライブ配信でのみ使用）: カスタム アセットキー はアド マネージャー 360 で連続配信広告の配信イベントを識別します。これを作成するには、 サードパーティの 広告連続配信パートナーを設定するだけです
  • API_KEY（ライブ配信にのみ使用）: IMA DAI SDK からストリーム ID を取得するために必要なオプションの API キー。

サンプルの変数セクションを次のように変更します。

...
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?
  ...

ライブまたは VOD の連続配信広告ストリーム リクエストを作成する

ライブ配信の連続配信

requestStream メソッドを変更して、Pod のライブ ストリーム リクエストを作成します。 IMAPodStreamRequest をインスタンス化しています。

  ...

  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 ストリームの広告連続配信

requestStream メソッドを変更して、IMAPodVODStreamRequest をインスタンス化して VOD Pod ストリーム リクエストを作成します。

  ...

  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)
  }

  ...

ストリーム URL を編集して設定する

ライブ配信の連続配信広告

IMAAdsLoaderDelegate メソッドを変更し、streamManager.streamId を使用して以下を行います。 ストリーム ID を取得します。次に、"[[STREAMID]]" に代わるストリーム ID を STREAM_URL に挿入します。この変更を加えると、videoDisplay.loadStream() を使用して新しいストリーム URL を設定できます。

  ...

  // 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 ストリームの広告連続配信

IMAAdsLoaderDelegate メソッドを変更し、streamManager.streamId を使用して以下を行います。 ストリーム ID を取得します。次に、使用する動画テクノロジーにストリーム URL をリクエストします。 パートナー（VTP）と IMAStreamManager.loadThirdPartyStream() を呼び出して IMA を取得する TVP から返されたストリーム URL と字幕を読み込みます。

  ...

  // 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
  }

これで、「連続配信広告」ストリームで広告をリクエストして表示し、 tvOS 向け IMA DAI SDKIMA DAI SDK の使用例については、GitHub のサンプルをご覧ください。