Cette page a été traduite par l'API Cloud Translation.

Annonces avec récompense

Annonces avec récompense vous permettent de récompenser les utilisateurs qui interagissent avec des annonces vidéo, des annonces jouables et des enquêtes en leur offrant différents éléments au sein de votre application.

Prérequis

Suivez le guide de démarrage.

Toujours effectuer des tests avec des annonces tests

Lorsque vous créez et testez vos applications, assurez-vous d'utiliser des annonces tests plutôt que des annonces de production. À défaut, votre compte risque d'être suspendu.

Le moyen le plus simple de charger des annonces tests consiste à utiliser notre ID de bloc d'annonces test dédié pour les annonces avec récompense Android :

ca-app-pub-3940256099942544/5224354917

Il a été spécialement configuré pour renvoyer des annonces tests pour chaque demande. Vous pouvez l'utiliser librement dans vos propres applications lors du codage, des tests et du débogage. Veillez simplement à le remplacer par votre propre ID de bloc d'annonces avant de publier votre application.

Pour en savoir plus sur le fonctionnement des annonces tests du SDK GMA Next Gen, consultez Annonces tests.

Charger une annonce

Pour charger une annonce, le SDK GMA Next Gen propose les options suivantes :

Chargez-le avec l'API de chargement d'annonces uniques.
Chargez-les avec l'API de préchargement d'annonces, qui élimine le besoin de chargement et de mise en cache manuels des annonces.

Charger avec l'API de chargement d'annonces uniques

L'exemple suivant montre comment charger une seule annonce :

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 GMA Next Gen SDK.
    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 GMA Next Gen SDK.
    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;
          }
        }
    );
  }
}

Charger avec l'API de préchargement des annonces

Pour commencer le préchargement :

Initialisez une configuration de préchargement avec une demande d'annonce.
Démarrez le préchargement des annonces avec récompense avec votre ID de bloc d'annonces et la configuration du préchargement :

Kotlin

private fun startPreloading(adUnitId: String) {
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  RewardedAdPreloader.start(adUnitId, preloadConfig)
}

Java

private void startPreloading(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  RewardedAdPreloader.start(adUnitId, preloadConfig);
}

Lorsque vous êtes prêt à afficher l'annonce, interrogez-la à partir du préchargeur :

Kotlin

// Polling returns the next available ad and loads another ad in the background.
val ad = RewardedAdPreloader.pollAd(adUnitId)

Java

// Polling returns the next available ad and loads another ad in the background.
final RewardedAd ad = RewardedAdPreloader.pollAd(adUnitId);

Définir RewardedAdEventCallback

Le RewardedAdEventCallback gère les événements liés à l'affichage de votre RewardedAd. Avant d'afficher l'annonce avec récompense, assurez-vous de définir le rappel :

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();
      }
    }
);

Diffuser l'annonce

Pour afficher une annonce avec récompense, utilisez la méthode show(). Utilisez un objet OnUserEarnedRewardListener pour gérer les événements de récompense.

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();
    }
});

Questions fréquentes

L'appel d'initialisation est-il soumis à un délai avant expiration ?

Après 10 secondes, le SDK GMA nouvelle génération appelle OnInitializationCompleteListener, même si un réseau de médiation n'a pas encore terminé l'initialisation.

Que faire si certains réseaux de médiation ne sont pas prêts lorsque je reçois le rappel d'initialisation ?

Nous vous recommandons de charger une annonce dans le rappel de OnInitializationCompleteListener. Même si un réseau de médiation n'est pas prêt, le SDK GMA nouvelle génération lui demande quand même une annonce. Ainsi, si un réseau de médiation termine son initialisation après le délai d'expiration, il peut toujours répondre aux futures demandes d'annonces de cette session.

Vous pouvez continuer à interroger l'état d'initialisation de tous les adaptateurs tout au long de la session de votre application en appelant MobileAds.getInitializationStatus().

Comment savoir pourquoi un réseau de médiation spécifique n'est pas prêt ?

AdapterStatus.getDescription() décrit pourquoi un adaptateur n'est pas prêt à traiter les demandes d'annonces.

Le rappel onUserEarnedReward() est-il toujours appelé avant le rappel onAdDismissedFullScreenContent() ?

Pour les annonces Google, tous les appels onUserEarnedReward() ont lieu avant onAdDismissedFullScreenContent(). Pour les annonces diffusées via la médiation, l'ordre des rappels est déterminé par l'implémentation du SDK du réseau publicitaire tiers. Pour les SDK de réseaux publicitaires qui fournissent un seul rappel de fermeture avec des informations sur la récompense, l'adaptateur de médiation appelle onUserEarnedReward() avant onAdDismissedFullScreenContent().

Exemple

Téléchargez et exécutez l'application exemple qui montre comment utiliser le SDK GMA Next Gen.

Annonces avec récompense Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Prérequis

Toujours effectuer des tests avec des annonces tests

Charger une annonce

Charger avec l'API de chargement d'annonces uniques

Kotlin

Java

Charger avec l'API de préchargement des annonces

Kotlin

Java

Kotlin

Java

Définir RewardedAdEventCallback

Kotlin

Java

Diffuser l'annonce

Kotlin

Java

Questions fréquentes

Exemple

Annonces avec récompense