RewardedAd

Kotlin |Java

public abstract class RewardedAd

---

Questa classe viene utilizzata per richiedere e visualizzare un annuncio con premio.

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

Riepilogo

Costruttori pubblici
RewardedAd()

Metodi pubblici
abstract Bundle	getAdMetadata() Recupera tutti i metadati degli annunci disponibili per questo RewardedAd.
abstract @NonNull String	getAdUnitId() Restituisce l'ID unità pubblicitaria.
abstract @Nullable FullScreenContentCallback	getFullScreenContentCallback() Ottiene il valore FullScreenContentCallback per questo RewardedAd.
abstract @Nullable OnAdMetadataChangedListener	getOnAdMetadataChangedListener() Ottiene il valore OnAdMetadataChangedListener per questo RewardedAd.
abstract @Nullable OnPaidEventListener	getOnPaidEventListener() Ottiene il valore OnPaidEventListener per questo RewardedAd.
abstract long	getPlacementId() Recupera l'ID posizionamento per questo RewardedAd.
abstract @NonNull ResponseInfo	getResponseInfo() Restituisce l'oggetto ResponseInfo per l'annuncio caricato.
abstract @NonNull RewardItem	getRewardItem() Recupera l'elemento premio per l'annuncio con premio caricato.
static boolean	isAdAvailable(@NonNull Context context, @NonNull String adUnitId) Questo metodo è obsoleto. Utilizza invece isAdAvailable.
static void	load(     @NonNull Context context,     @NonNull String adUnitId,     @NonNull AdManagerAdRequest adManagerAdRequest,     @NonNull RewardedAdLoadCallback loadCallback ) Carica un RewardedAd.
static void	load(     @NonNull Context context,     @NonNull String adUnitId,     @NonNull AdRequest adRequest,     @NonNull RewardedAdLoadCallback loadCallback ) Carica un RewardedAd.
static @Nullable RewardedAd	pollAd(@NonNull Context context, @NonNull String adUnitId) Questo metodo è obsoleto. Utilizza invece pollAd.
abstract void	setFullScreenContentCallback(     @Nullable FullScreenContentCallback fullScreenContentCallback ) Registra un callback da richiamare quando gli annunci mostrano e chiudono i contenuti a schermo intero.
abstract void	setImmersiveMode(boolean immersiveModeEnabled) Imposta un flag che controlla se questo oggetto annuncio con premio verrà visualizzato in modalità immersiva.
abstract void	setOnAdMetadataChangedListener(     @Nullable OnAdMetadataChangedListener listener ) Imposta OnAdMetadataChangedListener per questo RewardedAd.
abstract void	setOnPaidEventListener(@Nullable OnPaidEventListener listener) Registra un callback da richiamare quando si stima che questo annuncio abbia generato entrate.
abstract void	setPlacementId(long placementId) Imposta un ID posizionamento per l'annuncio con premio.
abstract void	setServerSideVerificationOptions(     @Nullable ServerSideVerificationOptions options ) Imposta ServerSideVerificationOptions per questo RewardedAd.
abstract void	show(     @NonNull Activity activity,     @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener ) Mostra l'annuncio con premio.

Costruttori pubblici

RewardedAd

public RewardedAd()

Metodi pubblici

getAdMetadata

public abstract Bundle getAdMetadata()

Recupera tutti i metadati degli annunci disponibili per questo RewardedAd. I metadati dell'annuncio sono vuoti se l'annuncio caricato non ha metadati. I metadati dell'annuncio potrebbero essere aggiornati dopo il caricamento. Utilizza onAdMetadataChanged per ascoltare le modifiche.

getAdUnitId

public abstract @NonNull String getAdUnitId()

Restituisce l'ID unità pubblicitaria.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Ottiene il valore FullScreenContentCallback per questo RewardedAd.

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

Ottiene il valore OnAdMetadataChangedListener per questo RewardedAd.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Ottiene il valore OnPaidEventListener per questo RewardedAd.

getPlacementId

public abstract long getPlacementId()

Recupera l'ID posizionamento per questo RewardedAd.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

Restituisce l'oggetto ResponseInfo per l'annuncio caricato.

getRewardItem

public abstract @NonNull RewardItem getRewardItem()

Recupera l'elemento premio per l'annuncio con premio caricato.

isAdAvailable

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

Questo metodo è obsoleto.

Utilizza invece isAdAvailable.

Restituisce true se è stato caricato un annuncio con premio disponibile da startPreload.

load

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

Carica un RewardedAd.

Parametri
@NonNull Context context	Il contesto.
@NonNull String adUnitId	L'ID unità pubblicitaria.
@NonNull AdManagerAdRequest adManagerAdRequest	Una richiesta di annuncio Google Ad Manager con informazioni sul targeting.
@NonNull RewardedAdLoadCallback loadCallback	Un callback da richiamare al termine del caricamento di un annuncio con premio.

load

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

Carica un RewardedAd.

Parametri
@NonNull Context context	Il contesto.
@NonNull String adUnitId	L'ID unità pubblicitaria.
@NonNull AdRequest adRequest	Una richiesta di annuncio con informazioni di targeting.
@NonNull RewardedAdLoadCallback loadCallback	Un callback da richiamare al termine del caricamento di un annuncio con premio.

pollAd

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

Questo metodo è obsoleto.

Utilizza invece pollAd.

Recupera il successivo annuncio con premio caricato da startPreload o null se non è disponibile alcun annuncio.

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

Registra un callback da richiamare quando gli annunci mostrano e chiudono i contenuti a schermo intero.

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

Imposta un flag che controlla se questo oggetto annuncio con premio verrà visualizzato in modalità immersiva. Chiama questo metodo prima del giorno show. Durante show, se questo flag è attivo e la modalità immersiva è supportata, SYSTEM_UI_FLAG_IMMERSIVE_STICKY e SYSTEM_UI_FLAG_HIDE_NAVIGATION verranno attivati per l'annuncio con premio.

setOnAdMetadataChangedListener

public abstract void setOnAdMetadataChangedListener(
    @Nullable OnAdMetadataChangedListener listener
)

Imposta OnAdMetadataChangedListener per questo RewardedAd.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Registra un callback da richiamare quando si stima che questo annuncio abbia generato entrate.

setPlacementId

public abstract void setPlacementId(long placementId)

Imposta un ID posizionamento per l'annuncio con premio.

Per assicurarti che questo ID posizionamento sia incluso nei report, chiama questo metodo prima di mostrare l'annuncio.

Parametri
long placementId	Un numero intero lungo fornito dall'interfaccia utente di AdMob per il posizionamento configurato.

setServerSideVerificationOptions

public abstract void setServerSideVerificationOptions(
    @Nullable ServerSideVerificationOptions options
)

Imposta ServerSideVerificationOptions per questo RewardedAd.

mostra

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

Mostra l'annuncio con premio.

Parametri
@NonNull Activity activity	L'attività da cui deve essere mostrato l'annuncio con premio.
@NonNull OnUserEarnedRewardListener onUserEarnedRewardListener	Il listener a cui inviare una notifica quando l'utente guadagna un premio.