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

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

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

সম্পূর্ণ পরিষেবা DAI

এই নির্দেশিকাটি দেখায় কিভাবে একটি সাধারণ ভিডিও প্লেয়ার অ্যাপে IMA DAI SDK সংহত করা যায়। আপনি যদি একটি সম্পূর্ণ নমুনা ইন্টিগ্রেশন সহ দেখতে বা অনুসরণ করতে চান, GitHub থেকে BasicExample ডাউনলোড করুন।

IMA DAI ওভারভিউ

IMA DAI বাস্তবায়নে এই নির্দেশিকায় প্রদর্শিত চারটি প্রধান SDK উপাদান জড়িত:

  • IMAAdDisplayContainer – একটি কন্টেইনার অবজেক্ট যা ভিডিও প্লেব্যাক উপাদানের উপরে বসে এবং বিজ্ঞাপন UI উপাদানগুলিকে ধারণ করে৷
  • IMAAdsLoader – একটি অবজেক্ট যা স্ট্রিমের অনুরোধ করে এবং স্ট্রিম রিকোয়েস্ট রেসপন্স অবজেক্টের দ্বারা ট্রিগার হওয়া ইভেন্টগুলি পরিচালনা করে। আপনার শুধুমাত্র একটি বিজ্ঞাপন লোডার ইনস্ট্যান্টিয়েট করা উচিত, যা অ্যাপ্লিকেশনের সারাজীবন জুড়ে পুনরায় ব্যবহার করা যেতে পারে।
  • IMAStreamRequest – হয় একটি IMAVODStreamRequest অথবা একটি IMALiveStreamRequest । একটি বস্তু যা একটি স্ট্রিম অনুরোধ সংজ্ঞায়িত করে। স্ট্রিম অনুরোধ ভিডিও-অন-ডিমান্ড বা লাইভ স্ট্রিমের জন্য হতে পারে। অনুরোধগুলি একটি বিষয়বস্তু আইডি, সেইসাথে একটি API কী বা প্রমাণীকরণ টোকেন এবং অন্যান্য পরামিতি নির্দিষ্ট করে৷
  • IMAStreamManager – একটি বস্তু যা গতিশীল বিজ্ঞাপন সন্নিবেশ স্ট্রীম এবং DAI ব্যাকএন্ডের সাথে মিথস্ক্রিয়া পরিচালনা করে। স্ট্রিম ম্যানেজার ট্র্যাকিং পিং এবং ফরোয়ার্ড স্ট্রিম এবং বিজ্ঞাপন ইভেন্টগুলি প্রকাশকের কাছে পরিচালনা করে।

পূর্বশর্ত

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

  • Xcode 13 বা তার পরে
  • CocoaPods (পছন্দের), সুইফ্ট প্যাকেজ ম্যানেজার, অথবা iOS এর জন্য IMA DAI SDK এর ডাউনলোড করা কপি

আপনার IMA SDK থেকে আপনার স্ট্রিমের অনুরোধ করার জন্য ব্যবহৃত প্যারামিটারগুলিরও প্রয়োজন৷ অনুরোধের প্যারামিটারের উদাহরণের জন্য, নমুনা স্ট্রীম দেখুন।

লাইভস্ট্রিম প্যারামিটার
সম্পদ কী Google Ad Manager-এ আপনার লাইভস্ট্রিম শনাক্তকারী সম্পদ কী।
উদাহরণ: c-rArva4ShKVIAkNfy6HUQ
VOD স্ট্রিম প্যারামিটার
বিষয়বস্তুর উৎস আইডি Google Ad Manager থেকে কন্টেন্ট সোর্স আইডি।
উদাহরণ: 2548831
ভিডিও আইডি গুগল অ্যাড ম্যানেজার থেকে ভিডিও আইডি।
উদাহরণ: tears-of-steel

একটি নতুন Xcode প্রকল্প তৈরি করুন

এক্সকোডে, অবজেক্টিভ-সি ব্যবহার করে একটি নতুন iOS প্রকল্প তৈরি করুন। প্রকল্পের নাম হিসাবে BasicExample ব্যবহার করুন।

Xcode প্রকল্পে IMA DAI SDK যোগ করুন

IMA DAI SDK ইনস্টল করতে এই তিনটি পদ্ধতির একটি ব্যবহার করুন।

CocoaPods ব্যবহার করে SDK ইনস্টল করুন (পছন্দের)

CocoaPods হল Xcode প্রকল্পগুলির জন্য একটি নির্ভরতা পরিচালক এবং IMA DAI SDK ইনস্টল করার জন্য প্রস্তাবিত পদ্ধতি৷ CocoaPods ইনস্টল বা ব্যবহার সম্পর্কে আরও তথ্যের জন্য, CocoaPods ডকুমেন্টেশন দেখুন। আপনি CocoaPods ইনস্টল করার পরে, IMA DAI SDK ইনস্টল করতে নিম্নলিখিত নির্দেশাবলী ব্যবহার করুন:

  1. আপনার BasicExample.xcodeproj ফাইলের মতো একই ডিরেক্টরিতে, Podfile নামে একটি পাঠ্য ফাইল তৈরি করুন এবং নিম্নলিখিত কনফিগারেশন যোগ করুন:

    পডফাইল 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '14'

target 'BasicExample' do
  pod 'GoogleAds-IMA-iOS-SDK', '~> 3.23.0'
end

    Podfile

  2. Podfile ধারণকারী ডিরেক্টরি থেকে, চালান:

    pod install --repo-update`

  3. BasicExample.xcworkspace ফাইল খুলে ইনস্টলেশন সফল হয়েছে কিনা তা যাচাই করুন এবং নিশ্চিত করুন যে এতে দুটি প্রকল্প রয়েছে: BasicExample এবং Pods (CocoaPods দ্বারা ইনস্টল করা নির্ভরতা)।

সুইফট প্যাকেজ ম্যানেজার ব্যবহার করে SDK ইনস্টল করুন

ইন্টারেক্টিভ মিডিয়া বিজ্ঞাপন SDK সংস্করণ 3.18.4 থেকে শুরু করে সুইফট প্যাকেজ ম্যানেজার সমর্থন করে। সুইফট প্যাকেজ আমদানি করতে নিম্নলিখিত পদক্ষেপগুলি অনুসরণ করুন৷

  1. Xcode-এ, File > Add Packages- এ নেভিগেট করে IMA DAI SDK সুইফট প্যাকেজ ইনস্টল করুন।

  2. প্রদর্শিত প্রম্পটে, IMA DAI SDK সুইফট প্যাকেজ GitHub সংগ্রহস্থল অনুসন্ধান করুন:

    https://github.com/googleads/swift-package-manager-google-interactive-media-ads-ios

  3. আপনি যে IMA DAI SDK সুইফট প্যাকেজটি ব্যবহার করতে চান তার সংস্করণ নির্বাচন করুন৷ নতুন প্রকল্পের জন্য, আমরা আপ টু নেক্সট মেজর সংস্করণ ব্যবহার করার পরামর্শ দিই।

আপনার হয়ে গেলে, Xcode আপনার প্যাকেজ নির্ভরতা সমাধান করে এবং সেগুলিকে পটভূমিতে ডাউনলোড করে। কীভাবে প্যাকেজ নির্ভরতা যুক্ত করবেন সে সম্পর্কে আরও বিশদ বিবরণের জন্য, অ্যাপলের নিবন্ধটি দেখুন।

ম্যানুয়ালি SDK ডাউনলোড এবং ইনস্টল করুন

আপনি যদি সুইফট প্যাকেজ ম্যানেজার বা CocoaPods ব্যবহার করতে না চান, তাহলে আপনি IMA DAI SDK ডাউনলোড করতে পারেন এবং ম্যানুয়ালি আপনার প্রোজেক্টে যোগ করতে পারেন।

একটি সাধারণ ভিডিও প্লেয়ার তৈরি করুন

একটি UI ভিউতে মোড়ানো একটি AV প্লেয়ার ব্যবহার করে আপনার প্রধান ভিউ কন্ট্রোলারে একটি ভিডিও প্লেয়ার প্রয়োগ করুন৷ IMA SDK বিজ্ঞাপন UI উপাদানগুলি প্রদর্শন করতে UI ভিউ ব্যবহার করে।

ViewController.m 
#import "ViewController.h"

#import <AVKit/AVKit.h>

/// Content URL.
static NSString *const kBackupContentUrl =
    @"http://devimages.apple.com/iphone/samples/bipbop/bipbopall.m3u8";

@interface ViewController ()
/// Play button.
@property(nonatomic, weak) IBOutlet UIButton *playButton;

@property(nonatomic, weak) IBOutlet UIView *videoView;
/// Video player.
@property(nonatomic, strong) AVPlayer *videoPlayer;
@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  self.view.backgroundColor = [UIColor blackColor];

  // Load AVPlayer with the path to your content.
  NSURL *contentURL = [NSURL URLWithString:kBackupContentUrl];
  self.videoPlayer = [AVPlayer playerWithURL:contentURL];

  // Create a player layer for the player.
  AVPlayerLayer *playerLayer = [AVPlayerLayer playerLayerWithPlayer:self.videoPlayer];

  // Size, position, and display the AVPlayer.
  playerLayer.frame = self.videoView.layer.bounds;
  [self.videoView.layer addSublayer:playerLayer];
}

- (IBAction)onPlayButtonTouch:(id)sender {
  [self.videoPlayer play];
  self.playButton.hidden = YES;
}

@end

ViewController.m

বিজ্ঞাপন লোডার শুরু করুন

আপনার ভিউ কন্ট্রোলারে IMA SDK আমদানি করুন এবং বিজ্ঞাপন লোডার এবং স্ট্রিম ম্যানেজার ইভেন্টগুলি পরিচালনা করতে IMAAdsLoaderDelegate এবং IMAStreamManagerDelegate প্রোটোকলগুলি গ্রহণ করুন৷

মূল IMA SDK উপাদানগুলি সংরক্ষণ করতে এই ব্যক্তিগত বৈশিষ্ট্যগুলি যোগ করুন:

  • IMAAdsLoader - আপনার অ্যাপের জীবনকাল জুড়ে স্ট্রিম অনুরোধগুলি পরিচালনা করে।
  • IMAAdDisplayContainer - বিজ্ঞাপন ব্যবহারকারী ইন্টারফেস উপাদান সন্নিবেশ এবং পরিচালনা পরিচালনা করে।
  • IMAAVPlayerVideoDisplay - IMA SDK এবং আপনার মিডিয়া প্লেয়ারের মধ্যে যোগাযোগ করে এবং সময়মতো মেটাডেটা পরিচালনা করে।
  • IMAStreamManager - স্ট্রিম প্লেব্যাক পরিচালনা করে এবং বিজ্ঞাপন-সম্পর্কিত ইভেন্টগুলি চালায়।

ভিউ লোড হওয়ার পরে বিজ্ঞাপন লোডার, বিজ্ঞাপন প্রদর্শন কন্টেইনার এবং ভিডিও প্রদর্শন শুরু করুন।

ViewController.m 
@import GoogleInteractiveMediaAds;

// ...

@interface ViewController () <IMAAdsLoaderDelegate, IMAStreamManagerDelegate>
/// The entry point for the IMA DAI SDK to make DAI stream requests.
@property(nonatomic, strong) IMAAdsLoader *adsLoader;
/// The container where the SDK renders each ad's user interface elements and companion slots.
@property(nonatomic, strong) IMAAdDisplayContainer *adDisplayContainer;
/// The reference of your video player for the IMA DAI SDK to monitor playback and handle timed
/// metadata.
@property(nonatomic, strong) IMAAVPlayerVideoDisplay *imaVideoDisplay;
/// References the stream manager from the IMA DAI SDK after successful stream loading.
@property(nonatomic, strong) IMAStreamManager *streamManager;

// ...

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  // ...

  self.adsLoader = [[IMAAdsLoader alloc] initWithSettings:nil];
  self.adsLoader.delegate = self;

  // Create an ad display container for rendering each ad's user interface elements and companion
  // slots.
  self.adDisplayContainer =
      [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                          viewController:self
                                          companionSlots:nil];

  // Create an IMAAVPlayerVideoDisplay to give the SDK access to your video player.
  self.imaVideoDisplay = [[IMAAVPlayerVideoDisplay alloc] initWithAVPlayer:self.videoPlayer];
}
ViewController.m

একটি স্ট্রিম অনুরোধ করুন

যখন একজন ব্যবহারকারী প্লে বোতাম টিপে, তখন একটি নতুন স্ট্রিম অনুরোধ করুন। লাইভ স্ট্রিমের জন্য IMALiveStreamRequest ক্লাস ব্যবহার করুন। VOD স্ট্রিমগুলির জন্য, IMAVODStreamRequest ক্লাসটি ব্যবহার করুন৷

স্ট্রিম অনুরোধের জন্য আপনার স্ট্রিম প্যারামিটারের পাশাপাশি আপনার বিজ্ঞাপন প্রদর্শন কন্টেনার এবং ভিডিও প্রদর্শনের একটি রেফারেন্স প্রয়োজন।

ViewController.m 
- (IBAction)onPlayButtonTouch:(id)sender {
  [self requestStream];
  self.playButton.hidden = YES;
}

- (void)requestStream {
  // Create a stream request. Use one of "Live stream request" or "VOD request", depending on your
  // type of stream.
  IMAStreamRequest *request;
  // Switch this variable to NO to make a VOD request.
  BOOL useLiveStream = YES;
  if (useLiveStream) {
    // Live stream request. Replace the asset key with your value.
    request = [[IMALiveStreamRequest alloc] initWithAssetKey:@"c-rArva4ShKVIAkNfy6HUQ"
                                          adDisplayContainer:self.adDisplayContainer
                                                videoDisplay:self.imaVideoDisplay
                                                 userContext:nil];
  } else {
    // VOD request. Replace the content source ID and video ID with your values.
    request = [[IMAVODStreamRequest alloc] initWithContentSourceID:@"2548831"
                                                           videoID:@"tears-of-steel"
                                                adDisplayContainer:self.adDisplayContainer
                                                      videoDisplay:self.imaVideoDisplay
                                                       userContext:nil];
  }
  [self.adsLoader requestStreamWithRequest:request];
}
ViewController.m

স্ট্রিম লোড ইভেন্ট শুনুন

IMAAdsLoader ক্লাস IMAAdsLoaderDelegate পদ্ধতিগুলিকে স্ট্রিম অনুরোধের সফল শুরু বা ব্যর্থতার জন্য কল করে।

adsLoadedWithData প্রতিনিধি পদ্ধতিতে, আপনার IMAStreamManagerDelegate সেট করুন এবং স্ট্রিম ম্যানেজার শুরু করুন। আরম্ভ হলে, স্ট্রিম ম্যানেজার প্লেব্যাক শুরু করে।

failedWithErrorData প্রতিনিধি পদ্ধতিতে, ত্রুটিটি লগ করুন। ঐচ্ছিকভাবে, ব্যাকআপ স্ট্রীম খেলুন। DAI সেরা অনুশীলন দেখুন।

ViewController.m 
- (void)adsLoader:(IMAAdsLoader *)loader adsLoadedWithData:(IMAAdsLoadedData *)adsLoadedData {
  NSLog(@"Stream created with: %@.", adsLoadedData.streamManager.streamId);
  self.streamManager = adsLoadedData.streamManager;
  self.streamManager.delegate = self;
  [self.streamManager initializeWithAdsRenderingSettings:nil];
}

- (void)adsLoader:(IMAAdsLoader *)loader failedWithErrorData:(IMAAdLoadingErrorData *)adErrorData {
  // Log the error and play the content.
  NSLog(@"AdsLoader error, code:%ld, message: %@", adErrorData.adError.code,
        adErrorData.adError.message);
  [self.videoPlayer play];
}
ViewController.m

বিজ্ঞাপন ঘটনা শুনুন

IMAStreamManager IMAStreamManagerDelegate পদ্ধতিগুলিকে স্ট্রিম ইভেন্টগুলি এবং আপনার অ্যাপ্লিকেশনে ত্রুটিগুলি পাস করার জন্য কল করে৷

এই উদাহরণের জন্য, প্রাথমিক বিজ্ঞাপন ইভেন্টগুলি কনসোলে লগ করুন:

ViewController.m 
- (void)streamManager:(IMAStreamManager *)streamManager didReceiveAdEvent:(IMAAdEvent *)event {
  NSLog(@"Ad event (%@).", event.typeString);
  switch (event.type) {
    case kIMAAdEvent_STARTED: {
      // Log extended data.
      NSString *extendedAdPodInfo = [[NSString alloc]
          initWithFormat:@"Showing ad %ld/%ld, bumper: %@, title: %@, description: %@, contentType:"
                         @"%@, pod index: %ld, time offset: %lf, max duration: %lf.",
                         (long)event.ad.adPodInfo.adPosition, (long)event.ad.adPodInfo.totalAds,
                         event.ad.adPodInfo.isBumper ? @"YES" : @"NO", event.ad.adTitle,
                         event.ad.adDescription, event.ad.contentType,
                         (long)event.ad.adPodInfo.podIndex, event.ad.adPodInfo.timeOffset,
                         event.ad.adPodInfo.maxDuration];

      NSLog(@"%@", extendedAdPodInfo);
      break;
    }
    case kIMAAdEvent_AD_BREAK_STARTED: {
      NSLog(@"Ad break started");
      break;
    }
    case kIMAAdEvent_AD_BREAK_ENDED: {
      NSLog(@"Ad break ended");
      break;
    }
    case kIMAAdEvent_AD_PERIOD_STARTED: {
      NSLog(@"Ad period started");
      break;
    }
    case kIMAAdEvent_AD_PERIOD_ENDED: {
      NSLog(@"Ad period ended");
      break;
    }
    default:
      break;
  }
}

- (void)streamManager:(IMAStreamManager *)streamManager didReceiveAdError:(IMAAdError *)error {
  NSLog(@"StreamManager error with type: %ld\ncode: %ld\nmessage: %@", error.type, error.code,
        error.message);
  [self.videoPlayer play];
}
ViewController.m

আপনার অ্যাপটি চালান, এবং সফল হলে, আপনি IMA SDK-এর সাথে Google DAI স্ট্রীমগুলির জন্য অনুরোধ করতে এবং চালাতে পারেন৷ আরও উন্নত SDK বৈশিষ্ট্যগুলি সম্পর্কে জানতে, বাম দিকের সাইডবারে তালিকাভুক্ত অন্যান্য গাইড বা GitHub-এ নমুনাগুলি দেখুন।