Anuncios recompensados

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 Manager en una app para iOS.

Requisitos previos

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

Siempre realiza pruebas con anuncios de prueba

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

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

/21775744923/example/rewarded

Se configuró de forma especial para mostrar anuncios de prueba para cada solicitud, y puedes usarlo en tus propias apps mientras codificas, pruebas y depuras. Solo asegúrate de reemplazarlo por tu propio ID de unidad 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.

Implementación

Los pasos principales para integrar 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 administra el evento de recompensa

Carga un anuncio

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

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  private var rewardedAd: GADRewardedAd?

  func loadRewardedAd() async {
    do {
      rewardedAd = try await GADRewardedAd.load(
        withAdUnitID: "/21775744923/example/rewarded", request: GAMRequest())
    } catch {
      print("Rewarded ad failed to load with error: \(error.localizedDescription)")
    }
  }
}

SwiftUI

import GoogleMobileAds

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

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

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController
- (void)loadRewardedAd {
  GAMRequest *request = [GAMRequest request];
  [GADRewardedAd
      loadWithAdUnitID:@"/21775744923/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 de la verificación del servidor (SSV) [opcional].

Las apps que requieren datos adicionales en las devoluciones de llamada de verificación del servidor deben usar la función de datos personalizados de los anuncios recompensados. Cualquier valor de cadena establecido en un objeto de anuncio recompensado se pasa al parámetro de consulta custom_data de la devolución de llamada de 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 SSV.

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

Swift

do {
  rewardedAd = try await GADRewardedAd.load(
    withAdUnitID: "/21775744923/example/rewarded", request: GAMRequest())
  let options = GADServerSideVerificationOptions()
  options.customRewardString = "SAMPLE_CUSTOM_DATA_STRING"
  rewardedAd.serverSideVerificationOptions = options
} catch {
  print("Rewarded ad failed to load with error: \(error.localizedDescription)")
}

Objective-C

[GADRewardedAd
     loadWithAdUnitID:@"/21775744923/example/rewarded"
              request:[GAMRequest request];
    completionHandler:^(GADRewardedAd *ad, NSError *error) {
      if (error) {
        // Handle Error
        return;
      }
      self.rewardedAd = 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 para cuando el anuncio se presenta correctamente o de forma incorrecta, y cuando se descarta. En el siguiente código, se muestra cómo implementar el protocolo y asignarlo al anuncio:

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADFullScreenContentDelegate {

  private var rewardedAd: GADRewardedAd?

  func loadRewardedAd() async {
    do {
      rewardedAd = try await GADRewardedAd.load(
        withAdUnitID: "/21775744923/example/rewarded", request: GAMRequest())
      rewardedAd?.fullScreenContentDelegate = self
    } catch {
      print("Rewarded ad failed to load with error: \(error.localizedDescription)")
    }
  }

  /// 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.")
  }
}

SwiftUI

Asigna la propiedad fullScreenContentDelegate al anuncio que se muestra:

rewardedAd?.fullScreenContentDelegate = self
RewardedViewModel.swift

Implementa el protocolo:

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

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

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

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

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

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

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 siguiente anuncio recompensado comience a cargarse en cuanto se cierre el anterior.

Muestra el anuncio y administra el evento de recompensa

Antes de mostrar un anuncio recompensado a los usuarios, debes presentarles una opción explícita para ver el contenido del anuncio recompensado a cambio de una recompensa. Los anuncios recompensados siempre deben ser una experiencia con solicitud de aceptación.

Cuando presentes tu anuncio, debes proporcionar un objeto GADUserDidEarnRewardHandler para controlar la recompensa del usuario.

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

Swift

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

  // The UIViewController parameter is an optional.
  ad.present(fromRootViewController: nil) {
    let reward = ad.adReward
    print("Reward received with currency \(reward.amount), amount \(reward.amount.doubleValue)")
    // TODO: Reward the user.
  }
}

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(fromRootViewController: nil) {
    let reward = rewardedAd.adReward
    print("Reward amount: \(reward.amount)")
    self.addCoins(reward.amount.intValue)
  }
}
RewardedViewModel.swift

Objective-C

- (void)show {
  if (self.rewardedAd) {
    // The UIViewController parameter is nullable.
    [self.rewardedAd presentFromRootViewController:nil
                                  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 de userDidEarnReward, GADRewardedAd tiene una propiedad adReward que puedes consultar para verificar el importe de la recompensa 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?

Te recomendamos cargar un anuncio dentro de GADInitializationCompletionHandler. Incluso si una red de mediación no está lista, el SDK de anuncios de Google para dispositivos móviles le sigue pidiendo un anuncio a esa red. Por lo tanto, si una red de mediación termina de inicializarse después del tiempo de espera, aún puede entregar solicitudes de anuncios futuras en esa sesión.

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

¿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.

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

En el caso de los anuncios de Google, todas las llamadas de userDidEarnRewardHandler ocurren antes del adDidDismissFullScreenContent:. En el caso de los anuncios publicados a través de la mediación, la implementación del SDK de la red de publicidad de terceros determina el orden de devolución de llamada. En el caso de los SDKs de redes de publicidad que proporcionan un solo método delegado con información de recompensas, el adaptador de mediación invoca a userDidEarnRewardHandler antes de adDidDismissFullScreenContent:.

Ejemplos en GitHub

Mira los ejemplos completos de anuncios recompensados en tu idioma preferido:

Próximos pasos

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