Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel AdMob sur le serveur de la communauté Google Advertising and Measurement.

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

RewardedAd

Kotlin |Java

abstract class RewardedAd

Cette classe permet de demander et d'afficher une annonce avec récompense.

public class MainActivity extends AppCompatActivity {

    private RewardedAd rewardedAd;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        FullScreenContentCallback fullScreenContentCallback =
            new FullScreenContentCallback() {
                @Override
                public void onAdShowedFullScreenContent() {
                    // Code to be invoked when the ad showed full screen content.
                }

                @Override
                public void onAdDismissedFullScreenContent() {
                    rewardedAd = null;
                    // Code to be invoked when the ad dismissed full screen content.
                }
            };

        RewardedAd.load(
            this,
            "adUnitId",
            new AdRequest.Builder().build(),
            new RewardedAdLoadCallback() {
                @Override
                public void onAdLoaded(RewardedAd ad) {
                    findViewById(R.id.display_button).setVisibility(View.VISIBLE);
                    rewardedAd = ad;
                    rewardedAd.setFullScreenContentCallback(fullScreenContentCallback);
                }
            });
    }

    public void onDisplayButtonClicked(View view) {
        if (rewardedAd != null) {
            rewardedAd.show(
                this,
                new OnUserEarnedRewardListener() {
                    @Override
                    public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
                        Toast.makeText(
                            MainActivity.this,
                            "onRewarded! currency: "
                                + rewardItem.getType() + "    amount: "
                                + rewardItem.getAmount(), Toast.LENGTH_SHORT).show();
                    }
                });
        }
    }
}

Résumé

Constructeurs publics
`RewardedAd()`

Fonctions publiques
`abstract Bundle!`	`getAdMetadata()` Récupère toutes les métadonnées d'annonce disponibles pour ce `RewardedAd`.
`abstract String`	`getAdUnitId()` Renvoie l'ID du bloc d'annonces.
`abstract FullScreenContentCallback?`	`getFullScreenContentCallback()` Récupère le `FullScreenContentCallback` pour ce `RewardedAd`.
`abstract OnAdMetadataChangedListener?`	`getOnAdMetadataChangedListener()` Récupère le `OnAdMetadataChangedListener` pour ce `RewardedAd`.
`abstract OnPaidEventListener?`	`getOnPaidEventListener()` Récupère le `OnPaidEventListener` pour ce `RewardedAd`.
`abstract Long`	`getPlacementId()` Obtient l'ID d'emplacement pour ce `RewardedAd`.
`abstract ResponseInfo`	`getResponseInfo()` Renvoie l'objet `ResponseInfo` pour l'annonce chargée.
`abstract RewardItem`	`getRewardItem()` Récupère l'article de récompense pour l'annonce avec récompense chargée.
`java-static Boolean`	`isAdAvailable(context: Context, adUnitId: String)` Cette fonction est obsolète. Utilisez `isAdAvailable` à la place.
`java-static Unit`	`load( context: Context, adUnitId: String, adManagerAdRequest: AdManagerAdRequest, loadCallback: RewardedAdLoadCallback )` Charge un `RewardedAd`.
`java-static Unit`	`load( context: Context, adUnitId: String, adRequest: AdRequest, loadCallback: RewardedAdLoadCallback )` Charge un `RewardedAd`.
`java-static RewardedAd?`	`pollAd(context: Context, adUnitId: String)` Cette fonction est obsolète. Utilisez `pollAd` à la place.
`abstract Unit`	`setFullScreenContentCallback( fullScreenContentCallback: FullScreenContentCallback? )` Enregistre un rappel à invoquer lorsque des annonces affichent et ferment du contenu en plein écran.
`abstract Unit`	`setImmersiveMode(immersiveModeEnabled: Boolean)` Définit un indicateur qui contrôle si cet objet d'annonce avec récompense sera affiché en mode immersif.
`abstract Unit`	`setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?)` Définit le `OnAdMetadataChangedListener` pour ce `RewardedAd`.
`abstract Unit`	`setOnPaidEventListener(listener: OnPaidEventListener?)` Enregistre un rappel à invoquer lorsque cette annonce est estimée avoir généré des revenus.
`abstract Unit`	`setPlacementId(placementId: Long)` Définit un ID d'emplacement pour l'annonce avec récompense.
`abstract Unit`	`setServerSideVerificationOptions( options: ServerSideVerificationOptions? )` Définit `ServerSideVerificationOptions` pour ce `RewardedAd`.
`abstract Unit`	`show( activity: Activity, onUserEarnedRewardListener: OnUserEarnedRewardListener )` Affiche l'annonce avec récompense.

Constructeurs publics

RewardedAd

RewardedAd()

Fonctions publiques

getAdMetadata

abstract fun getAdMetadata(): Bundle!

Récupère toutes les métadonnées d'annonce disponibles pour ce RewardedAd. Les métadonnées de l'annonce sont vides si l'annonce chargée n'en comporte pas. Les métadonnées des annonces peuvent être mises à jour après le chargement. Utilisez onAdMetadataChanged pour écouter les modifications.

getAdUnitId

abstract fun getAdUnitId(): String

Renvoie l'ID du bloc d'annonces.

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

Récupère le FullScreenContentCallback pour ce RewardedAd.

getOnAdMetadataChangedListener

abstract fun getOnAdMetadataChangedListener(): OnAdMetadataChangedListener?

Récupère le OnAdMetadataChangedListener pour ce RewardedAd.

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

Récupère le OnPaidEventListener pour ce RewardedAd.

getPlacementId

abstract fun getPlacementId(): Long

Obtient l'ID d'emplacement pour ce RewardedAd.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

Renvoie l'objet ResponseInfo pour l'annonce chargée.

getRewardItem

abstract fun getRewardItem(): RewardItem

Récupère l'article de récompense pour l'annonce avec récompense chargée.

isAdAvailable

java-static fun isAdAvailable(context: Context, adUnitId: String): Boolean

Renvoie true si une annonce avec récompense disponible est chargée à partir de startPreload.

auto-infligée

java-static fun load(
    context: Context,
    adUnitId: String,
    adManagerAdRequest: AdManagerAdRequest,
    loadCallback: RewardedAdLoadCallback
): Unit

Charge un RewardedAd.

Paramètres
`context: Context`	Le contexte.
`adUnitId: String`	ID du bloc d'annonces.
`adManagerAdRequest: AdManagerAdRequest`	Demande d'annonce Google Ad Manager avec des informations de ciblage.
`loadCallback: RewardedAdLoadCallback`	Rappel à invoquer lorsqu'une annonce avec récompense a fini de se charger.

auto-infligée

java-static fun load(
    context: Context,
    adUnitId: String,
    adRequest: AdRequest,
    loadCallback: RewardedAdLoadCallback
): Unit

Charge un RewardedAd.

Paramètres
`context: Context`	Le contexte.
`adUnitId: String`	ID du bloc d'annonces.
`adRequest: AdRequest`	Demande d'annonce avec des informations de ciblage.
`loadCallback: RewardedAdLoadCallback`	Rappel à invoquer lorsqu'une annonce avec récompense a fini de se charger.

pollAd

java-static fun pollAd(context: Context, adUnitId: String): RewardedAd?

Récupère la prochaine annonce avec récompense chargée à partir de startPreload ou null si aucune annonce n'est disponible.

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

Enregistre un rappel à invoquer lorsque des annonces affichent et ferment du contenu en plein écran.

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

Définit un indicateur qui contrôle si cet objet d'annonce avec récompense sera affiché en mode immersif. Appelez cette méthode avant show. Pendant show, si ce paramètre est activé et que le mode immersif est pris en charge, SYSTEM_UI_FLAG_IMMERSIVE_STICKY et SYSTEM_UI_FLAG_HIDE_NAVIGATION seront activés pour l'annonce avec récompense.

setOnAdMetadataChangedListener

abstract fun setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?): Unit

Définit le OnAdMetadataChangedListener pour ce RewardedAd.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

Enregistre un rappel à invoquer lorsque cette annonce est estimée avoir généré des revenus.

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

Définit un ID d'emplacement pour l'annonce avec récompense.

Pour vous assurer que cet ID d'emplacement est inclus dans les rapports, appelez cette méthode avant d'afficher l'annonce.

Paramètres
`placementId: Long`	Entier long fourni par l'UI AdMob pour l'emplacement configuré.

setServerSideVerificationOptions

abstract fun setServerSideVerificationOptions(
    options: ServerSideVerificationOptions?
): Unit

Définit ServerSideVerificationOptions pour ce RewardedAd.

afficher

abstract fun show(
    activity: Activity,
    onUserEarnedRewardListener: OnUserEarnedRewardListener
): Unit

Affiche l'annonce avec récompense.

Paramètres
`activity: Activity`	Activité à partir de laquelle l'annonce avec récompense doit être affichée.
`onUserEarnedRewardListener: OnUserEarnedRewardListener`	Écouteur à notifier lorsque l'utilisateur gagne une récompense.