IMA DAI SDK দিয়ে শুরু করুন

IMA SDKগুলি আপনার ওয়েবসাইট এবং অ্যাপগুলিতে মাল্টিমিডিয়া বিজ্ঞাপনগুলিকে একীভূত করা সহজ করে তোলে৷ IMA SDK যেকোন VAST-সঙ্গী বিজ্ঞাপন সার্ভার থেকে বিজ্ঞাপনের অনুরোধ করতে পারে এবং আপনার অ্যাপে বিজ্ঞাপন প্লেব্যাক পরিচালনা করতে পারে। IMA DAI SDK-এর সাথে, অ্যাপগুলি বিজ্ঞাপন এবং বিষয়বস্তু ভিডিওর জন্য একটি স্ট্রিম অনুরোধ করে—হয় VOD বা লাইভ সামগ্রী। SDK তারপরে একটি সম্মিলিত ভিডিও স্ট্রিম ফেরত দেয়, যাতে আপনাকে আপনার অ্যাপের মধ্যে বিজ্ঞাপন এবং বিষয়বস্তু ভিডিওর মধ্যে স্যুইচিং পরিচালনা করতে হবে না।

আপনি আগ্রহী DAI সমাধান নির্বাচন করুন

সম্পূর্ণ সেবা পড পরিবেশন

পড পরিবেশন DAI

এই নির্দেশিকাটি দেখায় কিভাবে একটি ভিডিও প্লেয়ারের সাথে tvOS-এর জন্য IMA DAI SDK ব্যবহার করে একটি DAI পড সার্ভিং লাইভ বা VOD স্ট্রিম চালাতে হয়। একটি সম্পূর্ণ নমুনা ইন্টিগ্রেশন দেখতে বা অনুসরণ করতে, পড সার্ভিং উদাহরণ অ্যাপ ডাউনলোড করুন ( Obj C বা Swift )।

দ্রষ্টব্য: Apple শুধুমাত্র HTTP লাইভ স্ট্রিমিং (HLS) সমর্থন করার জন্য ফ্রেমওয়ার্ক প্রদান করে, যেমন AVKit, AVFoundation এবং WebKit। এই ফ্রেমওয়ার্কগুলি DASH স্ট্রিম ফর্ম্যাটের সাথে কাজ করবে না৷

মূল পয়েন্ট: IMA DAI পড সার্ভিং ব্যবহার করার জন্য, আপনাকে অবশ্যই একজন পড সার্ভিং অংশীদারের সাথে কাজ করতে হবে এবং একটি অ্যাড ম্যানেজার 360 অ্যাডভান্সড অ্যাকাউন্ট থাকতে হবে। আপনার যদি অ্যাড ম্যানেজার অ্যাকাউন্ট থাকে, তাহলে আরও বিশদ বিবরণের জন্য আপনার অ্যাকাউন্ট পরিচালকের সাথে যোগাযোগ করুন। অ্যাড ম্যানেজারের জন্য সাইন আপ করার বিষয়ে তথ্যের জন্য, অ্যাড ম্যানেজার সহায়তা কেন্দ্রে যান।

দ্রষ্টব্য: অন্যান্য প্ল্যাটফর্মের সাথে একীভূতকরণ, বা IMA ক্লায়েন্ট-সাইড SDK ব্যবহার করার বিষয়ে তথ্যের জন্য, ইন্টারেক্টিভ মিডিয়া বিজ্ঞাপন SDK দেখুন৷

IMA DAI পড সার্ভিং ওভারভিউ

TVOS-এর জন্য IMA DAI SDK ব্যবহার করে পড সার্ভিং বাস্তবায়নে দুটি প্রধান উপাদান জড়িত:

• StreamRequest : একটি বস্তু যা Google এর বিজ্ঞাপন সার্ভারে একটি স্ট্রিম অনুরোধ সংজ্ঞায়িত করে। পড সার্ভিং সক্ষম করতে IMAPodStreamRequest বা IMAPodVODStreamRequest ব্যবহার করে তৈরি করতে হবে। উভয় পদ্ধতির একটি নেটওয়ার্ক কোড প্রয়োজন এবং IMAPodStreamRequest জন্য একটি কাস্টম সম্পদ কী প্রয়োজন। একটি API কী ঐচ্ছিক।

• IMAStreamManager : একটি বস্তু যা ভিডিও স্ট্রীম এবং IMA DAI SDK-এর মধ্যে যোগাযোগ পরিচালনা করে, যেমন ফায়ারিং ট্র্যাকিং পিং এবং প্রকাশকের কাছে স্ট্রিম ইভেন্ট ফরওয়ার্ড করা।

পূর্বশর্ত

আপনি শুরু করার আগে, আপনার নিম্নলিখিতগুলি প্রয়োজন:

• Xcode 13 বা তার পরে।
• CocoaPods (পছন্দের), সুইফ্ট প্যাকেজ ম্যানেজার, অথবা tvOS-এর জন্য IMA DAI SDK- এর ডাউনলোড করা কপি।
• DAI বিজ্ঞাপনের সাথে ভিডিও স্ট্রিম চালানোর জন্য IMA DAI SDK-এর সাথে একটি tvOS অ্যাপ ইতিমধ্যেই সেট আপ করা হয়েছে। যদি আপনার কাছে এমন কোনো অ্যাপ না থাকে, তাহলে আমরা tvOS DAI BasicExample টিকে শুরুর পয়েন্ট হিসেবে ব্যবহার করার পরামর্শ দিই। BasicExample এই নির্দেশিকায় উল্লেখিত কোডবেস আছে। IMA DAI SDK কীভাবে বাস্তবায়ন করবেন সে সম্পর্কে আরও তথ্যের জন্য, দ্রুত শুরু নির্দেশিকা দেখুন।

আপনার পড সার্ভিং ভেরিয়েবল সেট আপ করুন

পড সার্ভিংয়ের জন্য প্রয়োজনীয় সমস্ত পরিবর্তন সুইফটে ViewController.swift বা Objective-C-তে ViewController.m এ করা হয়। এই গাইডের স্নিপেটগুলি সুইফট ভাষা ব্যবহার করার জন্য ডিফল্ট। প্রথম ধাপ হল ধ্রুবক ভেরিয়েবল আপডেট করা।

এখানে অ্যাড পড স্ট্রিম অনুরোধের ধ্রুবক যোগ করা হয়েছে:

• STREAM_URL ( শুধুমাত্র লাইভস্ট্রিমগুলির জন্য ব্যবহৃত হয় ): আপনার ম্যানিফেস্ট ম্যানিপুলেটর বা পড সার্ভিং ব্যবহার করে তৃতীয় পক্ষের অংশীদার দ্বারা প্রদত্ত ভিডিও স্ট্রিম URL৷ আপনি একটি অনুরোধ করার আগে, আপনাকে IMA DAI SDK দ্বারা প্রদত্ত স্ট্রিম আইডি ঢোকাতে হবে। এই ক্ষেত্রে, স্ট্রীম URL-এ একটি স্থানধারক অন্তর্ভুক্ত করা হয়, "[[STREAMID]]" , যা অনুরোধ করার আগে স্ট্রিম আইডি দিয়ে প্রতিস্থাপিত হয়।
• NETWORK_CODE : আপনার Ad Manager 360 অ্যাকাউন্টের নেটওয়ার্ক কোড।
• CUSTOM_ASSET_KEY ( শুধুমাত্র লাইভস্ট্রিমের জন্য ব্যবহার করা হয় ): কাস্টম অ্যাসেট কী যা অ্যাড ম্যানেজার 360-এ আপনার পড সার্ভিং ইভেন্টকে শনাক্ত করে৷ এটি আপনার ম্যানিফেস্ট ম্যানিপুলেটর বা তৃতীয় পক্ষের পড সার্ভিং অংশীদার দ্বারা তৈরি করা যেতে পারে৷
• API_KEY ( শুধুমাত্র লাইভস্ট্রিমের জন্য ব্যবহৃত হয় ): একটি ঐচ্ছিক API কী যা IMA DAI SDK থেকে একটি স্ট্রিম আইডি পুনরুদ্ধার করতে প্রয়োজন হতে পারে।

নিম্নলিখিতগুলির সাথে মেলে উদাহরণের পরিবর্তনশীল বিভাগটি পরিবর্তন করুন:

দ্রষ্টব্য: প্রদত্ত স্ট্রিম প্যারামিটারগুলি একটি লাইভ পড স্ট্রিমের জন্য। একটি পড সার্ভিং VOD স্ট্রিম দিয়ে পরীক্ষা করতে, আপনাকে আপনার নিজস্ব টেস্ট স্ট্রিম প্যারামিটার প্রদান করতে হবে।

...
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 পড স্ট্রিম অনুরোধ তৈরি করুন

লাইভস্ট্রিম পড পরিবেশন

IMAPodStreamRequest ইনস্ট্যান্টিয়েট করে একটি লাইভ পড স্ট্রিম অনুরোধ তৈরি করতে requestStream পদ্ধতি পরিবর্তন করুন।

  ...

  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 স্ট্রিম পড পরিবেশন

IMAPodVODStreamRequest ইনস্ট্যান্টিয়েট করে একটি VOD পড স্ট্রিম অনুরোধ তৈরি করতে requestStream পদ্ধতি পরিবর্তন করুন।

  ...

  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 সম্পাদনা করুন এবং সেট করুন৷

লাইভস্ট্রিম পড পরিবেশন

স্ট্রিম আইডি পেতে streamManager.streamId ব্যবহার করে IMAAdsLoaderDelegate পদ্ধতি পরিবর্তন করুন। তারপর "[[STREAMID]]" প্রতিস্থাপন করে STREAM_URL এ স্ট্রিম আইডি ঢোকান। একবার এই পরিবর্তন করা হয়ে গেলে, নতুন স্ট্রীম URL videoDisplay.loadStream() ব্যবহার করে সেট করা যেতে পারে।

  ...

  // 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 স্ট্রিম পড পরিবেশন

স্ট্রিম আইডি পেতে streamManager.streamId ব্যবহার করে IMAAdsLoaderDelegate পদ্ধতি পরিবর্তন করুন। তারপর, আপনার ভিডিও প্রযুক্তি অংশীদার (VTP) এর কাছ থেকে একটি স্ট্রিম URL এর অনুরোধ করুন এবং IMAStreamManager.loadThirdPartyStream() কল করুন যাতে IMA স্ট্রিম URL এবং আপনার TVP দ্বারা ফিরে আসা যেকোনো সাবটাইটেল লোড করতে পারে৷

  ...

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

IMA DAI সম্পদ পরিষ্কার করুন

আপনি যখন সফলভাবে IMA DAI SDK-এর সাথে পড সার্ভিং স্ট্রীমে বিজ্ঞাপনের অনুরোধ করা এবং প্রদর্শন করা শেষ করেন, তখন আমরা আপনাকে পড সার্ভিং সেশন সম্পূর্ণ হওয়ার পরে যে কোনও সংস্থান পরিষ্কার করার পরামর্শ দিই। স্ট্রিম প্লেব্যাক বন্ধ করতে IMAStreamManager.destroy() এ কল করুন, সমস্ত বিজ্ঞাপন ট্র্যাকিং বন্ধ করুন এবং লোড করা সমস্ত স্ট্রিম সম্পদ প্রকাশ করুন৷

TVOS SDK-এর অন্যান্য উদাহরণ দেখতে, GitHub-এ নমুনাগুলি দেখুন।