iPhone X বিজ্ঞাপন রেন্ডারিং

এই নির্দেশিকাটি iPhone X-এ সঠিকভাবে বিজ্ঞাপন রেন্ডার করার জন্য আপনার অ্যাপগুলিকে কীভাবে কোড করতে হয় তার সর্বোত্তম অনুশীলনগুলি প্রদর্শন করে৷

পূর্বশর্ত

গোলাকার কোণ, সেন্সর হাউজিং এবং হোম ইন্ডিকেটর দ্বারা অস্পষ্ট হওয়া এড়াতে ব্যানার বিজ্ঞাপনগুলি অবশ্যই "নিরাপদ এলাকায়" স্থাপন করতে হবে। এই পৃষ্ঠায় আপনি নিরাপদ এলাকার উপরে বা নীচে একটি ব্যানার স্থাপন করার জন্য কীভাবে সীমাবদ্ধতা যুক্ত করবেন তার উদাহরণ পাবেন। স্টোরিবোর্ড এবং প্রোগ্রামেটিক সীমাবদ্ধতা উভয়ই এমন পরিবেশে প্রদর্শিত হয় যা iOS 9+ এবং Xcode 9+ সমর্থন করে। আইওএস এবং এক্সকোডের পূর্ববর্তী সংস্করণগুলির জন্য সমাধানগুলিও উল্লেখ করা হয়েছে।

স্টোরিবোর্ড/ইন্টারফেস বিল্ডার

যদি আপনার অ্যাপ ইন্টারফেস বিল্ডার ব্যবহার করে, প্রথমে নিশ্চিত করুন যে আপনি নিরাপদ এলাকা লেআউট গাইড সক্রিয় করেছেন। এটি করার জন্য আপনাকে Xcode 9+ চালাতে হবে এবং iOS 9+ টার্গেট করতে হবে।

আপনার ইন্টারফেস বিল্ডার ফাইল খুলুন এবং আপনার ভিউ কন্ট্রোলার দৃশ্যে ক্লিক করুন। আপনি ডানদিকে ইন্টারফেস বিল্ডার ডকুমেন্ট অপশন দেখতে পাবেন। নিরাপদ এলাকা লেআউট গাইড ব্যবহার করুন এবং নিশ্চিত করুন যে আপনি সর্বনিম্ন হিসাবে iOS 9.0 এবং পরবর্তীতে তৈরি করছেন।

আমরা আপনাকে প্রস্থ এবং উচ্চতার সীমাবদ্ধতা ব্যবহার করে ব্যানারটিকে প্রয়োজনীয় আকারে সীমাবদ্ধ করার পরামর্শ দিই।

এখন আপনি নিরাপদ এলাকার শীর্ষে GAMBannerView এর শীর্ষ সম্পত্তি সীমাবদ্ধ করে ব্যানারটিকে নিরাপদ এলাকার শীর্ষে সারিবদ্ধ করতে পারেন:

একইভাবে, আপনি নিরাপদ এলাকার নীচে GAMBannerView এর নীচের সম্পত্তিকে সীমাবদ্ধ করে ব্যানারটিকে নিরাপদ এলাকার নীচে সারিবদ্ধ করতে পারেন:

আপনার সীমাবদ্ধতাগুলি এখন নীচের স্ক্রিনশটের মতো দেখতে হবে (আকার/পজিশনিং পরিবর্তিত হতে পারে):

ভিউ কন্ট্রোলার

এখানে একটি সাধারণ ভিউ কন্ট্রোলার কোড স্নিপেট রয়েছে যা উপরের স্টোরিবোর্ডে কনফিগার করা GAMBannerView এ একটি ব্যানার দেখানোর জন্য ন্যূনতম প্রয়োজনীয় কাজ করে:

সুইফট

class ViewController: UIViewController {

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

  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(GAMRequest())
  }

}

উদ্দেশ্য-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 এবং উচ্চতরের জন্য) দেখায় কিভাবে একটি ব্যানারকে নিরাপদ এলাকার নীচে অনুভূমিকভাবে কেন্দ্রীভূত করতে বাধা দিতে হয়:

সুইফট

class ViewController: UIViewController {

  var bannerView: GAMBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()

    // Instantiate the banner view with your desired banner size.
    bannerView = GAMBannerView(adSize: kGADAdSizeBanner)
    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(GAMRequest())
  }

  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))
  }

}

উদ্দেশ্য-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 মোবাইল বিজ্ঞাপন SDK দ্বারা রেন্ডার করা হয়৷ ক্লোজ বোতামের মতো বিজ্ঞাপনের উপাদানগুলি সঠিক স্থানে রেন্ডার হয় তা নিশ্চিত করতে Google মোবাইল বিজ্ঞাপন SDK-তে একটি আপডেট থাকবে। এই পরিবর্তন উপলব্ধ হলে আমরা রিলিজ নোট এবং এই ডকুমেন্টেশন পৃষ্ঠা আপডেট করব।