बैनर विज्ञापन, आयताकार विज्ञापन होते हैं. ये ऐप्लिकेशन के लेआउट का कुछ हिस्सा घेरते हैं. जब उपयोगकर्ता आपके ऐप्लिकेशन के साथ इंटरैक्ट करते हैं, तब स्क्रीन पर सबसे ऊपर या सबसे नीचे बैनर विज्ञापन दिखते रहते हैं. इसी तरह स्क्रीन पर स्क्रोल करने के दौरान भी ये विज्ञापन इनलाइन होकर दिखते रहते हैं. बैनर विज्ञापन एक तय समय के बाद अपने-आप रीफ़्रेश हो सकते हैं. ज़्यादा जानकारी के लिए, बैनर विज्ञापनों की खास जानकारी देखें.
इस गाइड में ऐंकर किए गए एडाप्टिव बैनर विज्ञापनों के साथ शुरुआत करने का तरीका बताया गया है. यह आपकी तय की गई विज्ञापन चौड़ाई का इस्तेमाल करके हर डिवाइस के लिए विज्ञापन के साइज़ को ऑप्टिमाइज़ करके, परफ़ॉर्मेंस को बेहतर बनाता है.
ऐंकर किया गया अडैप्टिव बैनर
ऐंकर किए गए अडैप्टिव बैनर वाले विज्ञापन, तय आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) वाले विज्ञापन होते हैं, न कि सामान्य तय साइज़ वाले विज्ञापनों. आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) 320*50 इंडस्ट्री स्टैंडर्ड के जैसा होता है. उपलब्ध पूरी चौड़ाई तय करने के बाद, आपको उस चौड़ाई के लिए सही ऊंचाई वाला विज्ञापन दिखेगा. एक ही डिवाइस से किए गए अनुरोधों पर सही ऊंचाई में बदलाव नहीं होता और विज्ञापन रीफ़्रेश होने पर आस-पास के व्यू को इधर-उधर जाने की ज़रूरत नहीं होती.
ज़रूरी शर्तें
- शुरुआती निर्देश के बारे में पूरी जानकारी दें.
हमेशा टेस्ट विज्ञापनों से टेस्ट करें
अपने ऐप्लिकेशन बनाते और उनकी जांच करते समय पक्का करें कि आप लाइव, प्रोडक्शन विज्ञापनों के बजाय टेस्ट विज्ञापनों का इस्तेमाल करें. ऐसा न करने पर, आपका खाता निलंबित किया जा सकता है.
टेस्ट विज्ञापन लोड करने का सबसे आसान तरीका, iOS बैनर के लिए बनाए गए टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करना है:
/6499/example/adaptive-banner
इसे खास तौर पर कॉन्फ़िगर किया गया है, ताकि हर अनुरोध के लिए टेस्ट विज्ञापन दिखाए जा सकें. साथ ही, कोडिंग, टेस्टिंग, और डीबग करने के दौरान, इसे अपने ऐप्लिकेशन में इस्तेमाल किया जा सकता है. अपना ऐप्लिकेशन पब्लिश करने से पहले, यह पक्का कर लें कि आपने उसकी जगह अपना विज्ञापन यूनिट आईडी डाल दिया हो.
मोबाइल विज्ञापन SDK के टेस्ट विज्ञापन कैसे काम करते हैं, इस बारे में ज़्यादा जानकारी के लिए टेस्ट विज्ञापन देखें.
एक GAMBannerView बनाएं
बैनर विज्ञापन, GAMBannerView
ऑब्जेक्ट में दिखते हैं. इसलिए, बैनर विज्ञापनों को इंटिग्रेट करने के लिए सबसे पहले, व्यू हैरारकी (व्यू और व्यू ग्रुप के लेआउट का क्रम) में GAMBannerView
शामिल करें. आम तौर पर, यह प्रोसेस प्रोग्रामैटिक तरीके से या इंटरफ़ेस बिल्डर की मदद से की जाती है.
प्रोग्रैम्ड तरीके से
GAMBannerView
को सीधे इंस्टैंशिएट भी किया जा सकता है.
स्क्रीन के सेफ़ एरिया के सबसे नीचे बीच में अलाइन करके, GAMBannerView
बनाने का तरीका यहां दिया गया है:
Swift
import GoogleMobileAds import UIKit class ViewController: UIViewController { var bannerView: GAMBannerView! 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 = GAMBannerView(adSize: adaptiveSize) addBannerViewToView(bannerView) } func addBannerViewToView(_ bannerView: GAMBannerView) { 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) GAMBannerView *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 = [[GAMBannerView 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
ध्यान दें कि इस मामले में हम चौड़ाई या ऊंचाई से जुड़ी पाबंदी नहीं देते, क्योंकि विज्ञापन का दिया गया साइज़, बैनर को कॉन्टेंट का असल साइज़ देगा, ताकि उसका साइज़ बन सके.
इंटरफ़ेस बिल्डर
GAMBannerView
को किसी स्टोरीबोर्ड या xib फ़ाइल में
जोड़ा जा सकता है. इस तरीके का इस्तेमाल करते समय, पक्का करें कि बैनर पर सिर्फ़ पोज़िशन कंस्ट्रेंट जोड़ें. उदाहरण के लिए, स्क्रीन के निचले हिस्से पर अडैप्टिव बैनर दिखाते समय, बैनर व्यू के निचले हिस्से को लेआउट गाइड के सबसे ऊपर मौजूद लेवल के बराबर सेट करें. साथ ही, बीच के X को सुपरव्यू के सेंटर X के बराबर सेट करें.
बैनर का विज्ञापन साइज़ अब भी प्रोग्राम के हिसाब से सेट है:
Swift
bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
Objective-C
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
विज्ञापन लोड करें
GAMBannerView
के सही जगह पर और इसकी प्रॉपर्टी
कॉन्फ़िगर हो जाने के बाद, विज्ञापन लोड किया जाता है. ऐसा करने के लिए, loadRequest:
को किसी
GAMRequest
ऑब्जेक्ट पर कॉल किया जाता है:
Swift
override func viewDidLoad() { super.viewDidLoad() ... // Set the ad unit ID and view controller that contains the GAMBannerView. bannerView.adUnitID = "/6499/example/adaptive-banner" bannerView.rootViewController = self bannerView.load(GAMRequest()) }
Objective-C
- (void)viewDidLoad { [super viewDidLoad]; ... // Set the ad unit ID and view controller that contains the GAMBannerView. self.bannerView.adUnitID = @"/6499/example/adaptive-banner"; self.bannerView.rootViewController = self; [self.bannerView loadRequest:[GAMRequest request]]; }
GAMRequest ऑब्जेक्ट सिर्फ़ एक विज्ञापन अनुरोध को दिखाते हैं और इसमें टारगेटिंग की जानकारी जैसी प्रॉपर्टी शामिल होती हैं.
अगर आपका विज्ञापन लोड नहीं हो रहा है, तो जब तक आपने विज्ञापन यूनिट को रीफ़्रेश करने के लिए कॉन्फ़िगर कर लिया है, तब तक आपको साफ़ तौर पर दूसरे विज्ञापन का अनुरोध करने की ज़रूरत नहीं है. Google Mobile Ads SDK, Ad Manager यूज़र इंटरफ़ेस (यूआई) में बताई गई रीफ़्रेश दर के हिसाब से काम करता है. अगर आपने रीफ़्रेश करने की सुविधा चालू नहीं की है, तो आपको नया अनुरोध करना होगा.
विज्ञापन इवेंट
GADBannerViewDelegate
का इस्तेमाल करके, लाइफ़साइकल इवेंट को सुना जा सकता है, जैसे कि कोई विज्ञापन कब बंद होता है या उपयोगकर्ता ऐप्लिकेशन से बाहर निकल जाता है.
बैनर इवेंट के लिए रजिस्टर करना
अगर आपको बैनर विज्ञापन इवेंट के लिए रजिस्टर करना है, तो GAMBannerView
पर delegate
प्रॉपर्टी को उस ऑब्जेक्ट पर सेट करें जो GADBannerViewDelegate
प्रोटोकॉल को लागू करता है. आम तौर पर, बैनर विज्ञापनों को लागू करने वाली क्लास, डेलिगेट क्लास के तौर पर भी काम करती है. इस मामले में, delegate
प्रॉपर्टी को self
पर सेट किया जा सकता है.
Swift
import GoogleMobileAds import UIKit class ViewController: UIViewController, GADBannerViewDelegate { var bannerView: GAMBannerView! override func viewDidLoad() { super.viewDidLoad() ... bannerView.delegate = self } }
Objective-C
@import GoogleMobileAds; @interface ViewController () <GADBannerViewDelegate> @property(nonatomic, strong) GAMBannerView *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 के डेमो ऐप्लिकेशन में, बैनर डेलिगेट के तरीकों को लागू करने के लिए, विज्ञापन डेलिगेट का उदाहरण देखें.
इस्तेमाल के उदाहरण
यहां विज्ञापन इवेंट के इन तरीकों के इस्तेमाल के कुछ उदाहरण दिए गए हैं.
विज्ञापन मिलने के बाद, व्यू हैरारकी में बैनर जोड़ना
विज्ञापन मिलने के बाद, व्यू हैरारकी में GAMBannerView
जोड़ना मुश्किल हो सकता है. ऐसा करने के लिए, bannerViewDidReceiveAd:
इवेंट
को सुनकर ऐसा किया जा सकता है:
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) { // Add banner to view and add constraints as above. addBannerViewToView(bannerView) }
Objective-C
- (void)bannerViewDidReceiveAd:(GAMBannerView *)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:(GAMBannerView *)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: |
इंप्रेशन की मैन्युअल तरीके से गिनती
अगर किसी इंप्रेशन को रिकॉर्ड करने के लिए कुछ खास शर्तें हैं, तो Ad Manager को मैन्युअल तौर पर इंप्रेशन पिंग भेजे जा सकते हैं. ऐसा किसी विज्ञापन को लोड करने से पहले, मैन्युअल इंप्रेशन के लिए GAMBannerView
को चालू करके किया जा सकता है:
Swift
bannerView.enableManualImpressions = true
Objective-C
self.bannerView.enableManualImpressions = YES;
जब आपको यह पता चलता है कि विज्ञापन सही तरीके से वापस आ गया है और वह स्क्रीन पर दिख रहा है, तो मैन्युअल रूप से इंप्रेशन ट्रिगर किए जा सकते हैं:
Swift
bannerView.recordImpression()
Objective-C
[self.bannerView recordImpression];
ऐप्लिकेशन इवेंट
ऐप्लिकेशन इवेंट की मदद से, ऐसे विज्ञापन बनाए जा सकते हैं जो अपने ऐप्लिकेशन कोड पर मैसेज भेज सकते हैं. इसके बाद, ऐप्लिकेशन इन मैसेज के आधार पर कार्रवाइयां कर सकता है.
GADAppEventDelegate
का इस्तेमाल करके, Ad Manager के खास ऐप्लिकेशन इवेंट सुने जा सकते हैं.
ये इवेंट, विज्ञापन के लाइफ़साइकल के दौरान किसी भी समय हो सकते हैं. ऐसा, GADBannerViewDelegate
ऑब्जेक्ट के bannerViewDidReceiveAd:
को कॉल करने से पहले भी हो सकता है.
Swift
// Implement your app event within this method. The delegate will be // notified when the SDK receives an app event message from the ad. // Called when the banner receives an app event. optional public func bannerView(_ banner: GAMBannerView, didReceiveAppEvent name: String, withInfo info: String?)
Objective-C
// Implement your app event within this method. The delegate will be // notified when the SDK receives an app event message from the ad. @optional // Called when the banner receives an app event. - (void)bannerView:(GAMBannerView *)banner didReceiveAppEvent:(NSString *)name withInfo:(NSString *)info;
आपके ऐप्लिकेशन इवेंट के तरीकों को व्यू कंट्रोलर में लागू किया जा सकता है:
Swift
import GoogleMobileAds class ViewController: UIViewController, GADAppEventDelegate { }
Objective-C
@import GoogleMobileAds; @interface ViewController : UIViewController <GADAppEventDelegate> { } @end
किसी विज्ञापन के लिए अनुरोध करने से पहले, appEventDelegate
प्रॉपर्टी का इस्तेमाल करके डेलिगेट को सेट करना न भूलें.
Swift
bannerView.appEventDelegate = self
Objective-C
self.bannerView.appEventDelegate = self;
यहां एक उदाहरण दिया गया है, जिसमें ऐप्लिकेशन इवेंट के ज़रिए रंग की जानकारी देकर, अपने ऐप्लिकेशन के बैकग्राउंड का रंग बदलने का तरीका बताया गया है:
Swift
func bannerView(_ banner: GAMBannerView, didReceiveAppEvent name: String, withInfo info: String?) { if name == "color" { guard let info = info else { return } switch info { case "green": // Set background color to green. view.backgroundColor = UIColor.green case "blue": // Set background color to blue. view.backgroundColor = UIColor.blue default: // Set background color to black. view.backgroundColor = UIColor.black } } }
Objective-C
- (void)bannerView:(GAMBannerView *)banner didReceiveAppEvent:(NSString *)name withInfo:(NSString *)info { if ([name isEqual:@"color"]) { if ([info isEqual:@"green"]) { // Set background color to green. self.view.backgroundColor = [UIColor greenColor]; } else if ([info isEqual:@"blue"]) { // Set background color to blue. self.view.backgroundColor = [UIColor blueColor]; } else // Set background color to black. self.view.backgroundColor = [UIColor blackColor]; } } }
और यह रहा संबंधित क्रिएटिव, जो appEventDelegate
को कलर ऐप्लिकेशन इवेंट मैसेज भेजता है:
<html> <head> <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script> <script> document.addEventListener("DOMContentLoaded", function() { // Send a color=green event when ad loads. admob.events.dispatchAppEvent("color", "green"); document.getElementById("ad").addEventListener("click", function() { // Send a color=blue event when ad is clicked. admob.events.dispatchAppEvent("color", "blue"); }); }); </script> <style> #ad { width: 320px; height: 50px; top: 0px; left: 0px; font-size: 24pt; font-weight: bold; position: absolute; background: black; color: white; text-align: center; } </style> </head> <body> <div id="ad">Carpe diem!</div> </body> </html>
iOS API के डेमो ऐप्लिकेशन में ऐप्लिकेशन इवेंट लागू करने के लिए, Ad Manager ऐप्लिकेशन इवेंट का उदाहरण देखें.
अन्य संसाधन
GitHub पर उदाहरण
- ऐंकर किए गए अडैप्टिव बैनर वाले विज्ञापनों का उदाहरण: Swift | Objective-C
- बेहतर सुविधाओं का डेमो: Swift | Objective-C
अगले चरण
छोटे किए जा सकने वाले बैनर
छोटे हो सकने वाले बैनर विज्ञापन ऐसे बैनर विज्ञापन होते हैं जो शुरुआत में एक बड़े ओवरले के रूप में दिखाए जाते हैं. इनमें, विज्ञापन को छोटा करने के लिए एक बटन होता है. अपने प्रदर्शन को और ज़्यादा ऑप्टिमाइज़ करने के लिए इसका इस्तेमाल करने पर विचार करें. ज़्यादा जानकारी के लिए, छोटे हो जाने वाले बैनर विज्ञापन देखें.
इनलाइन अडैप्टिव बैनर
ऐंकर किए गए अडैप्टिव बैनर की तुलना में, इनलाइन अडैप्टिव बैनर बड़े और लंबे होते हैं. इनकी ऊंचाई अलग-अलग होती है और ये डिवाइस की स्क्रीन जितनी लंबी हो सकती हैं. उन ऐप्लिकेशन के लिए, जो ऐप्लिकेशन स्क्रोल किए जा सकने वाले कॉन्टेंट में बैनर विज्ञापन दिखाते हैं, ऐंकर वाले अडैप्टिव बैनर वाले विज्ञापनों के बजाय, इनलाइन अडैप्टिव बैनर का सुझाव दिया जाता है. ज़्यादा जानकारी के लिए, इनलाइन अडैप्टिव बैनर देखें.