Anuncios recompensados

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Los anuncios recompensados son aquellos con los que los usuarios pueden interactuar a cambio de recompensas en la app. En esta guía, se muestra cómo integrar anuncios recompensados de Ad Manageren una aplicación para iOS.

Requisitos previos

  • SDK de anuncios de Google para dispositivos móviles 8.0.0 o versiones posteriores.
  • Complete la Guía de introducción.

Probar siempre con anuncios de prueba

Cuando compiles y pruebes tus apps, asegúrate de usar anuncios de prueba en lugar de anuncios de producción publicados. De lo contrario, podría suspenderse tu cuenta.

La forma más fácil de cargar anuncios de prueba es usar nuestro ID de bloque de anuncios de prueba dedicado para anuncios recompensados de iOS:

/6499/example/rewarded

Se configuró especialmente para mostrar anuncios de prueba en cada solicitud y puedes usarlo en tus propias aplicaciones mientras codificas, pruebas y depuras. Solo asegúrate de reemplazarlo con tu propio ID de bloque de anuncios antes de publicar tu app.

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

Implementación

Los pasos principales para integrar anuncios intersticiales recompensados son los siguientes:

  • Cargar un anuncio
  • Valida la devolución de llamada de SSV (opcional)
  • Regístrate para recibir devoluciones de llamada
  • Cómo mostrar el anuncio y administrar el evento de recompensa

Cargar un anuncio

Para cargar un anuncio, debes usar el método estático loadWithAdUnitID:request:completionHandler: en la clase GADRewardedAd. El método de carga requiere el ID de tu bloque de anuncios, un objeto GAMRequest y un controlador de finalización al que se llama cuando la carga de anuncios se realiza correctamente o falla. El objeto GADRewardedAd cargado se proporciona como parámetro en el controlador de finalización. En el siguiente ejemplo, se muestra cómo cargar un GADRewardedAd en la clase ViewController.

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  private var rewardedAd: GADRewardedAd?

  func loadRewardedAd() {
    let request = GAMRequest()
    GADRewardedAd.load(withAdUnitID:"/6499/example/rewarded",
                       request: request,
                       completionHandler: { [self] ad, error in
      if let error = error {
        print("Failed to load rewarded ad with error: \(error.localizedDescription)")
        return
      }
      rewardedAd = ad
      print("Rewarded ad loaded.")
    }
    )
  }
}

Objective‑C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController
- (void)loadRewardedAd {
  GAMRequest *request = [GAMRequest request];
  [GADRewardedAd
       loadWithAdUnitID:@"/6499/example/rewarded"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        NSLog(@"Rewarded ad loaded.");
      }];
}

Valida las devoluciones de llamada del servidor (SSV) (opcional)

Las apps que requieren datos adicionales en las devoluciones de llamada de la verificación del servidor deben usar la función de datos personalizados de los anuncios recompensados. Cualquier valor de string establecido en un objeto de anuncio recompensado se pasa al parámetro de búsqueda custom_data de la devolución de llamada SSV. Si no se establece ningún valor de datos personalizado, el valor del parámetro de búsqueda custom_data no estará presente en la devolución de llamada SSV.

En la siguiente muestra de código, se indica cómo configurar datos personalizados en un objeto de anuncio recompensado antes de solicitar un anuncio.

Swift

GADRewardedInterstitialAd.load(withAdUnitID:"/6499/example/rewarded",
                       request: request,
                       completionHandler: { [self] ad, error in
      if let error != error {
      rewardedInterstitialAd = ad
      let options = GADServerSideVerificationOptions()
      options.customRewardString = "SAMPLE_CUSTOM_DATA_STRING"
      rewardedInterstitialAd.serverSideVerificationOptions = options
    }

Objective‑C

GAMRequest *request = [GAMRequest request];
[GADRewardedInterstitialAd
     loadWithAdUnitID:@"/6499/example/rewarded"
              request:request
    completionHandler:^(GADRewardedInterstitialAd *ad, NSError *error) {
      if (error) {
        // Handle Error
        return;
      }
      self.rewardedInterstitialAd = ad;
      GADServerSideVerificationOptions *options =
          [[GADServerSideVerificationOptions alloc] init];
      options.customRewardString = @"SAMPLE_CUSTOM_DATA_STRING";
      ad.serverSideVerificationOptions = options;
    }];

Regístrate para recibir devoluciones de llamada

Para recibir notificaciones de eventos de presentación, debes implementar el protocolo GADFullScreenContentDelegate y asignarlo a la propiedad fullScreenContentDelegate del anuncio que se muestra. El protocolo GADFullScreenContentDelegate controla las devoluciones de llamada cuando el anuncio se presenta de forma correcta o no, y cuando se descarta. El siguiente código muestra cómo implementar el protocolo y asignarlo al anuncio:

Swift

class ViewController: UIViewController, GADFullScreenContentDelegate {

  private var rewardedAd: GADRewardedAd?

  func loadRewardedAd() {
    let request = GAMRequest()
    GADRewarded.load(withAdUnitID:"/6499/example/rewarded",
                     request: request,
                     completionHandler: { [self] ad, error in
      if let error = error {
        print("Failed to load rewarded ad with error: \(error.localizedDescription)")
        return
      }
      rewardedAd = ad
      print("Rewarded ad loaded.")
      rewardedAd?.fullScreenContentDelegate = self
    }
    )
  }

  /// Tells the delegate that the ad failed to present full screen content.
  func ad(_ ad: GADFullScreenPresentingAd, didFailToPresentFullScreenContentWithError error: Error) {
    print("Ad did fail to present full screen content.")
  }

  /// Tells the delegate that the ad will present full screen content.
  func adWillPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
    print("Ad will present full screen content.")
  }

  /// Tells the delegate that the ad dismissed full screen content.
  func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
    print("Ad did dismiss full screen content.")
  }
}

Objective‑C

@interface ViewController ()<GADFullScreenContentDelegate>

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController
- (void)loadRewardedAd {
  GAMRequest *request = [GAMRequest request];
  [GADRewardedAd
       loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        NSLog(@"Rewarded ad loaded.");
        self.rewardedAd.fullScreenContentDelegate = self;
      }];
}

/// Tells the delegate that the ad failed to present full screen content.
- (void)ad:(nonnull id<GADFullScreenPresentingAd>)ad
    didFailToPresentFullScreenContentWithError:(nonnull NSError *)error {
    NSLog(@"Ad did fail to present full screen content.");
}

/// Tells the delegate that the ad will present full screen content.
- (void)adWillPresentFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
    NSLog(@"Ad will present full screen content.");
}

/// Tells the delegate that the ad dismissed full screen content.
- (void)adDidDismissFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
    NSLog(@"Ad did dismiss full screen content.");
}

GADRewardedAd es un objeto de uso único. Esto significa que, una vez que se muestra un anuncio recompensado, no se puede volver a mostrar. Una práctica recomendada es cargar otro anuncio recompensado en el método adDidDismissFullScreenContent: en GADFullScreenContentDelegate para que el próximo anuncio recompensado comience a cargarse apenas se descarte el anterior.

Cómo mostrar el anuncio y administrar el evento de recompensa

Antes de mostrar un anuncio recompensado a los usuarios, debes ofrecerles una opción explícita para que vean el contenido del anuncio recompensado a cambio de una recompensa. Los anuncios recompensados siempre deben ser una experiencia de participación.

Cuando presentas tu anuncio, debes proporcionar un objeto GADUserDidEarnRewardHandler para administrar la recompensa del usuario.

El siguiente código presenta el mejor método para mostrar un anuncio recompensado.

Swift

func show() {
  if let ad = rewardedAd {
    ad.present(fromRootViewController: self) {
      let reward = ad.adReward
      print("Reward received with currency \(reward.amount), amount \(reward.amount.doubleValue)")
      // TODO: Reward the user.
    }
  } else {
    print("Ad wasn't ready")
  }
}

Objective‑C

- (void)show {
  ...
  if (self.rewardedAd) {
    [self.rewardedAd presentFromRootViewController:self
                                  userDidEarnRewardHandler:^{
                                  GADAdReward *reward =
                                      self.rewardedAd.adReward;
                                  // TODO: Reward the user!
                                }];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

Preguntas frecuentes

¿Puedo obtener los detalles de la recompensa de GADRewardedAd?
Sí, si necesitas el importe de la recompensa antes de que se active la devolución de llamada userDidEarnReward, GADRewardedAd tiene una propiedad adReward que puedes verificar para verificar el importe después de que se cargue el anuncio.
¿Hay un tiempo de espera para la llamada de inicialización?
Después de 10 segundos, el SDK de anuncios de Google para dispositivos móviles invoca el GADInitializationCompletionHandler proporcionado al método startWithCompletionHandler:, incluso si una red de mediación aún no completó la inicialización.
¿Qué sucede si algunas redes de mediación no están listas cuando recibo la devolución de llamada de inicialización?

Recomendamos cargar un anuncio dentro de la GADInitializationCompletionHandler. Incluso si una red de mediación no está lista, el SDK de los anuncios móviles de Google seguirá pidiendo un anuncio a esa red. Por lo tanto, si una red de mediación termina de inicializarse después del tiempo de espera, puede procesar solicitudes de anuncios futuras en esa sesión.

Puedes continuar consultando el estado de inicialización de todos los adaptadores durante la sesión de tu app llamando a GADMobileAds.initializationStatus.

¿Cómo puedo averiguar por qué una red de mediación específica no está lista?

La propiedad description de un objeto GADAdapterStatus describe por qué un adaptador no está listo para entregar solicitudes de anuncios.

¿El controlador de finalización userDidEarnRewardHandler siempre se llama antes que el método de delegado adDidDismissFullScreenContent:?

En el caso de los anuncios de Google, todas las llamadas de userDidEarnRewardHandler se realizan antes del adDidDismissFullScreenContent:. En el caso de los anuncios que se publican mediante la mediación, la implementación del SDK de la red de publicidad de terceros determina el orden de la devolución de llamada. Para los SDK de redes de publicidad que proporcionan un solo método delegado con información de recompensa, el adaptador de mediación invoca a userDidEarnRewardHandler antes de adDidDismissFullScreenContent:.

Ejemplos en GitHub