Anzeigen-Rendering für iPhone X

In diesem Leitfaden werden Best Practices für die Programmierung von Apps beschrieben, damit Anzeigen auf dem iPhone X korrekt gerendert werden.

Vorbereitung

Banneranzeigen müssen in einem empfohlenen Bildbereich platziert werden, damit sie nicht durch abgerundete Kanten, das Sensorgehäuse und die Startbildschirmanzeige verdeckt werden. Auf dieser Seite finden Sie Beispiele dazu, wie Sie Einschränkungen hinzufügen, um ein Banner oben oder unten im empfohlenen Bildbereich zu platzieren.

Storyboard/Interface Builder

Wenn Sie in Ihrer App Interface Builder verwenden, müssen Sie zuerst die Layout-Anleitungen für den sicheren Bereich aktivieren. Dazu müssen Sie Xcode 9 oder höher verwenden und iOS 9 oder höher als Ziel festlegen.

Öffnen Sie die Interface Builder-Datei und klicken Sie auf die Ansichts-Controller-Szene. Rechts sehen Sie die Optionen für Interface Builder Document. Aktivieren Sie Use Safe Area Layout Guides und achten Sie darauf, dass Sie mindestens für iOS 9.0 und höher entwickeln.

Wir empfehlen, das Banner mithilfe von Breiten- und Höheneinschränkungen auf die erforderliche Größe zu beschränken.

Jetzt können Sie das Banner am oberen Rand des empfohlenen Bildbereichs ausrichten, indem Sie die Eigenschaft „Top“ der GADBannerView auf den oberen Rand des empfohlenen Bildbereichs beschränken:

Ebenso können Sie das Banner am unteren Rand des empfohlenen Bildbereichs ausrichten, indem Sie die Eigenschaft „Bottom“ der GADBannerView auf den unteren Rand des empfohlenen Bildbereichs beschränken:

Die Einschränkungen sollten jetzt in etwa so aussehen wie im Screenshot unten (Größe und Position können variieren):

ViewController

Hier ist ein einfaches Code-Snippet für einen View-Controller, das die Mindestanforderungen erfüllt, um ein Banner in einem GADBannerView anzuzeigen, wie im Storyboard oben konfiguriert:

Swift

class ViewController: UIViewController {

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

  override func viewDidLoad() {
    super.viewDidLoad()
    // Replace this ad unit ID with your own ad unit ID.
    bannerView.adUnitID = "ca-app-pub-3940256099942544/2934735716"
    bannerView.rootViewController = self
    bannerView.load(Request())
  }

}

Objective-C

@interface ViewController()

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

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  // Replace this ad unit ID with your own ad unit ID.
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2934735716";
  self.bannerView.rootViewController = self;
  GADRequest *request = [GADRequest request];
  [self.bannerView loadRequest:request];
}

Banner am Rand des empfohlenen Bildbereichs ausrichten

Wenn Sie ein links- oder rechtsbündiges Banner wünschen, beschränken Sie den linken/rechten Rand des Banners auf den linken/rechten Rand des sicheren Bereichs und nicht auf den linken/rechten Rand der Superview.

Wenn Sie Use Safe Area Layout Guides (Layout-Anleitungen für sicheren Bereich verwenden) aktiviert haben, verwendet der Interface Builder standardmäßig die Ränder des sicheren Bereichs, wenn der Ansicht Einschränkungen hinzugefügt werden.

Programmatic

Wenn Ihre App Banneranzeigen programmatisch erstellt, können Sie Einschränkungen definieren und die Banneranzeige im Code positionieren. In diesem Beispiel wird gezeigt, wie Sie ein Banner so einschränken, dass es horizontal am unteren Rand des sicheren Bereichs zentriert wird:

Swift

class ViewController: UIViewController {

  var bannerView: BannerView!

  override func viewDidLoad() {
    super.viewDidLoad()

    // Instantiate the banner view with your desired banner size.
    bannerView = BannerView(adSize: AdSizeBanner)
    addBannerViewToView(bannerView)
    bannerView.rootViewController = self
    // Set the ad unit ID to your own ad unit ID here.
    bannerView.adUnitID = "ca-app-pub-3940256099942544/2934735716"
    bannerView.load(Request())
  }

  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) GADBannerView *bannerView;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  // Instantiate the banner view with your desired banner size.
  self.bannerView = [[GADBannerView alloc] initWithAdSize:GADAdSizeBanner];
  [self addBannerViewToView:self.bannerView];

  // Replace this ad unit ID with your own ad unit ID.
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2934735716";
  self.bannerView.rootViewController = self;
  GADRequest *request = [GADRequest 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

Die oben genannten Techniken können leicht verwendet werden, um die Einschränkung auf den oberen Bereich des sicheren Bereichs zu beschränken, indem die verwendeten Attribute und Anker geändert werden.

Smart-Banner

Wenn Sie Smart-Banner verwenden, insbesondere im Querformat, empfehlen wir, die Bannerkanten mithilfe von Einschränkungen am linken und rechten Rand des sicheren Bereichs auszurichten.

Im Interface Builder wird dies bis iOS 9 unterstützt, wenn Sie die Option Use Safe Area Layout Guides wie oben beschrieben aktivieren.

Im Code sollten Sie die Randbeschränkungen relativ zu den Layout-Anleitungen für den sicheren Bereich festlegen, sofern verfügbar. Hier ist ein Code-Snippet, mit dem der Ansicht eine Banneransicht hinzugefügt und auf die volle Breite am unteren Rand der Ansicht beschränkt wird:

Swift

func addBannerViewToView(_ bannerView: BannerView) {
  bannerView.translatesAutoresizingMaskIntoConstraints = false
  view.addSubview(bannerView)
  if #available(iOS 11.0, *) {
    // In iOS 11, we need to constrain the view to the safe area.
    positionBannerViewFullWidthAtBottomOfSafeArea(bannerView)
  }
  else {
    // In lower iOS versions, safe area is not available so we use
    // bottom layout guide and view edges.
    positionBannerViewFullWidthAtBottomOfView(bannerView)
  }
}

// MARK: - view positioning
@available (iOS 11, *)
func positionBannerViewFullWidthAtBottomOfSafeArea(_ bannerView: UIView) {
  // Position the banner. Stick it to the bottom of the Safe Area.
  // Make it constrained to the edges of the safe area.
  let guide = view.safeAreaLayoutGuide
  NSLayoutConstraint.activate([
    guide.leftAnchor.constraint(equalTo: bannerView.leftAnchor),
    guide.rightAnchor.constraint(equalTo: bannerView.rightAnchor),
    guide.bottomAnchor.constraint(equalTo: bannerView.bottomAnchor)
  ])
}

func positionBannerViewFullWidthAtBottomOfView(_ bannerView: UIView) {
  view.addConstraint(NSLayoutConstraint(item: bannerView,
                                        attribute: .leading,
                                        relatedBy: .equal,
                                        toItem: view,
                                        attribute: .leading,
                                        multiplier: 1,
                                        constant: 0))
  view.addConstraint(NSLayoutConstraint(item: bannerView,
                                        attribute: .trailing,
                                        relatedBy: .equal,
                                        toItem: view,
                                        attribute: .trailing,
                                        multiplier: 1,
                                        constant: 0))
  view.addConstraint(NSLayoutConstraint(item: bannerView,
                                        attribute: .bottom,
                                        relatedBy: .equal,
                                        toItem: bottomLayoutGuide,
                                        attribute: .top,
                                        multiplier: 1,
                                        constant: 0))
}

Objective-C

- (void)addBannerViewToView:(UIView *)bannerView {
  bannerView.translatesAutoresizingMaskIntoConstraints = NO;
  [self.view addSubview:bannerView];
  if (@available(ios 11.0, *)) {
    // In iOS 11, we need to constrain the view to the safe area.
    [self positionBannerViewFullWidthAtBottomOfSafeArea:bannerView];
  } else {
    // In lower iOS versions, safe area is not available so we use
    // bottom layout guide and view edges.
    [self positionBannerViewFullWidthAtBottomOfView:bannerView];
  }
}

#pragma mark - view positioning

- (void)positionBannerViewFullWidthAtBottomOfSafeArea:(UIView *_Nonnull)bannerView NS_AVAILABLE_IOS(11.0) {
  // Position the banner. Stick it to the bottom of the Safe Area.
  // Make it constrained to the edges of the safe area.
  UILayoutGuide *guide = self.view.safeAreaLayoutGuide;

  [NSLayoutConstraint activateConstraints:@[
    [guide.leftAnchor constraintEqualToAnchor:bannerView.leftAnchor],
    [guide.rightAnchor constraintEqualToAnchor:bannerView.rightAnchor],
    [guide.bottomAnchor constraintEqualToAnchor:bannerView.bottomAnchor]
  ]];
}

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

Native Anzeigen

Wenn in Ihrer App native Anzeigen am oberen oder unteren Bildschirmrand fixiert sind, gelten für native Anzeigen dieselben Prinzipien wie für Banneranzeigen. Der Hauptunterschied besteht darin, dass Sie die Einschränkungen nicht einem GADBannerView, sondern der GADNativeAdView (oder der Ansicht, die die Anzeige enthält) hinzufügen müssen, um die Layout-Richtlinien für den sicheren Bereich einzuhalten. Für native Ansichten empfehlen wir, explizitere Größenbeschränkungen anzugeben.

Interstitial-Anzeigen und Anzeigen mit Prämie

Ab Version 7.26.0 unterstützt Google Mobile Ads SDK Interstitial- und Anzeigenformate mit Prämie für das iPhone X vollständig.