शुरू करें

IMA SDK आपकी वेबसाइटों और ऐप्लिकेशन में मल्टीमीडिया विज्ञापनों को इंटिग्रेट करना आसान बनाते हैं. IMA SDK ये काम कर सकते हैं किसी भी वेबसाइट या ऐप्लिकेशन से विज्ञापनों का अनुरोध करें वीएएसटी का पालन करने वाला विज्ञापन सर्वर और अपने ऐप्लिकेशन में विज्ञापन चलाने की सुविधा को मैनेज करना. IMA क्लाइंट-साइड SDK टूल की मदद से, कॉन्टेंट वाले वीडियो के प्लेबैक पर आपका कंट्रोल रहता है, जबकि SDK टूल विज्ञापन के प्लेबैक को मैनेज करता है. विज्ञापन इसमें चलते हैं ऐप्लिकेशन के कॉन्टेंट वीडियो प्लेयर के ऊपर अलग से एक वीडियो प्लेयर रखा होगा.

इस गाइड में IMA SDK को आसान वीडियो प्लेयर में जोड़ने का तरीका बताया गया है है. अगर आपको पूरा सैंपल देखना या उसके साथ फ़ॉलो करना है इंटिग्रेशन, डाउनलोड करें BasicExample, यहां से GitHub.

ध्यान दें: अन्य प्लैटफ़ॉर्म के साथ इंटिग्रेट करने या IMA डीएआई SDK टूल की सूची देखने के लिए, इंटरैक्टिव मीडिया विज्ञापन SDK टूल.

IMA क्लाइंट-साइड की खास जानकारी

IMA क्लाइंट-साइड को लागू करने के लिए, SDK टूल के चार मुख्य कॉम्पोनेंट शामिल किए गए हैं: इस गाइड में बताए गए हैं:

• IMAAdDisplayContainer: एक कंटेनर ऑब्जेक्ट, जहां विज्ञापन दिखाए जाते हैं.
• IMAAdsLoader: एक ऑब्जेक्ट जो विज्ञापनों का अनुरोध करता है और विज्ञापनों के अनुरोध के जवाबों के इवेंट मैनेज करता है. आपको सिर्फ़ एक विज्ञापन लोडर इंस्टैंशिएट करना चाहिए, जिसे ऐप्लिकेशन की पूरी अवधि के दौरान फिर से इस्तेमाल किया जा सकता है.
• IMAAdsRequest: विज्ञापन के अनुरोध के बारे में बताने वाला ऑब्जेक्ट. विज्ञापन अनुरोध, वीएएसटी विज्ञापन टैग के यूआरएल के साथ-साथ उस यूआरएल के बारे में भी बताते हैं अतिरिक्त पैरामीटर, जैसे विज्ञापन डाइमेंशन.
• IMAAdsManager: एक ऐसा ऑब्जेक्ट जो विज्ञापन के अनुरोध का जवाब देता है, विज्ञापन प्लेबैक को कंट्रोल करता है, और विज्ञापन को सुनता है SDK टूल से ट्रिगर होने वाले इवेंट.

ज़रूरी शर्तें

शुरू करने से पहले, आपको इनकी ज़रूरत होगी:

• Xcode 13 या उसके बाद का वर्शन
• CocoaPods (पसंदीदा), Swift पैकेज मैनेजर या उसकी कॉपी iOS के लिए IMA SDK

1. नया Xcode प्रोजेक्ट बनाएं

Xcode में, Objective-C या Swift का इस्तेमाल करके नया iOS प्रोजेक्ट बनाएं. इस्तेमाल की जाने वाली चीज़ें प्रोजेक्ट के नाम के रूप में BasicExample.

2. Xcode प्रोजेक्ट में IMA SDK जोड़ें

CocoaPods का इस्तेमाल करके SDK टूल इंस्टॉल करें (सुझाया गया)

CocoaPods, Xcode प्रोजेक्ट के लिए डिपेंडेंसी मैनेजर है. इसके इस्तेमाल का सुझाव दिया जाता है IMA SDK इंस्टॉल करने का तरीका जानें. इंस्टॉल करने या इसका इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए CocoaPods, CocoaPods का दस्तावेज़ देखें. एक बार अगर आपने CocoaPods को इंस्टॉल किया है, तो IMA 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
   

2. Podfile वाली डायरेक्ट्री से, pod install --repo-update चलाएं

3. इसे खोलकर पुष्टि करें कि इंस्टॉलेशन पूरा हो गया है BasicExample.xcworkspace फ़ाइल है और इसमें दो प्रोजेक्ट शामिल हैं, इसकी पुष्टि करता है: BasicExample और Pods (CocoaPods की ओर से इंस्टॉल की गई डिपेंडेंसी).

Swift पैकेज मैनेजर का इस्तेमाल करके SDK टूल इंस्टॉल करें

इंटरैक्टिव मीडिया विज्ञापन SDK टूल, Swift पैकेज के साथ काम करता है मैनेजर का वर्शन 3.18.4 से शुरू होगा. फ़ॉलो करें Swift पैकेज इंपोर्ट करने के लिए, नीचे दिया गया तरीका अपनाएं.

ध्यान दें: CocoaPods पर आधारित प्रोजेक्ट से माइग्रेट करते समय, pod deintegrate को अपने Xcode प्रोजेक्ट से CocoaPods को हटाएं. CocoaPods का जनरेट किया गया .xcworkspace बाद में फ़ाइल सुरक्षित ढंग से हटाई जा सकती है. अगर आपको इंटरैक्टिव मीडिया विज्ञापन जोड़ने हैं, तो किसी प्रोजेक्ट के लिए पहली बार SDK टूल इस्तेमाल करने का विकल्प चुनने पर, इस चरण को अनदेखा किया जा सकता है.

1. Xcode में, IMA SDK स्विफ़्ट पैकेज को इंस्टॉल करें. इसके लिए, फ़ाइल > पैकेज जोड़ें....

2. स्क्रीन पर दिखने वाले प्रॉम्प्ट में, IMA SDK Swift पैकेज GitHub खोजें डेटा स्टोर करने की जगह:

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

3. IMA SDK Swift पैकेज का वह वर्शन चुनें जिसका आपको इस्तेमाल करना है. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप अगला मेजर वर्शन इस्तेमाल करें.

आपका काम पूरा होने के बाद, Xcode आपकी पैकेज डिपेंडेंसी का समाधान करता है और इसे बैकग्राउंड में डाउनलोड करता है. पैकेज जोड़ने के तरीके के बारे में ज़्यादा जानने के लिए डिपेंडेंसी, देखें Apple का लेख.

SDK टूल को मैन्युअल तरीके से डाउनलोड और इंस्टॉल करें

अगर आपको Swift पैकेज मैनेजर या CocoaPods का इस्तेमाल नहीं करना है, तो IMA SDK डाउनलोड करें और इसे मैन्युअल तरीके से अपने प्रोजेक्ट में जोड़ें.

निर्देश दिखाएं/छिपाएं

1. iOS IMA डाउनलोड पेज, iOS IMA SDK.
2. BasicExample.xcodeproj खोलें.
3. बाएं पैनल में, प्रोजेक्ट के नाम पर क्लिक करें.
   
4. बीच वाले पैनल में, फ़ेज़ बनाएं पर क्लिक करें.
   
5. बाइनरी को लाइब्रेरी से लिंक करें सेक्शन को बड़ा करें.
6. लाइब्रेरी की सूची में सबसे नीचे, प्लस आइकॉन पर क्लिक करें [+].
7. अन्य जोड़ें पर क्लिक करें.
8. जिस डायरेक्ट्री में आपने डाउनलोड किया गया SDK टूल एक्सट्रैक्ट किया था उसमें जाकर, GoogleInteractiveMediaAds.framework में सेव करना और क्लिक करना खोलें.
9. लाइब्रेरी की सूची में सबसे नीचे, प्लस आइकॉन पर क्लिक करें [+] फिर से इंस्टॉल करें.
10. स्थिति कॉलम में, पुष्टि करें कि GoogleInteractiveMediaAds.framework इस पर सेट है Required.
11. बिल्ड सेटिंग में -ObjC लिंकर फ़्लैग शामिल करें. इसके लिए ज़्यादा जानकारी के लिए, देखें Apple QA1490.

3. वीडियो प्लेयर बनाना

सबसे पहले, बेसिक वीडियो प्लेयर लागू करें. शुरुआत में, यह प्लेयर IMA SDK. फ़िलहाल, इसमें प्लेबैक को ट्रिगर करने का कोई तरीका मौजूद नहीं है.

ViewController.m

Objective-C

#import "ViewController.h"

#import <AVKit/AVKit.h>

NSString *const kContentURLString =
    @"https://storage.googleapis.com/interactive-media-ads/media/stock.mp4";

@interface ViewController ()
@property(nonatomic) AVPlayerViewController *contentPlayerViewController;
@end

@implementation ViewController

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

- (void)setupContentPlayer {
  // Create a content video player.
  NSURL *contentURL = [NSURL URLWithString:kContentURLString];
  AVPlayer *player = [AVPlayer playerWithURL:contentURL];
  self.contentPlayerViewController = [[AVPlayerViewController alloc] init];
  self.contentPlayerViewController.player = player;
  self.contentPlayerViewController.view.frame = self.view.bounds;

  // Attach content video player to view hierarchy.
  [self showContentPlayer];
}

// Add the content video player as a child view controller.
- (void)showContentPlayer {
  [self addChildViewController:self.contentPlayerViewController];
  self.contentPlayerViewController.view.frame = self.view.bounds;
  [self.view insertSubview:self.contentPlayerViewController.view atIndex:0];
  [self.contentPlayerViewController didMoveToParentViewController:self];
}

// Remove and detach the content video player.
- (void)hideContentPlayer {
  // The whole controller needs to be detached so that it doesn't capture events from the remote.
  [self.contentPlayerViewController willMoveToParentViewController:nil];
  [self.contentPlayerViewController.view removeFromSuperview];
  [self.contentPlayerViewController removeFromParentViewController];
}

@end
      

Swift

import AVFoundation
import UIKit

class ViewController: UIViewController {
  static let ContentURLString = "https://storage.googleapis.com/interactive-media-ads/media/stock.mp4"

  var playerViewController: AVPlayerViewController!

  override func viewDidLoad() {
    super.viewDidLoad()
    self.view.backgroundColor = UIColor.black
    setUpContentPlayer()
  }

  func setUpContentPlayer() {
    // Load AVPlayer with path to your content.
    let contentURL = URL(string: ViewController.ContentURLString)
    let player = AVPlayer(url: contentURL)
    playerViewController = AVPlayerViewController()
    playerViewController.player = player

    showContentPlayer()
  }

  func showContentPlayer() {
    self.addChild(playerViewController)
    playerViewController.view.frame = self.view.bounds
    self.view.insertSubview(playerViewController.view, at: 0)
    playerViewController.didMove(toParent:self)
  }

  func hideContentPlayer() {
    // The whole controller needs to be detached so that it doesn't capture
    // events from the remote.
    playerViewController.willMove(toParent:nil)
    playerViewController.view.removeFromSuperview()
    playerViewController.removeFromParent()
  }
}
      

4. IMA SDK इंपोर्ट करें

इसके बाद, मौजूदा आयात.

ViewController.m

Objective-C

#import "ViewController.h"

#import <AVKit/AVKit.h>
#import <GoogleInteractiveMediaAds/GoogleInteractiveMediaAds.h>
NSString *const kContentURLString =
    @"https://storage.googleapis.com/interactive-media-ads/media/stock.mp4";
      

Swift

import AVFoundation
import GoogleInteractiveMediaAds
import UIKit

class ViewController: UIViewController {
  static let ContentURLString = "https://storage.googleapis.com/interactive-media-ads/media/stock.mp4"
      

5. कॉन्टेंट प्लेहेड ट्रैकर और स्ट्रीम के आखिर में ऑब्ज़र्वर को लागू करना

वीडियो के बीच में दिखने वाले विज्ञापन चलाने के लिए, IMA SDK को मौजूदा स्थिति ट्रैक करनी होगी कॉन्टेंट का इस्तेमाल किया जा सकता है. ऐसा करने के लिए, एक ऐसी क्लास बनाएं जो IMAContentPlayhead. अगर AVPlayer का इस्तेमाल किया जा रहा है, जैसा कि इस उदाहरण में दिखाया गया है, SDK टूल, IMAAVPlayerContentPlayhead क्लास उपलब्ध कराता है. इसकी मदद से, आपके लिए ये काम किए जाते हैं. अगर आप AVPlayer का इस्तेमाल नहीं कर रहे हैं, तो आपको IMAContentPlayhead को इन पर लागू करना होगा: कक्षा मैनेज करें.

आपका कॉन्टेंट चलाने के बाद, आपको SDK टूल को इसकी जानकारी भी देनी होगी, ताकि यह वीडियो खत्म होने के बाद दिखने वाले विज्ञापन दिखाना. ऐसा करने के लिए, इस पर contentComplete को कॉल किया जाएगा: AVPlayerItemDidPlayToEndTimeNotification का इस्तेमाल करके, IMAAdsLoader.

ViewController.m

Objective-C

...

@interface ViewController ()
@property(nonatomic) IMAAVPlayerContentPlayhead *contentPlayhead;
@property(nonatomic) AVPlayerViewController *contentPlayerViewController;
@end

...

- (void)setupContentPlayer {
  // Create a content video player.
  NSURL *contentURL = [NSURL URLWithString:kContentURLString];
  AVPlayer *player = [AVPlayer playerWithURL:contentURL];
  self.contentPlayerViewController = [[AVPlayerViewController alloc] init];
  self.contentPlayerViewController.player = player;
  self.contentPlayerViewController.view.frame = self.view.bounds;
  self.contentPlayhead =
      [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentPlayerViewController.player];

  // Track end of content.
  AVPlayerItem *contentPlayerItem = self.contentPlayerViewController.player.currentItem;
  [NSNotificationCenter.defaultCenter addObserver:self
                                         selector:@selector(contentDidFinishPlaying:)
                                             name:AVPlayerItemDidPlayToEndTimeNotification
                                           object:contentPlayerItem];

  // Attach content video player to view hierarchy.
  [self showContentPlayer];
}

...

- (void)contentDidFinishPlaying:(NSNotification *)notification {}

- (void)dealloc {
  [NSNotificationCenter.defaultCenter removeObserver:self];
}

@end
      

Swift

...

class ViewController: UIViewController {
  static let ContentURLString = "https://storage.googleapis.com/interactive-media-ads/media/stock.mp4"

  var contentPlayhead: IMAAVPlayerContentPlayhead?
  var playerViewController: AVPlayerViewController!

  deinit {
    NotificationCenter.default.removeObserver(self)
  }

...

  func setUpContentPlayer() {
    // Load AVPlayer with path to your content.
    let contentURL! = URL(string: ViewController.ContentURLString)
    let player = AVPlayer(url: contentURL)
    playerViewController = AVPlayerViewController()
    playerViewController.player = player

    // Set up your content playhead and contentComplete callback.
    contentPlayhead = IMAAVPlayerContentPlayhead(avPlayer: player)
    NotificationCenter.default.addObserver(
      self,
      selector: #selector(ViewController.contentDidFinishPlaying(_:)),
      name: NSNotification.Name.AVPlayerItemDidPlayToEndTime,
      object: player.currentItem)

    showContentPlayer()
  }

...

  @objc func contentDidFinishPlaying(_ notification: Notification) {
    adsLoader.contentComplete()
  }
}
      

6. विज्ञापन लोड करने वाले टूल को शुरू करने की प्रोसेस शुरू करें और विज्ञापन का अनुरोध करें

विज्ञापनों के किसी सेट का अनुरोध करने के लिए, आपको एक IMAAdsLoader इंस्टेंस बनाना होगा. इस लोडर का इस्तेमाल, किसीIMAAdsRequest का इस्तेमाल किया है.

सबसे सही तरीका यह है कि पूरे डेटा के लिए, IMAAdsLoader का सिर्फ़ एक इंस्टेंस बनाए रखें आपके ऐप्लिकेशन की लाइफ़साइकल. अन्य विज्ञापन अनुरोध करने के लिए, कोई नया विज्ञापन अनुरोध बनाएं IMAAdsRequest ऑब्जेक्ट इस्तेमाल करें, लेकिन उसी IMAAdsLoader का फिर से इस्तेमाल करें. ज़्यादा के लिए ज़्यादा जानकारी के लिए, IMA SDK के बारे में अक्सर पूछे जाने वाले सवाल देखें.

ViewController.m

Objective-C

...

NSString *const kContentURLString =
    @"https://storage.googleapis.com/interactive-media-ads/media/stock.mp4";
NSString *const kAdTagURLString = @"https://pubads.g.doubleclick.net/gampad/ads?"
    @"iu=/21775744923/external/vmap_ad_samples&sz=640x480&"
    @"cust_params=sample_ar%3Dpremidpostlongpod&"
    @"ciu_szs=300x250&gdfp_req=1&ad_rule=1&output=vmap&unviewed_position_start=1&"
    @"env=vp&impl=s&cmsid=496&vid=short_onecue&correlator=";

@interface ViewController ()
@property(nonatomic) IMAAdsLoader *adsLoader;
@property(nonatomic) IMAAVPlayerContentPlayhead *contentPlayhead;
@property(nonatomic) AVPlayerViewController *contentPlayerViewController;
@end

@implementation ViewController

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

- (void)viewDidAppear:(BOOL)animated {
  [super viewDidAppear:animated];
  [self requestAds];
}

- (void)setupAdsLoader {
  self.adsLoader = [[IMAAdsLoader alloc] init];
}

- (void)requestAds {
  // Pass the main view as the container for ad display.
  IMAAdDisplayContainer *adDisplayContainer =
      [[IMAAdDisplayContainer alloc] initWithAdContainer:self.view];
  IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:kAdTagURLString
                                                adDisplayContainer:adDisplayContainer
                                                   contentPlayhead:self.contentPlayhead
                                                       userContext:nil];
  [self.adsLoader requestAdsWithRequest:request];
}

...

- (void)contentDidFinishPlaying:(NSNotification *)notification {
  // Notify the SDK that the postrolls should be played.
  [self.adsLoader contentComplete];
}

...

@end
      

Swift

...

class ViewController: UIViewController {
  static let ContentURLString = "https://storage.googleapis.com/interactive-media-ads/media/stock.mp4"
  static let AdTagURLString = "https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator="

  var adsLoader: IMAAdsLoader!
  var contentPlayhead: IMAAVPlayerContentPlayhead?
  var playerViewController: AVPlayerViewController!

...

  override func viewDidLoad() {
    super.viewDidLoad()
    self.view.backgroundColor = UIColor.black
    setUpContentPlayer()
    setUpAdsLoader()
  }

  override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    requestAds()
  }

...

  func setUpAdsLoader() {
    adsLoader = IMAAdsLoader(settings: nil)
  }

  func requestAds() {
    // Create ad display container for ad rendering.
    let adDisplayContainer = IMAAdDisplayContainer(adContainer: self.view)
    // Create an ad request with our ad tag, display container, and optional user context.
    let request = IMAAdsRequest(
        adTagUrl: ViewController.AdTagURLString,
        adDisplayContainer: adDisplayContainer,
        contentPlayhead: contentPlayhead,
        userContext: nil)

    adsLoader.requestAds(with: request)
  }

  @objc func contentDidFinishPlaying(_ notification: Notification) {
    adsLoader.contentComplete()
  }
}
      

7. विज्ञापन लोड करने का ऐक्सेस सेट अप करना

लोड होने वाले इवेंट के होने पर, IMAAdsLoader, adsLoadedWithData को कॉल करता है असाइन करने का तरीका बताया है, जो इसे IMAAdsManager के इंस्टेंस पास करता है. आपने लोगों तक पहुंचाया मुफ़्त में इसके बाद, विज्ञापन मैनेजर को शुरू किया जा सकता है. इससे, के रिस्पॉन्स से मिलता है.

इसके अलावा, लोड करते समय होने वाली किसी भी गड़बड़ी को ठीक करें प्रोसेस. अगर विज्ञापन लोड नहीं होते हैं, तो पक्का करें कि बिना विज्ञापन के मीडिया चलता रहे ताकि उपयोगकर्ता के अनुभव में कोई रुकावट न आए.

ViewController.m

Objective-C

...

@interface ViewController () <IMAAdsLoaderDelegate>
@property(nonatomic) IMAAdsLoader *adsLoader;
@property(nonatomic) IMAAdsManager *adsManager;
@property(nonatomic) IMAAVPlayerContentPlayhead *contentPlayhead;
@property(nonatomic) AVPlayerViewController *contentPlayerViewController;
@end

@implementation ViewController

...

- (void)setupAdsLoader {
  self.adsLoader = [[IMAAdsLoader alloc] init];
  self.adsLoader.delegate = self;
}

...

#pragma mark - IMAAdsLoaderDelegate

- (void)adsLoader:(IMAAdsLoader *)loader adsLoadedWithData:(IMAAdsLoadedData *)adsLoadedData {
  // Initialize and listen to the ads manager loaded for this request.
  self.adsManager = adsLoadedData.adsManager;
  [self.adsManager initializeWithAdsRenderingSettings:nil];
}

- (void)adsLoader:(IMAAdsLoader *)loader failedWithErrorData:(IMAAdLoadingErrorData *)adErrorData {
  // Fall back to playing content.
  NSLog(@"Error loading ads: %@", adErrorData.adError.message);
  [self.contentPlayerViewController.player play];
}

@end
      

Swift

...

class ViewController: UIViewController, IMAAdsLoaderDelegate {

...

  var adsLoader: IMAAdsLoader!
  var adsManager: IMAAdsManager!
  var contentPlayhead: IMAAVPlayerContentPlayhead?
  var playerViewController: AVPlayerViewController!

...

  func setUpAdsLoader() {
    adsLoader = IMAAdsLoader(settings: nil)
    adsLoader.delegate = self
  }

...

  // MARK: - IMAAdsLoaderDelegate

  func adsLoader(_ loader: IMAAdsLoader!, adsLoadedWith adsLoadedData: IMAAdsLoadedData!) {
    adsManager = adsLoadedData.adsManager
    adsManager.initialize(with: nil)
  }

  func adsLoader(_ loader: IMAAdsLoader!, failedWith adErrorData: IMAAdLoadingErrorData!) {
    print("Error loading ads: " + adErrorData.adError.message)
    showContentPlayer()
    playerViewController.player?.play()
  }
}
      

8. Google Ads मैनेजर खाते का ऐक्सेस सेट अप करना

आखिर में, इवेंट और राज्य के बदलावों को मैनेज करने के लिए, Google Ads मैनेजर को निजी हो. IMAAdManagerDelegate में विज्ञापन इवेंट और गड़बड़ियों को मैनेज करने के तरीके होते हैं, साथ ही, आपके वीडियो कॉन्टेंट को चलाने और रोकने की सुविधा भी उपलब्ध होगी.

वीडियो चलाना शुरू हो रहा है

didReceiveAdEvent तरीके का इस्तेमाल करके कई इवेंट को मैनेज किया जा सकता है, लेकिन इस सामान्य उदाहरण के लिए, विज्ञापनों के बारे में बताने के लिए LOADED इवेंट को सुनें मैनेजर का इस्तेमाल करें.

ViewController.m

Objective-C

@interface ViewController () <IMAAdsLoaderDelegate, IMAAdsManagerDelegate>

...

- (void)adsLoader:(IMAAdsLoader *)loader adsLoadedWithData:(IMAAdsLoadedData *)adsLoadedData {
  // Initialize and listen to the ads manager loaded for this request.
  self.adsManager = adsLoadedData.adsManager;
  self.adsManager.delegate = self;
  [self.adsManager initializeWithAdsRenderingSettings:nil];
}

...

#pragma mark - IMAAdsManagerDelegate

- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {
  // Play each ad once it has loaded.
  if (event.type == kIMAAdEvent_LOADED) {
    [adsManager start];
  }
}

...
      

Swift

...

class ViewController: UIViewController, IMAAdsLoaderDelegate, IMAAdsManagerDelegate {

...

  func adsLoader(_ loader: IMAAdsLoader!, adsLoadedWith adsLoadedData: IMAAdsLoadedData!) {
    // Grab the instance of the IMAAdsManager and set yourself as the delegate.
    adsManager = adsLoadedData.adsManager
    adsManager.delegate = self
    adsManager.initialize(with: nil)
  }

...

  // MARK: - IMAAdsManagerDelegate

  func adsManager(_ adsManager: IMAAdsManager!, didReceive event: IMAAdEvent!) {
    // Play each ad once it has been loaded
    if event.type == IMAAdEventType.LOADED {
      adsManager.start()
    }
  }

...
      

गड़बड़ियों को ठीक करना

विज्ञापन से जुड़ी गड़बड़ियों के लिए हैंडलर भी जोड़ें. अगर कोई गड़बड़ी होती है, जैसा कि पिछले पेज में किया गया था चरण, कॉन्टेंट प्लेबैक फिर से शुरू करें.

ViewController.m

Objective-C

...

- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdError:(IMAAdError *)error {
  // Fall back to playing content.
  NSLog(@"AdsManager error: %@", error.message);
  [self showContentPlayer];
  [self.contentPlayerViewController.player play];
}
@end
      

Swift

...

  func adsManager(_ adsManager: IMAAdsManager!, didReceive error: IMAAdError!) {
    // Fall back to playing content
    print("AdsManager error: " + error.message)
    showContentPlayer()
    playerViewController.player?.play()
  }
      

इवेंट चलाने और रोकने की सुविधा ट्रिगर करना

आपके लिए लागू किए जाने वाले आखिरी दो डेलिगेट के तरीकों का इस्तेमाल, प्ले और IMA SDK के अनुरोध पर, वीडियो कॉन्टेंट में मौजूद इवेंट को रोक सकता है. अनुरोध किए जाने पर रोकने और चलाने की सुविधा को ट्रिगर करने से, उपयोगकर्ता किसी हिस्से को नहीं देख पाएगा को ध्यान में रखता है.

ViewController.m

Objective-C

...

- (void)adsManagerDidRequestContentPause:(IMAAdsManager *)adsManager {
  // Pause the content for the SDK to play ads.
  [self.contentPlayerViewController.player pause];
  [self hideContentPlayer];
}

- (void)adsManagerDidRequestContentResume:(IMAAdsManager *)adsManager {
  // Resume the content since the SDK is done playing ads (at least for now).
  [self showContentPlayer];
  [self.contentPlayerViewController.player play];
}

@end
      

Swift

...

  func adsManagerDidRequestContentPause(_ adsManager: IMAAdsManager!) {
    // Pause the content for the SDK to play ads.
    playerViewController.player?.pause()
    hideContentPlayer()
  }

  func adsManagerDidRequestContentResume(_ adsManager: IMAAdsManager!) {
    // Resume the content since the SDK is done playing ads (at least for now).
    showContentPlayer()
    playerViewController.player?.play()
  }
}
      

हो गया! अब आप IMA SDK से विज्ञापन दिखाने का अनुरोध कर रहे हैं और उन्हें दिखा रहे हैं. सीखने में SDK टूल की अन्य सुविधाओं के बारे में जानने के लिए, अन्य गाइड देखें या GitHub पर सैंपल.

अगले चरण

iOS प्लैटफ़ॉर्म पर विज्ञापन से होने वाली आय को बढ़ाने के लिए, IDFA का इस्तेमाल करने के लिए ऐप्लिकेशन पारदर्शिता और ट्रैकिंग की अनुमति का अनुरोध करें.