Los anuncios recompensados son aquellos con los que los usuarios pueden interactuar a cambio para obtener recompensas en la app. Esta guía se muestra cómo integrar anuncios recompensados desde Ad Manager. en una aplicación de iOS.
Requisitos previos
- SDK de anuncios de Google para dispositivos móviles versión 8.0.0 o posterior.
- Completa 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 activos y en producción. De lo contrario, podría suspenderse tu cuenta.
La forma más sencilla de cargar anuncios de prueba es usar nuestro ID de unidad de anuncios de prueba exclusivo para iOS Anuncios recompensados:
/21775744923/example/rewarded
Se configuró de forma especial para mostrar anuncios de prueba para cada solicitud, y ahora usarla en tus propias apps mientras codificas, pruebas y depuras. Solo haz asegúrate de reemplazarla con tu propio ID de unidad 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 para dispositivos móviles, consulta el artículo Anuncios.
Implementación
Los pasos principales para integrar anuncios recompensados son los siguientes:
- Carga un anuncio
- Valida las devoluciones de llamada de SSV (opcional)
- Cómo registrarse para recibir devoluciones de llamada
- Muestra el anuncio y administra el evento de recompensa
Carga un anuncio
La carga de un anuncio se realiza mediante 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)")
}
}
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].
Aplicaciones que requieren datos adicionales en el servidor
de verificación deben usar el
función de datos personalizados de los anuncios recompensados. Cualquier valor de cadena establecido en un anuncio recompensado
el objeto se pasa al parámetro de consulta custom_data
de la devolución de llamada de SSV. Si la respuesta es no
se configura un valor de datos personalizado, el valor del parámetro de consulta custom_data
no será
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 anuncio recompensado. objeto 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;
}];
Cómo registrarse para recibir devoluciones de llamada
Para recibir notificaciones sobre eventos de presentación, debes implementar
el protocolo GADFullScreenContentDelegate
y asígnalo al
La propiedad fullScreenContentDelegate
del anuncio que se muestra. El
El protocolo GADFullScreenContentDelegate
controla las devoluciones de llamada cuando se muestra el anuncio.
presenta con éxito o sin éxito, y cuando se descarta. Lo siguiente
código 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
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
}
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 un solo uso. Esto significa que, una vez que un anuncio recompensado
se muestra, 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 muestre el anterior
descartada.
Muestra el anuncio y administra el evento de recompensa
Antes de mostrar un anuncio recompensado a los usuarios, debes entregarles opción explícita de ver el contenido de un anuncio recompensado a cambio de una recompensa. Anuncio recompensado los anuncios deben ser siempre una experiencia optativa.
Cuando presentes tu anuncio, debes proporcionar un objeto GADUserDidEarnRewardHandler
para procesar la recompensa para el usuario.
El siguiente código 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 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
}
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)
}
}
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 para
GADRewardedAd
? - Sí, si necesitas el importe de la recompensa antes de la devolución de llamada de
userDidEarnReward
se activó,GADRewardedAd
tiene unadReward
propiedad que puedes consultar 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
Se proporcionó un valor de
GADInitializationCompletionHandler
a lastartWithCompletionHandler:
, incluso si una red de mediación todavía no ha y completar 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 del
GADInitializationCompletionHandler
Incluso si una red de mediación no está lista, el SDK de anuncios de Google para dispositivos móviles sigue pidiendo un anuncio a esa red. Entonces, si un red de mediación termina de inicializarse tras el tiempo de espera, puede seguir prestando servicio futuras solicitudes de anuncios en esa sesión.Puedes seguir consultando el estado de inicialización de todos los adaptadores en todo 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 objetoGADAdapterStatus
describe por qué un el adaptador no está listo para atender las solicitudes de anuncios.- ¿Siempre se llama al controlador de finalización
userDidEarnRewardHandler
antes del método de delegadoadDidDismissFullScreenContent:
? En el caso de los anuncios de Google, se realizan todas las llamadas (
userDidEarnRewardHandler
) antes deladDidDismissFullScreenContent:
. En el caso de los anuncios publicados a través de mediación, la red de publicidad externa La implementación del SDK determina el orden de la devolución de llamada. Para los SDKs de redes de publicidad proporcionan un método de delegado único con información de recompensa, el adaptador de mediación InvocauserDidEarnRewardHandler
antes deadDidDismissFullScreenContent:
.
Ejemplos en GitHub
Mira los ejemplos completos de anuncios recompensados en tu idioma preferido:
Próximos pasos
Obtenga más información sobre la privacidad del usuario.