Anuncios nativos

Punto clave: Obtén más información sobre los anuncios nativos en nuestra guía de anuncios nativos. Las muestras están disponibles para Swift y Objective‐C. También puedes ver algunas historias de éxito del cliente: caso de éxito 1, caso de éxito 2.

Los anuncios nativos son elementos de anuncios que se presentan a los usuarios a través de componentes de la IU nativos de la plataforma. Se muestran con las mismas clases que ya usas en tus storyboards y se puede formatear a fin de que coincidan con el diseño visual de tu app. Cuando se carga un anuncio nativo, tu app recibe un objeto de anuncio que contiene sus elementos, y la app (en lugar del SDK) es responsable de mostrarlos. Esto difiere de otros formatos de anuncios, que no te permiten personalizar su aspecto.

En esta guía, se mostrará cómo usar el SDK de anuncios de Google para dispositivos móviles a fin de implementar anuncios nativos en una app para iOS y algunos aspectos importantes que debes considerar durante el proceso.

En términos generales, existen dos partes para implementar correctamente los anuncios nativos: cargar un anuncio a través del SDK y mostrar el contenido del anuncio en tu app. En esta página, se analiza la carga de anuncios mediante el SDK.

Si ya cargaste anuncios nativos correctamente y solo necesitas saber cómo mostrarlos, no dudes en omitir nuestras guías de Plantillas nativas o Nativas avanzadas.

Prerequisites

• Importa el SDK de anuncios de Google para dispositivos móviles ya mismo o como parte de Firebase.

Probar siempre con anuncios de prueba

Antes de comenzar, recuerda que, cuando compiles y pruebes tus apps, debes asegurarte de usar anuncios de prueba en lugar de anuncios de producción publicados. Realizar pruebas con los anuncios de producción podría ocasionar la suspensión de su cuenta.

La forma más fácil de cargar anuncios de prueba es usar nuestro ID de bloque de anuncios de prueba dedicado para todos los anuncios nativos avanzados en iOS:

ca-app-pub-3940256099942544/3986624511

Se configuró especialmente para mostrar anuncios de prueba en cada solicitud, y puedes usarlo en tus propias apps durante la codificación, las pruebas y la depuración. Asegúrate de reemplazarlo con tu propio ID de bloque de anuncios antes de publicar la app.

Para obtener más información sobre cómo funcionan los anuncios de prueba del SDK de anuncios para dispositivos móviles, consulta Anuncios de prueba.

Cargando anuncios

Los anuncios nativos se cargan a través de objetos GADAdLoader, que envían mensajes a sus delegados de acuerdo con el protocolo GADAdLoaderDelegate.

Cómo inicializar el cargador de anuncios

Antes de que pueda cargar un anuncio, debe inicializar el cargador de anuncios. En el siguiente código, se muestra cómo inicializar un GADAdLoader:

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective‑C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

Necesitarás un ID de bloque de anuncios (puedes usar el ID de prueba), constantes para pasar el arreglo adTypes a fin de especificar qué formatos nativos deseas solicitar y cualquier opción que desees configurar en el parámetro options. La lista de posibles valores para el parámetro options se encuentra en la página Configuración de opciones de anuncios nativos.

El array adTypes debe contener esta constante:

• GADAdLoaderAdTypeNative

Cómo implementar el delegado del cargador de anuncios

El delegado del cargador de anuncios debe implementar protocolos específicos para su tipo de anuncio. En el caso de los anuncios nativos, ocurre lo siguiente:

• GADNativeAdLoaderDelegate Este protocolo incluye un mensaje que se envía al delegado cuando se carga un anuncio nativo:

  Swift

  public func adLoader(_ adLoader: GADAdLoader,
      didReceive nativeAd: GADNativeAd)
  

  Objective‑C

  - (void)adLoader:(GADAdLoader *)adLoader
      didReceiveNativeAd:(GADNativeAd *)nativeAd;
  

Solicitar el anuncio

Una vez que se inicialice GADAdLoader, llama al método loadRequest: para solicitar un anuncio:

Swift

adLoader.load(GADRequest())

Objective‑C

[self.adLoader loadRequest:[GADRequest request]];

El método loadRequest: de GADAdLoader acepta los mismos objetos GADRequest que los anuncios intersticiales y de banner. Puedes usar objetos de solicitud a fin de agregar información de segmentación, tal como lo harías con otros tipos de anuncios.

Cuándo solicitar anuncios

Las apps que muestran anuncios nativos pueden solicitarlas con anticipación a cuándo se mostrarán. En muchos casos, esta es la práctica recomendada. Por ejemplo, una app que muestra una lista de elementos con anuncios nativos mezclados puede cargar anuncios nativos para toda la lista, ya que algunos se mostrarán solo después de que el usuario se desplace por la vista y otros no se muestren.

Si bien la solicitud previa de anuncios es una técnica excelente, es importante que no conserves anuncios antiguos de manera indefinida sin mostrarlos. Cualquier objeto de anuncio nativo que se haya retenido sin mostrar durante más de una hora debe descartarse y reemplazarse por los anuncios nuevos de una solicitud nueva.

Nota: Cuando vuelvas a usar un GADAdLoader, asegúrate de esperar a que se complete cada solicitud antes de volver a llamar a loadRequest:.

Cómo determinar cuándo finalizó la carga

Después de que una app llama a loadRequest:, puede obtener los resultados de la solicitud a través de llamadas a:

• adLoader:didFailToReceiveAdWithError: en GADAdLoaderDelegate
• adLoader:didReceiveNativeAd: en GADNativeAdLoaderDelegate

Una solicitud de un solo anuncio dará como resultado una llamada a uno de esos métodos.

Una solicitud de varios anuncios generará, al menos, una devolución de llamada en los métodos anteriores, pero no la cantidad máxima de anuncios solicitados.

Nota: Por el momento, las solicitudes de varios anuncios nativos no funcionan para los ID de bloque de anuncios de AdMob que se configuraron para la mediación. Los publicadores que usan mediación deben evitar usar la clase GADMultipleAdsAdLoaderOptions cuando realicen solicitudes.

Además, GADAdLoaderDelegate ofrece la devolución de llamada adLoaderDidFinishLoading. Este método delegado indica que un cargador de anuncios terminó de cargar anuncios y no se informará ningún otro anuncio o error para la solicitud. A continuación, se muestra un ejemplo de cómo usarla cuando se cargan varios anuncios nativos a la vez:

Swift

class ViewController: UIViewController, GADNativeAdLoaderDelegate {

  var adLoader: GADAdLoader!

  override func viewDidLoad() {
    super.viewDidLoad()

    let multipleAdsOptions = GADMultipleAdsAdLoaderOptions()
    multipleAdsOptions.numberOfAds = 5

    adLoader = GADAdLoader(adUnitID: YOUR_AD_UNIT_ID, rootViewController: self,
        adTypes: [.native],
        options: [multipleAdsOptions])
    adLoader.delegate = self
    adLoader.load(GADRequest())
  }

  func adLoader(_ adLoader: GADAdLoader,
                didReceive nativeAd: GADNativeAd) {
    // A native ad has loaded, and can be displayed.
  }

  func adLoaderDidFinishLoading(_ adLoader: GADAdLoader) {
      // The adLoader has finished loading ads, and a new request can be sent.
  }

}

Objective‑C

@interface ViewController () <GADNativeAdLoaderDelegate, GADVideoControllerDelegate>
@property(nonatomic, strong) GADAdLoader *adLoader;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
      [[GADMultipleAdsAdLoaderOptions alloc] init];
  multipleAdsOptions.numberOfAds = 5;

  self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:YOUR_AD_UNIT_ID
          rootViewController:self
                     adTypes:@[GADAdLoaderAdTypeNative]
                     options:@[multipleAdsOptions]];
  self.adLoader.delegate = self;
  [self.adLoader loadRequest:[GADRequest request]];
}

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd {
   // A native ad has loaded, and can be displayed.
}

- (void)adLoaderDidFinishLoading:(GADAdLoader *) adLoader {
  // The adLoader has finished loading ads, and a new request can be sent.
}

@end

Cómo controlar solicitudes fallidas

Los protocolos anteriores extienden el protocolo GADAdLoaderDelegate, que define un mensaje enviado cuando no se cargan los anuncios.

Swift

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

Objective‑C

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

Advertencia: No te recomendamos que intentes cargar un anuncio nuevo desde el método delegado adLoader:didFailToReceiveAdWithError:. Si debes cargar un anuncio desde adLoader:didFailToReceiveAdWithError:, limita los reintentos de carga de anuncios para evitar solicitudes de anuncios con errores continuos en situaciones como una conectividad de red limitada.

Cómo recibir notificaciones sobre eventos de anuncios nativos

Si desea recibir notificaciones sobre eventos relacionados con las interacciones con anuncios nativos, configure la propiedad delegada del anuncio nativo:

Swift

nativeAd.delegate = self

Objective‑C

nativeAd.delegate = self;

Luego, implementa GADNativeAdDelegate para recibir las siguientes llamadas de delegado:

Swift

func nativeAdDidRecordImpression(_ nativeAd: GADNativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: GADNativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: GADNativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) {
  // The native ad will cause the application to become inactive and
  // open a new application.
}

Objective‑C

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the application to become inactive and
  // open a new application.
}

Muestre su anuncio

Una vez que haya cargado un anuncio, solo falta mostrarlo a los usuarios. Consulta nuestra guía de anuncios nativos avanzados para ver cómo hacerlo.