RewardedAd

Kotlin |Java

public 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()

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

Constructeurs publics

RewardedAd

public RewardedAd()

Méthodes publiques

getAdMetadata

public abstract Bundle getAdMetadata()

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

public abstract @NonNull String getAdUnitId()

Renvoie l'ID du bloc d'annonces.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Récupère le FullScreenContentCallback pour ce RewardedAd.

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

Récupère le OnAdMetadataChangedListener pour ce RewardedAd.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Récupère le OnPaidEventListener pour ce RewardedAd.

getPlacementId

public abstract long getPlacementId()

Obtient l'ID d'emplacement pour ce RewardedAd.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

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

getRewardItem

public abstract @NonNull RewardItem getRewardItem()

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

isAdAvailable

public static boolean isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

Cette méthode est obsolète.

Utilisez isAdAvailable à la place.

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

auto-infligée

public static void load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdManagerAdRequest adManagerAdRequest,
    @NonNull RewardedAdLoadCallback loadCallback
)

Charge un RewardedAd.

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

auto-infligée

public static void load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdRequest adRequest,
    @NonNull RewardedAdLoadCallback loadCallback
)

Charge un RewardedAd.

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

pollAd

public static @Nullable RewardedAd pollAd(@NonNull Context context, @NonNull String adUnitId)

Cette méthode est obsolète.

Utilisez pollAd à la place.

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

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

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

public abstract void setOnAdMetadataChangedListener(
    @Nullable OnAdMetadataChangedListener listener
)

Définit le OnAdMetadataChangedListener pour ce RewardedAd.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

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
long placementId	Entier long fourni par l'UI AdMob pour l'emplacement configuré.

setServerSideVerificationOptions

public abstract void setServerSideVerificationOptions(
    @Nullable ServerSideVerificationOptions options
)

Définit ServerSideVerificationOptions pour ce RewardedAd.

afficher

public abstract void show(
    @NonNull Activity activity,
    @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener
)

Affiche l'annonce avec récompense.

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