Anuncios recompensados

Selecciona la plataforma: Android iOS Unity Flutter

Los anuncios recompensados te permiten recompensar a los usuarios con elementos integrados en una app cuando interactúan con encuestas, anuncios con juegos y anuncios de video.

Requisitos previos

• SDK de anuncios de Google para dispositivos móviles 19.7.0 o una versión posterior
• Completar la guía de introducción

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, tu cuenta podría suspenderse.

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 en Android:

ca-app-pub-3940256099942544/5224354917

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

Para obtener más información sobre el funcionamiento de los anuncios de prueba del SDK de anuncios de Google para dispositivos móviles, consulta la sección sobre anuncios de prueba.

Carga un objeto de anuncio recompensado

Nota: Realiza todas las llamadas al SDK de anuncios para dispositivos móviles en el subproceso principal.

Los anuncios recompensados se cargan llamando al método load() estático en la clase RewardedAd y pasando una clase RewardedAdLoadCallback. En general, esto se realiza en el método onCreate() de una clase Activity. Ten en cuenta que, al igual que otras devoluciones de llamada de carga de formatos, RewardedAdLoadCallback utiliza LoadAdError para proporcionar detalles de error con mayor fidelidad.

Java

RewardedAd.load(
    this,
    "AD_UNIT_ID",
    new AdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
        Log.d(TAG, "Ad was loaded.");
        MainActivity.this.rewardedAd = rewardedAd;
      }

      @Override
      public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
        Log.d(TAG, loadAdError.getMessage());
        rewardedAd = null;
      }
    });
MainActivity.java

Kotlin

RewardedAd.load(
  this,
  "AD_UNIT_ID",
  AdRequest.Builder().build(),
  object : RewardedAdLoadCallback() {
    override fun onAdLoaded(ad: RewardedAd) {
      Log.d(TAG, "Ad was loaded.")
      rewardedAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      Log.d(TAG, adError.message)
      rewardedAd = null
    }
  },
)
MainActivity.kt

Reemplaza AD_UNIT_ID por tu ID de unidad de anuncios.

Nota: Para que los anuncios se puedan mostrar con una latencia nula si es necesario, puedes usar llamadas de carga de anuncios para crear una caché de anuncios precargados antes del momento en el que quieras mostrarlos. Dado que los anuncios vencen después de una hora, deberías borrar esa caché y volver a cargarla con anuncios nuevos cada hora.

Establece el objeto FullScreenContentCallback

El objeto FullScreenContentCallback procesa los eventos relacionados con la visualización de tu RewardedAd. Antes de mostrar tu RewardedAd, asegúrate de configurar la devolución de llamada de esta manera:

Java

rewardedAd.setFullScreenContentCallback(
    new FullScreenContentCallback() {
      @Override
      public void onAdDismissedFullScreenContent() {
        // Called when fullscreen content is dismissed.
        Log.d(TAG, "Ad was dismissed.");
        // Don't forget to set the ad reference to null so you
        // don't show the ad a second time.
        rewardedAd = null;
      }

      @Override
      public void onAdFailedToShowFullScreenContent(AdError adError) {
        // Called when fullscreen content failed to show.
        Log.d(TAG, "Ad failed to show.");
        // Don't forget to set the ad reference to null so you
        // don't show the ad a second time.
        rewardedAd = null;
      }

      @Override
      public void onAdShowedFullScreenContent() {
        // Called when fullscreen content is shown.
        Log.d(TAG, "Ad showed fullscreen content.");
      }

      @Override
      public void onAdImpression() {
        // Called when an impression is recorded for an ad.
        Log.d(TAG, "Ad recorded an impression.");
      }

      @Override
      public void onAdClicked() {
        // Called when an ad is clicked.
        Log.d(TAG, "Ad was clicked.");
      }
    });
MainActivity.java

Kotlin

rewardedAd?.fullScreenContentCallback =
  object : FullScreenContentCallback() {
    override fun onAdDismissedFullScreenContent() {
      // Called when fullscreen content is dismissed.
      Log.d(TAG, "Ad was dismissed.")
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      rewardedAd = null
    }

    override fun onAdFailedToShowFullScreenContent(adError: AdError) {
      // Called when fullscreen content failed to show.
      Log.d(TAG, "Ad failed to show.")
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      rewardedAd = null
    }

    override fun onAdShowedFullScreenContent() {
      // Called when fullscreen content is shown.
      Log.d(TAG, "Ad showed fullscreen content.")
    }

    override fun onAdImpression() {
      // Called when an impression is recorded for an ad.
      Log.d(TAG, "Ad recorded an impression.")
    }

    override fun onAdClicked() {
      // Called when an ad is clicked.
      Log.d(TAG, "Ad was clicked.")
    }
  }
MainActivity.kt

Muestra el anuncio

Cuando muestres un anuncio recompensado, usarás un objeto OnUserEarnedRewardListener para procesar los eventos de recompensa.

Java

rewardedAd.show(
    MainActivity.this,
    new OnUserEarnedRewardListener() {
      @Override
      public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
        Log.d(TAG, "User earned the reward.");
        // Handle the reward.
      }
    });
MainActivity.java

Kotlin

rewardedAd?.show(
  this,
  OnUserEarnedRewardListener { rewardItem ->
    Log.d(TAG, "User earned the reward.")
    // Handle the reward.
    val rewardAmount = rewardItem.amount
    val rewardType = rewardItem.type
  },
)
MainActivity.kt

[Opcional] Valida las devoluciones de llamada de verificación del servidor (SSV)

Las apps que requieren datos adicionales en las devoluciones de llamada de verificación del servidor deberían 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 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.

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

Java

RewardedAd.load(
    context,
    AD_UNIT_ID,
    new AdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(RewardedAd ad) {
        rewardedAd = ad;
        ServerSideVerificationOptions options =
            new ServerSideVerificationOptions.Builder()
                .setCustomData("SAMPLE_CUSTOM_DATA_STRING")
                .build();
        rewardedAd.setServerSideVerificationOptions(options);
      }
    });
RewardedAdSnippets.java

Kotlin

RewardedAd.load(
  context,
  AD_UNIT_ID,
  AdRequest.Builder().build(),
  object : RewardedAdLoadCallback() {
    override fun onAdLoaded(ad: RewardedAd) {
      rewardedAd = ad
      val options =
        ServerSideVerificationOptions.Builder().setCustomData("SAMPLE_CUSTOM_DATA_STRING").build()
      rewardedAd?.setServerSideVerificationOptions(options)
    }
  },
)
RewardedAdSnippets.kt

Reemplaza SAMPLE_CUSTOM_DATA_STRING por tus datos personalizados.

Si deseas establecer la cadena de recompensa personalizada, debes hacerlo antes de mostrar el anuncio.

Punto clave: La cadena de recompensa personalizada se establece con codificación porcentual y podría requerir una decodificación cuando se analice desde la devolución de llamada de SSV.

Preguntas frecuentes

¿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 OnInitializationCompleteListener, incluso si hay redes de mediación que aún 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 la devolución de llamada de OnInitializationCompleteListener. 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 MobileAds.getInitializationStatus(), puedes seguir sondeando el estado de inicialización de todos los adaptadores durante la sesión de tu app.

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

AdapterStatus.getDescription() describe por qué un adaptador no está listo para procesar solicitudes de anuncios.

¿Siempre se llama a la devolución de llamada onUserEarnedReward() antes de la devolución de llamada onAdDismissedFullScreenContent()?

En el caso de los anuncios de Google, todas las llamadas a onUserEarnedReward() se producen antes de onAdDismissedFullScreenContent(). 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 redes de publicidad que proporcionan una única devolución de llamada de cierre con información sobre las recompensas, el adaptador de mediación invoca onUserEarnedReward() antes de onAdDismissedFullScreenContent().

Ejemplos en GitHub

• Ejemplo de anuncios recompensados: Java | Kotlin

Próximos pasos

Consulta los siguientes temas:

• Privacidad del usuario
• Optimización relacionada con la inicialización del SDK y la carga de anuncios (beta)