Requisitos previos
- Tener la versión 19.7.0 del SDK de anuncios de Google para móviles o una posterior.
- Hacer todo lo que se indica en la guía de introducción.
Probar siempre las aplicaciones con anuncios de prueba
Cuando crees y pruebes tus aplicaciones, utiliza siempre anuncios de prueba en lugar de anuncios reales que se estén publicando. De lo contrario, podríamos suspender tu cuenta.
La forma más sencilla de cargar anuncios de prueba es usar el ID del bloque de anuncios de prueba que hemos creado para los anuncios bonificados de Android:
ca-app-pub-3940256099942544/5224354917
Lo hemos configurado especialmente para que devuelva anuncios de prueba en cada solicitud, y puedes usarlo mientras programas, evalúas y depuras tus propias aplicaciones. Recuerda que debes sustituirlo por el ID de tu bloque de anuncios antes de publicar la aplicación.
Para obtener más información sobre cómo funcionan los anuncios de prueba del SDK de anuncios para móviles, consulta la guía de anuncios de prueba.
Cargar un objeto de anuncio bonificado
Los anuncios bonificados se cargan llamando al método load()
estático de la clase RewardedAd
y transfiriéndolo en una RewardedAdLoadCallback
. Normalmente, esto se hace con el método onCreate()
de un objeto Activity
.
Ten en cuenta que, al igual que otras retrollamadas de carga de formato, RewardedAdLoadCallback
utiliza LoadAdError
para proporcionar detalles de los errores de fidelidad más alta.
Java
import com.google.android.gms.ads.rewarded.RewardedAd; public class MainActivity extends Activity { private RewardedAd rewardedAd; private final String TAG = "MainActivity"; @Override protected void onCreate(Bundle savedInstanceState) { AdRequest adRequest = new AdRequest.Builder().build(); RewardedAd.load(this, "ca-app-pub-3940256099942544/5224354917", adRequest, new RewardedAdLoadCallback() { @Override public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) { // Handle the error. Log.d(TAG, loadAdError.toString()); rewardedAd = null; } @Override public void onAdLoaded(@NonNull RewardedAd ad) { rewardedAd = ad; Log.d(TAG, "Ad was loaded."); } }); } }
Kotlin
class MainActivity : AppCompatActivity() { private var rewardedAd: RewardedAd? = null private final var TAG = "MainActivity" override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) var adRequest = AdRequest.Builder().build() RewardedAd.load(this,"ca-app-pub-3940256099942544/5224354917", adRequest, object : RewardedAdLoadCallback() { override fun onAdFailedToLoad(adError: LoadAdError) { Log.d(TAG, adError?.toString()) rewardedAd = null } override fun onAdLoaded(ad: RewardedAd) { Log.d(TAG, "Ad was loaded.") rewardedAd = ad } }) } }
[Opcional] Validar retrollamadas de verificación en el servidor (SSV)
Las aplicaciones que requieren datos adicionales en las retrollamadas de SSV deben usar la función de datos personalizados de los anuncios bonificados. Los valores de cadena asignados a un objeto de anuncio bonificado se envían al parámetro de consulta custom_data
de la retrollamada de SSV. Si no se asigna ningún valor de datos personalizados, el valor del parámetro de consulta custom_data
no estará presente en la retrollamada de SSV.
En el siguiente código de ejemplo se muestra cómo definir los datos personalizados en un objeto de anuncio bonificado antes de solicitar un anuncio.
Java
RewardedAd.load(MainActivity.this, "ca-app-pub-3940256099942544/5354046379", new AdRequest.Builder().build(), new RewardedAdLoadCallback() { @Override public void onAdLoaded(RewardedAd ad) { Log.d(TAG, "Ad was loaded."); rewardedAd = ad; ServerSideVerificationOptions options = new ServerSideVerificationOptions .Builder() .setCustomData("SAMPLE_CUSTOM_DATA_STRING") .build(); rewardedAd.setServerSideVerificationOptions(options); } @Override public void onAdFailedToLoad(LoadAdError loadAdError) { Log.d(TAG, loadAdError.toString()); rewardedAd = null; } });
Kotlin
RewardedAd.load(this, "ca-app-pub-3940256099942544/5354046379", AdRequest.Builder().build(), object : RewardedAdLoadCallback() { override fun onAdLoaded(ad: RewardedAd) { Log.d(TAG, "Ad was loaded.") rewardedInterstitialAd = ad val options = ServerSideVerificationOptions.Builder() .setCustomData("SAMPLE_CUSTOM_DATA_STRING") .build() rewardedAd.setServerSideVerificationOptions(options) } override fun onAdFailedToLoad(adError: LoadAdError) { Log.d(TAG, adError?.toString()) rewardedAd = null } })
Si quieres configurar la cadena de anuncios bonificados personalizados, debes hacerlo antes de mostrar el anuncio.
Definir la FullScreenContentCallback
FullScreenContentCallback
gestiona eventos relacionados con la visualización de tu RewardedAd
. Antes de mostrar el RewardedAd
, configura la retrollamada de la siguiente manera:
Java
rewardedAd.setFullScreenContentCallback(new FullScreenContentCallback() { @Override public void onAdClicked() { // Called when a click is recorded for an ad. Log.d(TAG, "Ad was clicked."); } @Override public void onAdDismissedFullScreenContent() { // Called when ad is dismissed. // Set the ad reference to null so you don't show the ad a second time. Log.d(TAG, "Ad dismissed fullscreen content."); rewardedAd = null; } @Override public void onAdFailedToShowFullScreenContent(AdError adError) { // Called when ad fails to show. Log.e(TAG, "Ad failed to show fullscreen content."); rewardedAd = null; } @Override public void onAdImpression() { // Called when an impression is recorded for an ad. Log.d(TAG, "Ad recorded an impression."); } @Override public void onAdShowedFullScreenContent() { // Called when ad is shown. Log.d(TAG, "Ad showed fullscreen content."); } });
Kotlin
rewardedAd?.fullScreenContentCallback = object: FullScreenContentCallback() { override fun onAdClicked() { // Called when a click is recorded for an ad. Log.d(TAG, "Ad was clicked.") } override fun onAdDismissedFullScreenContent() { // Called when ad is dismissed. // Set the ad reference to null so you don't show the ad a second time. Log.d(TAG, "Ad dismissed fullscreen content.") rewardedAd = null } override fun onAdFailedToShowFullScreenContent(adError: AdError?) { // Called when ad fails to show. Log.e(TAG, "Ad failed to show fullscreen content.") rewardedAd = null } override fun onAdImpression() { // Called when an impression is recorded for an ad. Log.d(TAG, "Ad recorded an impression.") } override fun onAdShowedFullScreenContent() { // Called when ad is shown. Log.d(TAG, "Ad showed fullscreen content.") } }
Mostrar anuncios
Cuando muestras un anuncio bonificado, usas un objeto OnUserEarnedRewardListener
para gestionar los eventos de bonificación.
Java
if (rewardedAd != null) { Activity activityContext = MainActivity.this; rewardedAd.show(activityContext, new OnUserEarnedRewardListener() { @Override public void onUserEarnedReward(@NonNull RewardItem rewardItem) { // Handle the reward. Log.d(TAG, "The user earned the reward."); int rewardAmount = rewardItem.getAmount(); String rewardType = rewardItem.getType(); } }); } else { Log.d(TAG, "The rewarded ad wasn't ready yet."); }
Kotlin
rewardedAd?.let { ad -> ad.show(this, OnUserEarnedRewardListener { rewardItem -> // Handle the reward. val rewardAmount = rewardItem.amount val rewardType = rewardItem.type Log.d(TAG, "User earned the reward.") }) } ?: run { Log.d(TAG, "The rewarded ad wasn't ready yet.") }
Preguntas frecuentes
- ¿Las llamadas de inicialización tienen un tiempo de espera determinado?
- Después de 10 segundos, el SDK de anuncios de Google para móviles invoca el elemento
OnInitializationCompleteListener
aunque la red de mediación aún no haya completado la inicialización. - ¿Qué ocurre si alguna red de mediación no está lista cuando recibo la retrollamada de inicialización?
Te recomendamos que cargues un anuncio en la retrollamada de
OnInitializationCompleteListener
. Aunque la red de mediación no esté lista, el SDK de anuncios de Google para móviles seguirá solicitándole el anuncio. Por lo tanto, aunque una red de mediación complete la inicialización tras finalizar el tiempo de espera, podrá servir solicitudes de anuncio más adelante en esa misma sesión.Puedes seguir consultando el estado de la inicialización de todos los adaptadores a través de la sesión de tu aplicación. Solo tienes que llamar a
MobileAds.getInitializationStatus()
.- ¿Cómo puedo saber por qué una red de mediación concreta no está lista?
La propiedad
AdapterStatus.getDescription()
describe por qué un adaptador no está listo para servir solicitudes de anuncio.- ¿Se invoca siempre la retrollamada
onUserEarnedReward()
antes que la retrollamadaonAdDismissedFullScreenContent()
? En el caso de los anuncios de Google, todas las llamadas a
onUserEarnedReward()
se realizan antes de llamar aonAdDismissedFullScreenContent()
. En el caso de los anuncios servidos a través de la mediación, la implementación del SDK de una red publicitaria de terceros determina el orden de las retrollamadas. En los SDKs de redes publicitarias que proporcionan una única retrollamada de cierre con información sobre las recompensas, el adaptador de mediación invoca aonUserEarnedReward()
antes que aonAdDismissedFullScreenContent()
.