Renderización de anuncios de iPhone X

En esta guía, se muestran las prácticas recomendadas para codificar tus apps para que rendericen anuncios correctamente en el iPhone X.

Requisitos previos

Los anuncios de banner deben colocarse en la "Zona segura" para evitar que se oculten con las esquinas redondeadas, la carcasa del sensor y el indicador de inicio. En esta página, encontrarás ejemplos de cómo agregar restricciones para posicionar un banner en la parte superior o inferior de la zona segura. Se muestran tanto el guion gráfico como las restricciones programáticas en un entorno que admite iOS 9 y versiones posteriores, y Xcode 9 y versiones posteriores. También se indican las solución de problemas para versiones anteriores de iOS y Xcode.

Storyboard/Interface Builder

Si tu app usa Interface Builder, primero asegúrate de haber habilitado las guías de diseño del área segura. Para ello, debes ejecutar Xcode 9 o versiones posteriores y orientar tu contenido a iOS 9 o versiones posteriores.

Abre tu archivo de Interface Builder y haz clic en la escena del controlador de vista. A la derecha, verás las opciones del Documento de Interface Builder. Consulta Cómo usar guías de diseño de áreas seguras y asegúrate de compilar para iOS 9.0 y versiones posteriores como mínimo.

Te recomendamos que restrinjas el banner al tamaño requerido con restricciones de ancho y alto.

Ahora puedes alinear el banner con la parte superior del área segura si restringes la propiedad Top de GAMBannerView a la parte superior del área segura:

De manera similar, puedes alinear el banner con la parte inferior del área segura si limitas la propiedad Bottom de GAMBannerView a la parte inferior del área segura:

Tus restricciones ahora deberían verse similares a la captura de pantalla que se muestra a continuación (el tamaño o la posición pueden variar):

ViewController

Este es un fragmento de código de controlador de vista simple que hace lo mínimo necesario para mostrar un banner en un GAMBannerView, como se configuró en el guion gráfico anterior:

Swift

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

}

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];
}

Alineación de los banners con el borde del área segura

Si deseas tener un banner de ancho completo alineado a la izquierda o a la derecha, limita el borde izquierdo o derecho del banner al borde izquierdo o derecho del área segura y no al borde izquierdo o derecho de la supervista.

Si tienes habilitada la opción Use Safe Area Layout Guides, el compilador de interfaces usará de forma predeterminada los bordes del área segura cuando agregues restricciones a la vista.

Compatibilidad con iOS 8 y versiones anteriores

Si deseas admitir iOS 8 o versiones anteriores con Interface Builder, debes desmarcar la opción Use Safe Area Layout Guides para tus archivos y guiones gráficos de Interface Builder.

Ahora puedes agregar restricciones a la parte inferior de la guía de diseño superior (en lugar de la parte superior del área segura):

También agrega restricciones a la parte superior de la guía de diseño inferior (en lugar de la parte inferior de la zona segura):

En el caso de los banners de ancho completo (solo afectados por el área segura en orientación horizontal), no existen estas guías de diseño. La opción segura en Interface Builder es hacer que las restricciones de los bordes izquierdo y derecho sean relativas a los márgenes:

Esto compensará el borde del banner un poco del borde de la supervista o zona segura, lo que garantizará que tu banner no se oculte en orientación horizontal en el iPhone X. También puedes lograr el resultado deseado de manera programática.

Programática

Si tu app crea anuncios gráficos de forma programática, puedes definir restricciones y posicionar el anuncio gráfico en el código. En este ejemplo (para iOS 7.0 y versiones posteriores), se muestra cómo restringir un banner para que se centre horizontalmente en la parte inferior del área segura:

Swift

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

}

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

Las técnicas anteriores se pueden usar fácilmente para restringir la parte superior del área segura modificando los atributos y los anclajes utilizados.

Anuncios nativos

Si tu app fija anuncios nativos en la parte superior o inferior de la pantalla, se aplican los mismos principios para los anuncios nativos que para los anuncios de banner. La diferencia clave es que, en lugar de agregar restricciones a un GAMBannerView, deberás agregar restricciones a tu GADNativeAppInstallAdView y GADNativeContentAdView (o la vista contenedora del anuncio) para respetar las guías de diseño del área segura. Para las vistas nativas, recomendamos proporcionar limitaciones de tamaño más explícitas.

Anuncios intersticiales y recompensados

El SDK de anuncios de Google para dispositivos móviles renderiza los formatos de anuncios en pantalla completa, incluidos los anuncios intersticiales y recompensados. Se realizará una actualización del SDK de anuncios de Google para dispositivos móviles para garantizar que los elementos del anuncio, como el botón de cierre, se rendericen en el lugar correcto. Actualizaremos las notas de la versión y esta página de documentación cuando este cambio esté disponible.