Anuncios recompensados

Selecciona la plataforma: Android iOS Unity Flutter

Los anuncios recompensados son aquellos con los que los usuarios pueden interactuar a cambio de recompensas en la aplicación. En esta guía, se muestra cómo integrar los anuncios recompensados de AdMob en una app para iOS. Lee algunas historias de éxito de clientes: caso de éxito 1 y caso de éxito 2.

Requisitos previos

Haz siempre una comprobación con anuncios de prueba

Al compilar y verificar tus apps, asegúrate de usar anuncios de prueba en vez de anuncios activos en fase de producción. De lo contrario, se podría suspender tu cuenta.

La forma más sencilla de cargar anuncios de prueba es usar nuestro ID de unidad de anuncios de prueba exclusivo para los anuncios recompensados para iOS:

ca-app-pub-3940256099942544/1712485313

Está configurado especialmente para devolver anuncios de prueba en cada solicitud, y puedes usarlo en tus propias apps durante las tareas de programación, prueba y depuración. Solo asegúrate de reemplazarlo por tu propio ID de unidad de anuncios antes de publicar la app.

Consulta la página Habilita los anuncios de prueba para obtener más información sobre cómo funcionan esos anuncios del SDK de anuncios para dispositivos móviles.

Implementación

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

  • Carga un anuncio.
  • Valida las devoluciones de llamada de SSV (opcional).
  • Regístrate para recibir devoluciones de llamada.
  • Muestra el anuncio y controla el evento de recompensa.

Carga un anuncio

Para cargar un anuncio, puedes utilizar el método load(adUnitID:request) en la clase GADRewardedAd.

Swift

func loadRewardedAd() async {
  do {
    rewardedAd = try await RewardedAd.load(
      // Replace this ad unit ID with your own ad unit ID.
      with: "ca-app-pub-3940256099942544/1712485313", request: Request())
    rewardedAd?.fullScreenContentDelegate = self
  } catch {
    print("Rewarded ad failed to load with error: \(error.localizedDescription)")
  }
}
ViewController.swift

SwiftUI

import GoogleMobileAds

class RewardedViewModel: NSObject, ObservableObject, FullScreenContentDelegate {
  @Published var coins = 0
  private var rewardedAd: RewardedAd?

  func loadAd() async {
    do {
      rewardedAd = try await RewardedAd.load(
        with: "ca-app-pub-3940256099942544/1712485313", request: Request())
      rewardedAd?.fullScreenContentDelegate = self
    } catch {
      print("Failed to load rewarded ad with error: \(error.localizedDescription)")
    }
  }
RewardedViewModel.swift

Objective-C

// Replace this ad unit ID with your own ad unit ID.
[GADRewardedAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"
              request:[GADRequest request]
    completionHandler:^(GADRewardedAd *ad, NSError *error) {
      if (error) {
        NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
        return;
      }
      self.rewardedAd = ad;
      self.rewardedAd.fullScreenContentDelegate = self;
    }];
ViewController.m

Valida las devoluciones de llamada de la verificación 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. Todos los valores de cadena establecidos en un objeto de anuncio recompensado se pasan al parámetro de consulta custom_data de la devolución de llamada de la SSV. Si no se establece ningún valor de datos personalizados, el valor del parámetro de consulta custom_data no estará presente en la devolución de llamada de la SSV.

La siguiente muestra de código indica cómo establecer datos personalizados en un objeto de anuncio recompensado antes de solicitar un anuncio:

Swift

do {
  rewardedAd = try await RewardedAd.load(
    // Replace this ad unit ID with your own ad unit ID.
    with: "ca-app-pub-3940256099942544/1712485313", request: Request())
  let options = ServerSideVerificationOptions()
  options.customRewardText = "SAMPLE_CUSTOM_DATA_STRING"
  rewardedAd?.serverSideVerificationOptions = options
} catch {
  print("Rewarded ad failed to load with error: \(error.localizedDescription)")
}
RewardedAdSnippets.swift

Objective-C

// Replace this ad unit ID with your own ad unit ID.
[GADRewardedAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"
                        request:[GADRequest request]
              completionHandler:^(GADRewardedAd *ad, NSError *error) {
                if (error) {
                  NSLog(@"Rewarded ad failed to load with error: %@", error.localizedDescription);
                  return;
                }
                self.rewardedAd = ad;
                GADServerSideVerificationOptions *options =
                    [[GADServerSideVerificationOptions alloc] init];
                options.customRewardString = @"SAMPLE_CUSTOM_DATA_STRING";
                ad.serverSideVerificationOptions = options;
              }];
RewardedAdSnippets.m

Regístrate para recibir devoluciones de llamada

Para recibir notificaciones de eventos de presentación, debes asignar GADFullScreenContentDelegate to the a la propiedad fullScreenContentDelegate` del anuncio devuelto:

Swift

rewardedAd?.fullScreenContentDelegate = self
ViewController.swift

SwiftUI

rewardedAd?.fullScreenContentDelegate = self
RewardedViewModel.swift

Objective-C

self.rewardedAd.fullScreenContentDelegate = self;
ViewController.m

El protocolo GADFullScreenContentDelegate controla las devoluciones de llamada para cuando el anuncio se presenta correctamente o con errores, y cuando se descarta. En el siguiente código, se muestra cómo implementar el protocolo:

Swift

func adDidRecordImpression(_ ad: FullScreenPresentingAd) {
  print("\(#function) called.")
}

func adDidRecordClick(_ ad: FullScreenPresentingAd) {
  print("\(#function) called.")
}

func adWillPresentFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called.")
}

func adWillDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called.")
}

func adDidDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called.")
  // Clear the rewarded ad.
  rewardedAd = nil
}

func ad(
  _ ad: FullScreenPresentingAd,
  didFailToPresentFullScreenContentWithError error: Error
) {
  print("\(#function) called with error: \(error.localizedDescription).")
}
ViewController.swift

SwiftUI

func adDidRecordImpression(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidRecordClick(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func ad(
  _ ad: FullScreenPresentingAd,
  didFailToPresentFullScreenContentWithError error: Error
) {
  print("\(#function) called")
}

func adWillPresentFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adWillDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("\(#function) called")
  // Clear the rewarded ad.
  rewardedAd = nil
}
RewardedViewModel.swift

Objective-C

- (void)adDidRecordImpression:(id<GADFullScreenPresentingAd>)ad {
  NSLog(@"%s called", __PRETTY_FUNCTION__);
}

- (void)adDidRecordClick:(id<GADFullScreenPresentingAd>)ad {
  NSLog(@"%s called", __PRETTY_FUNCTION__);
}

- (void)adWillPresentFullScreenContent:(id<GADFullScreenPresentingAd>)ad {
  NSLog(@"%s called", __PRETTY_FUNCTION__);
}

- (void)adWillDismissFullScreenContent:(id<GADFullScreenPresentingAd>)ad {
  NSLog(@"%s called", __PRETTY_FUNCTION__);
}

- (void)adDidDismissFullScreenContent:(id<GADFullScreenPresentingAd>)ad {
  NSLog(@"%s called", __PRETTY_FUNCTION__);
  // Clear the rewarded ad.
  self.rewardedAd = nil;
}

- (void)ad:(id)ad didFailToPresentFullScreenContentWithError:(NSError *)error {
  NSLog(@"%s called with error: %@", __PRETTY_FUNCTION__, error.localizedDescription);
}
ViewController.m

Muestra el anuncio y controla el evento de recompensa

Antes de mostrarles a los usuarios un anuncio recompensado, debes darles una opción explícita para que puedan elegir si quieren ver el contenido del anuncio a cambio de la recompensa. Los anuncios recompensados siempre deben ser una experiencia opcional.

Cuando presentes tu anuncio, deberás proporcionar un objeto GADUserDidEarnRewardHandler para controlar la recompensa destinada al usuario.

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

Swift

rewardedAd.present(from: self) {
  let reward = rewardedAd.adReward
  print("Reward received with currency \(reward.amount), amount \(reward.amount.doubleValue)")

  // TODO: Reward the user.
}
ViewController.swift

SwiftUI

Escucha los eventos de la IU en la vista para determinar cuándo mostrar el anuncio.

var body: some View {
  VStack(spacing: 20) {
      Button("Watch video for additional 10 coins") {
        viewModel.showAd()
        showWatchVideoButton = false
      }
RewardedContentView.swift

Presenta el anuncio recompensado desde el modelo de vista:

func showAd() {
  guard let rewardedAd = rewardedAd else {
    return print("Ad wasn't ready.")
  }

  rewardedAd.present(from: nil) {
    let reward = rewardedAd.adReward
    print("Reward amount: \(reward.amount)")
    self.addCoins(reward.amount.intValue)
  }
}
RewardedViewModel.swift

Objective-C

[self.rewardedAd presentFromRootViewController:self
                      userDidEarnRewardHandler:^{
                        GADAdReward *reward = self.rewardedAd.adReward;
                        NSString *rewardMessage = [NSString
                            stringWithFormat:@"Reward received with currency %@ , amount %lf",
                                             reward.type, [reward.amount doubleValue]];
                        NSLog(@"%@", rewardMessage);

                        // TODO: Reward the user.
                      }];
ViewController.m

Preguntas frecuentes

¿Puedo obtener los detalles de la recompensa para GADRewardedAd?
Sí, si necesitas conocer 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 confirmar el importe en cuestión 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 al GADInitializationCompletionHandler proporcionado al método startWithCompletionHandler:, incluso si hay redes de mediación que no completaron 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?

Te recomendamos que cargues un anuncio dentro de GADInitializationCompletionHandler. Aun si una red de mediación no está lista, el SDK de anuncios de Google para dispositivos móviles le solicitará un anuncio. Por lo tanto, si una red de mediación termina de inicializarse después de transcurrido el tiempo de espera, igualmente podrá procesar solicitudes de anuncios futuras durante esa sesión.

Si llamas a GADMobileAds.initializationStatus, puedes seguir sondeando el estado de inicialización de todos los adaptadores durante la sesión de tu app.

¿Cómo se puede saber por qué una red de mediación en particular no está lista?

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

¿Siempre se llama al controlador de finalización userDidEarnRewardHandler antes del método delegado adDidDismissFullScreenContent:?

En el caso de los anuncios de Google, todas las llamadas al userDidEarnRewardHandler se producen antes de adDidDismissFullScreenContent:. En cambio, para los anuncios publicados a través de la mediación, la implementación del SDK de la red de publicidad externa determina el orden de las devoluciones de llamada. En lo que respecta a los SDKs de las redes de publicidad que proporcionan un solo método delegado con información de recompensa, el adaptador de mediación invoca al userDidEarnRewardHandler antes de adDidDismissFullScreenContent:.

Ejemplos en GitHub

Consulta los ejemplos completos de anuncios recompensados en el lenguaje que prefieras:

Próximos pasos

Obtén más información sobre la privacidad del usuario.