iPhone X पर विज्ञापन रेंडर करना

इस गाइड में, iPhone X पर विज्ञापन सही तरीके से दिखाने के लिए, ऐप्लिकेशन को कोड करने के सबसे सही तरीकों के बारे में बताया गया है.

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

• 'शुरू करें' सेक्शन में दी गई ज़रूरी शर्तें पूरी करें.

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

बैनर विज्ञापनों को "सुरक्षित जगह" पर रखा जाना चाहिए, ताकि गोल किए गए कोने, सेंसर हाउसिंग, और होम इंडिकेटर की वजह से विज्ञापन दिखने में दिक्कत न हो. इस पेज पर, बैनर को सुरक्षित जगह में ऊपर या नीचे रखने के लिए सीमाएं जोड़ने के तरीके के उदाहरण दिए गए हैं. स्टोरीबोर्ड और प्रोग्राम के हिसाब से तय की गई सीमाओं, दोनों को ऐसे एनवायरमेंट में दिखाया गया है जो iOS 9+ और Xcode 9+ पर काम करता है. iOS और Xcode के पुराने वर्शन के लिए, वैकल्पिक तरीकों के बारे में भी बताया गया है.

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

अगर आपका ऐप्लिकेशन, इंटरफ़ेस बिल्डर का इस्तेमाल करता है, तो सबसे पहले पक्का करें कि आपने सुरक्षित जगह के लेआउट गाइड चालू किए हों. इसके लिए, आपके पास Xcode 9+ होना चाहिए और आपका ऐप्लिकेशन iOS 9+ को टारगेट कर रहा हो.

इंटरफ़ेस बिल्डर की फ़ाइल खोलें और व्यू कंट्रोलर सीन पर क्लिक करें. आपको दाईं ओर इंटरफ़ेस बिल्डर दस्तावेज़ के विकल्प दिखेंगे. सुरक्षित जगह के लेआउट गाइड का इस्तेमाल करें को चुनें और पक्का करें कि आपने कम से कम iOS 9.0 और उसके बाद के वर्शन के लिए बिल्ड किया हो.

हमारा सुझाव है कि चौड़ाई और ऊंचाई की सीमाओं का इस्तेमाल करके, बैनर को ज़रूरी साइज़ तक सीमित करें.

अब GAMBannerView की सबसे ऊपर वाली प्रॉपर्टी को सुरक्षित जगह के सबसे ऊपर वाले हिस्से तक सीमित करके, बैनर को सुरक्षित जगह के सबसे ऊपर वाले हिस्से के साथ अलाइन किया जा सकता है:

इसी तरह, GAMBannerView की सबसे नीचे वाली प्रॉपर्टी को सुरक्षित जगह के सबसे नीचे वाले हिस्से तक सीमित करके, बैनर को सुरक्षित जगह के सबसे नीचे वाले हिस्से के साथ अलाइन किया जा सकता है:

आपकी सीमाएं अब नीचे दिए गए स्क्रीनशॉट की तरह दिखनी चाहिए (साइज़/जगह अलग-अलग हो सकती है):

ViewController

यहां एक सामान्य व्यू कंट्रोलर कोड स्निपेट दिया गया है. इसमें, ऊपर दिए गए स्टोरीबोर्ड में कॉन्फ़िगर किए गए GAMBannerView में बैनर दिखाने के लिए ज़रूरी कोड शामिल है:

Swift

class ViewController: UIViewController {

  /// The banner view.
  @IBOutlet var bannerView: AdManagerBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()
    // Replace this ad unit ID with your own ad unit ID.
    bannerView.adUnitID = "/21775744923/example/adaptive-banner"
    bannerView.rootViewController = self
    bannerView.load(AdManagerRequest())
  }

}

Objective-C

@interface ViewController()

@property(nonatomic, strong) IBOutlet GAMBannerView *bannerView;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  // Replace this ad unit ID with your own ad unit ID.
  self.bannerView.adUnitID = @"/21775744923/example/adaptive-banner";
  self.bannerView.rootViewController = self;
  GAMRequest *request = [GAMRequest request];
  [self.bannerView loadRequest:request];
}

बैनर को सुरक्षित जगह के किनारे पर अलाइन करना

अगर आपको पूरी चौड़ाई वाला, बाईं या दाईं ओर अलाइन किया गया बैनर दिखाना है, तो बैनर के बाएं/दाएं किनारे को सुरक्षित जगह के बाएं/दाएं किनारे तक सीमित करें. इसे सुपरव्यू के बाएं/दाएं किनारे तक सीमित न करें.

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

iOS 8 और उससे पहले के वर्शन के लिए सहायता

अगर आपको इंटरफ़ेस बिल्डर का इस्तेमाल करके, iOS 8 या उससे पहले के वर्शन के लिए सहायता देनी है, तो आपको इंटरफ़ेस बिल्डर की फ़ाइलों और स्टोरीबोर्ड के लिए, सुरक्षित जगह के लेआउट गाइड का इस्तेमाल करें विकल्प से सही का निशान हटाना होगा.

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

साथ ही, सुरक्षित जगह के सबसे नीचे वाले हिस्से के बजाय, सबसे नीचे वाले लेआउट गाइड के सबसे ऊपर वाले हिस्से में सीमाएं जोड़ी जा सकती हैं:

पूरी चौड़ाई वाले बैनर के लिए (लैंडस्केप मोड में सिर्फ़ सुरक्षित जगह से असर पड़ता है), ये लेआउट गाइड मौजूद नहीं होती हैं. इंटरफ़ेस बिल्डर में सुरक्षित विकल्प यह है कि बाएं और दाएं किनारे की सीमाओं को मार्जिन के हिसाब से तय किया जाए:

इससे बैनर का किनारा, सुपरव्यू/सुरक्षित जगह के किनारे से थोड़ा हट जाएगा. इससे यह पक्का होगा कि iPhone X पर लैंडस्केप ओरिएंटेशन में आपका बैनर नहीं दिखेगा. प्रोग्राम के हिसाब से भी, मनचाहा नतीजा पाया जा सकता है.

प्रोग्रामेटिक

अगर आपका ऐप्लिकेशन, प्रोग्राम के हिसाब से बैनर विज्ञापन बनाता है, तो कोड में सीमाएं तय की जा सकती हैं और बैनर विज्ञापन की जगह तय की जा सकती है. इस उदाहरण (iOS वर्शन 7.0 और उसके बाद के वर्शन के लिए) में, बैनर को सुरक्षित जगह के सबसे नीचे वाले हिस्से में, बीच में अलाइन करने के लिए सीमा तय करने का तरीका बताया गया है:

Swift

class ViewController: UIViewController {

  var bannerView: AdManagerBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()

    // Instantiate the banner view with your desired banner size.
    bannerView = AdManagerBannerView(adSize: AdSizeBanner)
    addBannerViewToView(bannerView)
    bannerView.rootViewController = self
    // Set the ad unit ID to your own ad unit ID here.
    bannerView.adUnitID = "/21775744923/example/adaptive-banner"
    bannerView.load(AdManagerRequest())
  }

  func addBannerViewToView(_ bannerView: UIView) {
    bannerView.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(bannerView)
    if #available(iOS 11.0, *) {
      positionBannerAtBottomOfSafeArea(bannerView)
    }
    else {
      positionBannerAtBottomOfView(bannerView)
    }
  }

  @available (iOS 11, *)
  func positionBannerAtBottomOfSafeArea(_ bannerView: UIView) {
    // Position the banner. Stick it to the bottom of the Safe Area.
    // Centered horizontally.
    let guide: UILayoutGuide = view.safeAreaLayoutGuide

    NSLayoutConstraint.activate(
      [bannerView.centerXAnchor.constraint(equalTo: guide.centerXAnchor),
       bannerView.bottomAnchor.constraint(equalTo: guide.bottomAnchor)]
    )
  }

  func positionBannerAtBottomOfView(_ bannerView: UIView) {
    // Center the banner horizontally.
    view.addConstraint(NSLayoutConstraint(item: bannerView,
                                          attribute: .centerX,
                                          relatedBy: .equal,
                                          toItem: view,
                                          attribute: .centerX,
                                          multiplier: 1,
                                          constant: 0))
    // Lock the banner to the top of the bottom layout guide.
    view.addConstraint(NSLayoutConstraint(item: bannerView,
                                          attribute: .bottom,
                                          relatedBy: .equal,
                                          toItem: self.bottomLayoutGuide,
                                          attribute: .top,
                                          multiplier: 1,
                                          constant: 0))
  }

}

Objective-C

@interface ViewController()

@property(nonatomic, strong) GAMBannerView *bannerView;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  // Instantiate the banner view with your desired banner size.
  self.bannerView = [[GAMBannerView alloc] initWithAdSize:kGADAdSizeBanner];
  [self addBannerViewToVIew:self.bannerView];

  // Replace this ad unit ID with your own ad unit ID.
  self.bannerView.adUnitID = @"/21775744923/example/adaptive-banner";
  self.bannerView.rootViewController = self;
  GAMRequest *request = [GAMRequest request];
  [self.bannerView loadRequest:request];
}

#pragma mark - view positioning

-(void)addBannerViewToView:(UIView *_Nonnull)bannerView {
  self.bannerView.translatesAutoresizingMaskIntoConstraints = NO;
  [self.view addSubview:self.bannerView];
  if (@available(ios 11.0, *)) {
    [self positionBannerViewAtBottomOfSafeArea:bannerView];
  } else {
    [self positionBannerViewAtBottomOfView:bannerView];
  }
}

- (void)positionBannerViewAtBottomOfSafeArea:(UIView *_Nonnull)bannerView NS_AVAILABLE_IOS(11.0) {
  // Position the banner. Stick it to the bottom of the Safe Area.
  // Centered horizontally.
  UILayoutGuide *guide = self.view.safeAreaLayoutGuide;
  [NSLayoutConstraint activateConstraints:@[
    [bannerView.centerXAnchor constraintEqualToAnchor:guide.centerXAnchor],
    [bannerView.bottomAnchor constraintEqualToAnchor:guide.bottomAnchor]
  ]];
}

- (void)positionBannerViewAtBottomOfView:(UIView *_Nonnull)bannerView {
  [self.view addConstraint:[NSLayoutConstraint constraintWithItem:bannerView
                                                        attribute:NSLayoutAttributeCenterX
                                                        relatedBy:NSLayoutRelationEqual
                                                           toItem:self.view
                                                        attribute:NSLayoutAttributeCenterX
                                                       multiplier:1
                                                         constant:0]];
  [self.view addConstraint:[NSLayoutConstraint constraintWithItem:bannerView
                                                        attribute:NSLayoutAttributeBottom
                                                        relatedBy:NSLayoutRelationEqual
                                                           toItem:self.bottomLayoutGuide
                                                        attribute:NSLayoutAttributeTop
                                                       multiplier:1
                                                         constant:0]];
}

@end

ऊपर बताई गई तकनीकों का इस्तेमाल करके, सुरक्षित जगह के सबसे ऊपर वाले हिस्से में सीमाएं तय की जा सकती हैं. इसके लिए, इस्तेमाल किए गए एट्रिब्यूट और ऐंकर में बदलाव करना होगा.

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

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

इंटरस्टीशियल और इनाम वाले विज्ञापन

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