बैनर विज्ञापन

बैनर विज्ञापन, आयताकार विज्ञापन होते हैं. ये ऐप्लिकेशन के लेआउट का कुछ हिस्सा घेरते हैं. जब उपयोगकर्ता आपके ऐप्लिकेशन के साथ इंटरैक्ट करते हैं, तब स्क्रीन पर सबसे ऊपर या सबसे नीचे बैनर विज्ञापन दिखते रहते हैं. इसी तरह स्क्रीन पर स्क्रोल करने के दौरान भी ये विज्ञापन इनलाइन होकर दिखते रहते हैं. बैनर विज्ञापन एक तय समय के बाद अपने-आप रीफ़्रेश हो सकते हैं. ज़्यादा जानकारी के लिए, बैनर विज्ञापनों की खास जानकारी देखें.

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

ऐंकर किया गया अडैप्टिव बैनर

ऐंकर किए गए अडैप्टिव बैनर वाले विज्ञापन, तय आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) वाले विज्ञापन होते हैं, न कि सामान्य तय साइज़ वाले विज्ञापनों. आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) 320*50 इंडस्ट्री स्टैंडर्ड के जैसा होता है. उपलब्ध पूरी चौड़ाई तय करने के बाद, आपको उस चौड़ाई के लिए सही ऊंचाई वाला विज्ञापन दिखेगा. एक ही डिवाइस से किए गए अनुरोधों पर सही ऊंचाई में बदलाव नहीं होता और विज्ञापन रीफ़्रेश होने पर आस-पास के व्यू को इधर-उधर जाने की ज़रूरत नहीं होती.

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

हमेशा टेस्ट विज्ञापनों से टेस्ट करें

अपने ऐप्लिकेशन बनाते और उनकी जांच करते समय पक्का करें कि आप लाइव, प्रोडक्शन विज्ञापनों के बजाय टेस्ट विज्ञापनों का इस्तेमाल करें. ऐसा न करने पर, आपका खाता निलंबित किया जा सकता है.

टेस्ट विज्ञापन लोड करने का सबसे आसान तरीका, iOS बैनर के लिए बनाए गए टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करना है: ca-app-pub-3940256099942544/2435281174

इसे खास तौर पर कॉन्फ़िगर किया गया है, ताकि हर अनुरोध के लिए टेस्ट विज्ञापन दिखाए जा सकें. साथ ही, कोडिंग, टेस्टिंग, और डीबग करने के दौरान, इसे अपने ऐप्लिकेशन में इस्तेमाल किया जा सकता है. अपना ऐप्लिकेशन पब्लिश करने से पहले, यह पक्का कर लें कि आपने उसकी जगह अपना विज्ञापन यूनिट आईडी डाल दिया हो.

मोबाइल विज्ञापन SDK के टेस्ट विज्ञापन कैसे काम करते हैं, इस बारे में ज़्यादा जानकारी के लिए टेस्ट विज्ञापन देखें.

GADBannerView बनाएं

बैनर विज्ञापन, GADBannerView ऑब्जेक्ट में दिखते हैं. इसलिए, बैनर विज्ञापनों को इंटिग्रेट करने के लिए सबसे पहले, व्यू हैरारकी (व्यू और व्यू ग्रुप के लेआउट का क्रम) में GADBannerView शामिल करें. आम तौर पर, यह प्रोसेस प्रोग्रामैटिक तरीके से या इंटरफ़ेस बिल्डर की मदद से की जाती है.

प्रोग्रैम्ड तरीके से

GADBannerView को सीधे इंस्टैंशिएट भी किया जा सकता है. स्क्रीन के सेफ़ एरिया के सबसे नीचे बीच में अलाइन करके, GADBannerView बनाने का तरीका यहां दिया गया है:

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  var bannerView: GADBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()
    
    let viewWidth = view.frame.inset(by: view.safeAreaInsets).width

    // Here the current interface orientation is used. Use
    // GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth or
    // GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth if you prefer to load an ad of a
    // particular orientation,
    let adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
    bannerView = GADBannerView(adSize: adaptiveSize)

    addBannerViewToView(bannerView)
  }

  func addBannerViewToView(_ bannerView: GADBannerView) {
    bannerView.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(bannerView)
    view.addConstraints(
      [NSLayoutConstraint(item: bannerView,
                          attribute: .bottom,
                          relatedBy: .equal,
                          toItem: view.safeAreaLayoutGuide,
                          attribute: .bottom,
                          multiplier: 1,
                          constant: 0),
       NSLayoutConstraint(item: bannerView,
                          attribute: .centerX,
                          relatedBy: .equal,
                          toItem: view,
                          attribute: .centerX,
                          multiplier: 1,
                          constant: 0)
      ])
   }
   
}

Objective-C

@import GoogleMobileAds;

@interface ViewController ()

@property(nonatomic, strong) GADBannerView *bannerView;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  
  // Here safe area is taken into account, hence the view frame is used after the
  // view has been laid out.
  CGRect frame = UIEdgeInsetsInsetRect(self.view.frame, self.view.safeAreaInsets);
  CGFloat viewWidth = frame.size.width;

  // Here the current interface orientation is used. If the ad is being preloaded
  // for a future orientation change or different orientation, the function for the
  // relevant orientation should be used.
  GADAdSize adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
  // In this case, we instantiate the banner with desired ad size.
  self.bannerView = [[GADBannerView alloc] initWithAdSize:adaptiveSize];

  [self addBannerViewToView:self.bannerView];
}

- (void)addBannerViewToView:(UIView *)bannerView {
  bannerView.translatesAutoresizingMaskIntoConstraints = NO;
  [self.view addSubview:bannerView];
  [self.view addConstraints:@[
    [NSLayoutConstraint constraintWithItem:bannerView
                               attribute:NSLayoutAttributeBottom
                               relatedBy:NSLayoutRelationEqual
                                  toItem:self.view.safeAreaLayoutGuide
                               attribute:NSLayoutAttributeBottom
                              multiplier:1
                                constant:0],
    [NSLayoutConstraint constraintWithItem:bannerView
                               attribute:NSLayoutAttributeCenterX
                               relatedBy:NSLayoutRelationEqual
                                  toItem:self.view
                               attribute:NSLayoutAttributeCenterX
                              multiplier:1
                                constant:0]
                                ]];
}
  
@end

ध्यान दें कि इस मामले में हम चौड़ाई या ऊंचाई से जुड़ी पाबंदी नहीं देते, क्योंकि विज्ञापन का दिया गया साइज़, बैनर को कॉन्टेंट का असल साइज़ देगा, ताकि उसका साइज़ बन सके.

इंटरफ़ेस बिल्डर

GADBannerView को किसी स्टोरीबोर्ड या xib फ़ाइल में जोड़ा जा सकता है. इस तरीके का इस्तेमाल करते समय, पक्का करें कि बैनर पर सिर्फ़ पोज़िशन कंस्ट्रेंट जोड़ें. उदाहरण के लिए, स्क्रीन के निचले हिस्से पर अडैप्टिव बैनर दिखाते समय, बैनर व्यू के निचले हिस्से को लेआउट गाइड के सबसे ऊपर मौजूद लेवल के बराबर सेट करें. साथ ही, बीच के X को सुपरव्यू के सेंटर X के बराबर सेट करें.

बैनर का विज्ञापन साइज़ अब भी प्रोग्राम के हिसाब से सेट है:

Swift

  bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)

Objective-C

  self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);

विज्ञापन लोड करें

GADBannerView के सही जगह पर और इसकी प्रॉपर्टी कॉन्फ़िगर हो जाने के बाद, विज्ञापन लोड किया जाता है. ऐसा करने के लिए, loadRequest: को किसी GADRequest ऑब्जेक्ट पर कॉल किया जाता है:

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  ...
  
  //  Set the ad unit ID and view controller that contains the GADBannerView.
  bannerView.adUnitID = "ca-app-pub-3940256099942544/2435281174"
  bannerView.rootViewController = self

  bannerView.load(GADRequest())
}

Objective-C

-   (void)viewDidLoad {
  [super viewDidLoad];
  ...
  
  //  Set the ad unit ID and view controller that contains the GADBannerView.
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2435281174";
  self.bannerView.rootViewController = self;

  [self.bannerView loadRequest:[GADRequest request]];
}

GADRequest ऑब्जेक्ट सिर्फ़ एक विज्ञापन अनुरोध दिखाते हैं. इनमें टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) जैसी जानकारी शामिल होती है.

अगर आपका विज्ञापन लोड नहीं हो रहा है, तो जब तक आपने विज्ञापन यूनिट को रीफ़्रेश करने के लिए कॉन्फ़िगर किया है, तब तक आपको दूसरे विज्ञापन के लिए अनुरोध करने की ज़रूरत नहीं है. Google Mobile Ads SDK, AdMob के यूज़र इंटरफ़ेस (यूआई) में बताई गई रीफ़्रेश दर के हिसाब से काम करता है. अगर आपने रीफ़्रेश करने की सुविधा चालू नहीं की है, तो आपको नया अनुरोध करना होगा.

विज्ञापन इवेंट

GADBannerViewDelegate का इस्तेमाल करके, लाइफ़साइकल इवेंट को सुना जा सकता है, जैसे कि कोई विज्ञापन कब बंद होता है या उपयोगकर्ता ऐप्लिकेशन से बाहर निकल जाता है.

बैनर इवेंट के लिए रजिस्टर करना

अगर आपको बैनर विज्ञापन इवेंट के लिए रजिस्टर करना है, तो GADBannerView पर delegate प्रॉपर्टी को उस ऑब्जेक्ट पर सेट करें जो GADBannerViewDelegate प्रोटोकॉल को लागू करता है. आम तौर पर, बैनर विज्ञापनों को लागू करने वाली क्लास, डेलिगेट क्लास के तौर पर भी काम करती है. इस मामले में, delegate प्रॉपर्टी को self पर सेट किया जा सकता है.

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADBannerViewDelegate {

  var bannerView: GADBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()
    ...
    bannerView.delegate = self
  }
}

Objective-C

@import GoogleMobileAds;

@interface ViewController () <GADBannerViewDelegate>

@property(nonatomic, strong) GADBannerView *bannerView;

@end

@implementation ViewController

-   (void)viewDidLoad {
  [super viewDidLoad];
  ...
  self.bannerView.delegate = self;
}

बैनर इवेंट लागू करना

GADBannerViewDelegate में दिए गए हर तरीके को 'ज़रूरी नहीं' के तौर पर मार्क किया गया है. इसलिए, आपको सिर्फ़ अपने मनचाहे तरीके लागू करने होंगे. यह उदाहरण हर तरीके को लागू करता है और कंसोल पर एक मैसेज लॉग करता है:

Swift

func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
  print("bannerViewDidReceiveAd")
}

func bannerView(_ bannerView: GADBannerView, didFailToReceiveAdWithError error: Error) {
  print("bannerView:didFailToReceiveAdWithError: \(error.localizedDescription)")
}

func bannerViewDidRecordImpression(_ bannerView: GADBannerView) {
  print("bannerViewDidRecordImpression")
}

func bannerViewWillPresentScreen(_ bannerView: GADBannerView) {
  print("bannerViewWillPresentScreen")
}

func bannerViewWillDismissScreen(_ bannerView: GADBannerView) {
  print("bannerViewWillDIsmissScreen")
}

func bannerViewDidDismissScreen(_ bannerView: GADBannerView) {
  print("bannerViewDidDismissScreen")
}

Objective-C

-   (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidReceiveAd");
}

-   (void)bannerView:(GADBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error {
  NSLog(@"bannerView:didFailToReceiveAdWithError: %@", [error localizedDescription]);
}

-   (void)bannerViewDidRecordImpression:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidRecordImpression");
}

-   (void)bannerViewWillPresentScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillPresentScreen");
}

-   (void)bannerViewWillDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillDismissScreen");
}

-   (void)bannerViewDidDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidDismissScreen");
}

iOS API के डेमो ऐप्लिकेशन में, बैनर डेलिगेट के तरीकों को लागू करने के लिए, विज्ञापन डेलिगेट का उदाहरण देखें.

स्विफ़्ट Objective-C

इस्तेमाल के उदाहरण

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

विज्ञापन मिलने के बाद, व्यू हैरारकी में बैनर जोड़ना

विज्ञापन मिलने के बाद, व्यू हैरारकी में GADBannerView जोड़ना मुश्किल हो सकता है. ऐसा करने के लिए, bannerViewDidReceiveAd: इवेंट को सुनकर ऐसा किया जा सकता है:

Swift

func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
  // Add banner to view and add constraints as above.
  addBannerViewToView(bannerView)
}

Objective-C

-   (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  // Add bannerView to view and add constraints as above.
  [self addBannerViewToView:self.bannerView];
}

बैनर विज्ञापन को ऐनिमेट करना

बैनर विज्ञापन वापस आने के बाद, उसे ऐनिमेट करने के लिए bannerViewDidReceiveAd: इवेंट का इस्तेमाल भी किया जा सकता है, जैसा कि इस उदाहरण में दिखाया गया है:

Swift

func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
  bannerView.alpha = 0
  UIView.animate(withDuration: 1, animations: {
    bannerView.alpha = 1
  })
}

Objective-C

-   (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  bannerView.alpha = 0;
  [UIView animateWithDuration:1.0 animations:^{
    bannerView.alpha = 1;
  }];
}

ऐप्लिकेशन को रोकना और उसे फिर से शुरू करना

GADBannerViewDelegate प्रोटोकॉल में आपको इवेंट की सूचना देने के तरीके होते हैं, जैसे कि जब किसी क्लिक की वजह से ओवरले दिखाया या खारिज किया जाता है. अगर आपको यह पता करना है कि ये इवेंट विज्ञापनों की वजह से हुए हैं या नहीं, तो इन GADBannerViewDelegate तरीकों के लिए रजिस्टर करें.

सिर्फ़ विज्ञापन पर क्लिक करने से आने वाले ओवरले प्रज़ेंटेशन और बाहरी ब्राउज़र के शुरू होने के सभी तरह के ओवरले प्रज़ेंटेशन पाने के लिए, आपके ऐप्लिकेशन को UIViewController या UIApplication पर ऐसे मिलते-जुलते तरीकों का इस्तेमाल करना चाहिए. इस टेबल में, iOS के ऐसे मिलते-जुलते तरीके दिखाए गए हैं जिन्हें GADBannerViewDelegate तरीकों के साथ एक ही समय पर शुरू किया जाता है:

GADBannerViewDelegate iOS का तरीका
bannerViewWillPresentScreen: UIViewController का viewWillDisappear:
bannerViewWillDismissScreen: UIViewController का viewWillAppear:
bannerViewDidDismissScreen: UIViewController का viewDidAppear:

अन्य संसाधन

GitHub पर उदाहरण

  • ऐंकर किए गए अडैप्टिव बैनर वाले विज्ञापनों का उदाहरण: Swift | Objective-C
  • बेहतर सुविधाओं का डेमो: Swift | Objective-C

अगले चरण

छोटे किए जा सकने वाले बैनर

छोटे हो सकने वाले बैनर विज्ञापन ऐसे बैनर विज्ञापन होते हैं जो शुरुआत में एक बड़े ओवरले के रूप में दिखाए जाते हैं. इनमें, विज्ञापन को छोटा करने के लिए एक बटन होता है. अपने प्रदर्शन को और ज़्यादा ऑप्टिमाइज़ करने के लिए इसका इस्तेमाल करने पर विचार करें. ज़्यादा जानकारी के लिए, छोटे हो जाने वाले बैनर विज्ञापन देखें.

इनलाइन अडैप्टिव बैनर

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

दूसरे विषय एक्सप्लोर करें