Los anuncios recompensados son anuncios con los que los usuarios pueden interactuar a cambio de recompensas en la app. 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, Caso de éxito 2.
Requisitos previos
- SDK de anuncios de Google para dispositivos móviles 8.0.0 o versiones posteriores.
- Completar la Guía de introducción
Realice pruebas 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 unidades de anuncios de prueba dedicado para los anuncios recompensados de iOS:
ca-app-pub-3940256099942544/1712485313
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 reemplazarla con 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 Mobile Ads, consulta Anuncios de prueba.
Implementación
Los pasos principales para integrar anuncios intersticiales recompensados son los siguientes:
- Carga un anuncio
- Valida las devoluciones de llamada de SSV (opcional)
- Regístrate para recibir devoluciones de llamada
- Cómo mostrar el anuncio y controlar el evento de recompensa
Carga un anuncio
Se logra una carga de anuncios con el método estático loadWithAdUnitID:request:completionHandler:
en la clase GADRewardedAd
. El método de carga requiere tu ID de unidad de anuncios, un objeto GADRequest
y un controlador de finalización 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 tu clase ViewController
.
Swift
import GoogleMobileAds import UIKit class ViewController: UIViewController { private var rewardedAd: GADRewardedAd? func loadRewardedAd() { let request = GADRequest() GADRewardedAd.load(withAdUnitID:"ca-app-pub-3940256099942544/1712485313", 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 { GADRequest *request = [GADRequest request]; [GADRewardedAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313" 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 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 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 configura ningún valor de datos personalizados, el valor del parámetro de búsqueda custom_data
no estará presente en la devolución de llamada de 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:"ca-app-pub-3940256099942544/1712485313", 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
GADRequest *request = [GADRequest request]; [GADRewardedInterstitialAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313" 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 = GADRequest() GADRewarded.load(withAdUnitID:"ca-app-pub-3940256099942544/1712485313", 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 { GADRequest *request = [GADRequest 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
con el método adDidDismissFullScreenContent:
en GADFullScreenContentDelegate
para que el siguiente anuncio recompensado comience a cargarse apenas se descarte el anterior.
Cómo mostrar el anuncio y controlar el evento de recompensa
Antes de mostrarles 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.
Al presentar tu anuncio, debes proporcionar un objeto GADUserDidEarnRewardHandler
para administrar la recompensa para el 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 las recompensas de
GADRewardedAd
? - Sí, si necesitas el importe de la recompensa antes de que se active la devolución de llamada
userDidEarnReward
,GADRewardedAd
tiene una propiedadadReward
que puedes verificar para verificar el importe de la recompensa después de que se carga 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étodostartWithCompletionHandler:
, incluso si una red de mediación aún no completa 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
GADInitializationCompletionHandler
. Incluso si una red de mediación no está lista, el SDK de anuncios de Google para dispositivos móviles aún solicita un anuncio en esa red. Por lo tanto, si una red de mediación termina de inicializarse después del tiempo de espera, puede atender las solicitudes de anuncios futuras en esa sesión.Puedes llamar al objeto
GADMobileAds.initializationStatus
para sondear 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 objetoGADAdapterStatus
describe por qué un adaptador no está listo para atender solicitudes de anuncios.- ¿El controlador de finalización de
userDidEarnRewardHandler
siempre se llama antes que el método de delegadoadDidDismissFullScreenContent:
? En el caso de los anuncios de Google, todas las llamadas a
userDidEarnRewardHandler
se realizan antes deladDidDismissFullScreenContent:
. 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 devolución de llamada. En el caso de los SDK de redes de publicidad que proporcionan un solo método delegado con información de recompensa, el adaptador de mediación invoca auserDidEarnRewardHandler
antes deadDidDismissFullScreenContent:
.
Ejemplos en GitHub
- Ejemplo de anuncios recompensados: Swift | Objective-C
Próximos pasos
Obtén más información sobre la privacidad del usuario.