Anuncios recompensados

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

Requisitos previos

  • Completar la Guía de introducción

    • Siempre haz pruebas 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, 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 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 (beta), consulta la sección sobre anuncios de prueba.

    Carga un anuncio

    Para cargar un anuncio recompensado, llama al método load() estático de RewardedAd y pasa AdLoadCallback<RewardedAd> para recibir el anuncio cargado o posibles errores.

    Kotlin

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback
import com.google.android.libraries.ads.mobile.sdk.MobileAds

class RewardedActivity : Activity() {
  private var rewardedAd: RewardedAd? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Load ads after you inititalize Google Mobile Ads SDK (beta).
    RewardedAd.load(
      AdRequest.Builder(AD_UNIT_ID).build(),
      object : AdLoadCallback<RewardedAd> {
        override fun onAdLoaded(ad: RewardedAd) {
          // Rewarded ad loaded.
          rewardedAd = ad
        }

        override fun onAdFailedToLoad(adError: LoadAdError) {
          // Rewarded ad failed to load.
          rewardedAd = null
        }
      },
    )
  }

  companion object {
    // Sample rewarded ad unit ID.
    const val AD_UNIT_ID = "ca-app-pub-3940256099942544/5224354917"
  }
}

    Java

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback;
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest;
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError;
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback;
import com.google.android.libraries.ads.mobile.sdk.MobileAds;

class RewardedActivity extends Activity {
  // Sample rewarded ad unit ID.
  private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/5224354917";
  private RewardedAd rewardedAd;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Load ads after you initialize Google Mobile Ads SDK (beta).
    RewardedAd.load(
        new AdRequest.Builder(AD_UNIT_ID).build(),
        new AdLoadCallback<RewardedAd>() {
          @Override
          public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
            // Rewarded ad loaded.
            AdLoadCallback.super.onAdLoaded(rewardedAd);
            RewardedActivity.this.rewardedAd = rewardedAd;
          }

          @Override
          public void onAdFailedToLoad(@NonNull LoadAdError adError) {
            // Rewarded ad failed to load.
            AdLoadCallback.super.onAdFailedToLoad(adError);
            rewardedAd = null;
          }
        }
    );
  }
}

    Establece el objeto RewardedAdEventCallback

    El objeto RewardedAdEventCallback procesa los eventos relacionados con la visualización de tu RewardedAd. Antes de mostrar el anuncio recompensado, asegúrate de configurar la devolución de llamada:

    Kotlin

    // Listen for ad events.
rewardedAd?.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdShowedFullScreenContent() {
      // Rewarded ad did show.
    }

    override fun onAdDismissedFullScreenContent() {
      // Rewarded ad did dismiss.
      rewardedAd = null
    }

    override fun onAdFailedToShowFullScreenContent(
      fullScreenContentError: FullScreenContentError
    ) {
      // Rewarded ad failed to show.
      rewardedAd = null
    }

    override fun onAdImpression() {
      // Rewarded ad did record an impression.
    }

    override fun onAdClicked() {
      // Rewarded ad did record a click.
    }
  }

    Java

    // Listen for ad events.
rewardedAd.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdShowedFullScreenContent() {
        // Rewarded ad did show.
        RewardedAdEventCallback.super.onAdShowedFullScreenContent();
      }

      @Override
      public void onAdDismissedFullScreenContent() {
        // Rewarded ad did dismiss.
        RewardedAdEventCallback.super.onAdDismissedFullScreenContent();
        rewardedAd = null;
      }

      @Override
      public void onAdFailedToShowFullScreenContent(
          @NonNull FullScreenContentError fullScreenContentError) {
        // Rewarded ad failed to show.
        RewardedAdEventCallback.super.onAdFailedToShowFullScreenContent(
            fullScreenContentError);
        rewardedAd = null;
      }

      @Override
      public void onAdImpression() {
        // Rewarded ad did record an impression.
        RewardedAdEventCallback.super.onAdImpression();
      }

      @Override
      public void onAdClicked() {
        // Rewarded ad did record a click.
        RewardedAdEventCallback.super.onAdClicked();
      }
    }
);

    Muestra el anuncio

    Para mostrar un anuncio recompensado, usa el método show(). Con un objeto OnUserEarnedRewardListener, puedes procesar los eventos de recompensa.

    Kotlin

    // Show the ad.
rewardedAd?.show(
  this@RewardedActivity,
  object : OnUserEarnedRewardListener {
    override fun onUserEarnedReward(rewardItem: RewardItem) {
      // User earned the reward.
      val rewardAmount = rewardItem.amount
      val rewardType = rewardItem.type
    }
  },
)

    Java

    // Show the ad.
rewardedAd.show(
    RewardedActivity.this,
    new OnUserEarnedRewardListener() {
      @Override
      public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
        // User earned the reward.
        int rewardAmount = rewardItem.getAmount();
        String rewardType = rewardItem.getType();
    }
});

    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 (beta) 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. Incluso si una red de mediación no está lista, el SDK de anuncios de Google para dispositivos móviles (beta) 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().

    Ejemplo

    Descarga y ejecuta la app de ejemplo que demuestra el uso del SDK de anuncios de Google para dispositivos móviles (beta).