RewardedAd

Kotlin |Java

abstract class RewardedAd

---

הכיתה הזו משמשת לבקשת מודעה מתגמלת ולהצגתה.

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

סיכום

קונסטרוקטורים גלויים לכולם
RewardedAd()

פונקציות ציבוריות
abstract Bundle!	getAdMetadata() הפונקציה מקבלת את כל המטא-נתונים הזמינים של המודעות עבור RewardedAd הזה.
abstract String	getAdUnitId() הפונקציה מחזירה את מזהה יחידת המודעות.
abstract FullScreenContentCallback?	getFullScreenContentCallback() הפונקציה מקבלת את הערך של FullScreenContentCallback עבור RewardedAd הזה.
abstract OnAdMetadataChangedListener?	getOnAdMetadataChangedListener() הפונקציה מקבלת את הערך של OnAdMetadataChangedListener עבור RewardedAd הזה.
abstract OnPaidEventListener?	getOnPaidEventListener() הפונקציה מקבלת את הערך של OnPaidEventListener עבור RewardedAd הזה.
abstract ResponseInfo	getResponseInfo() הפונקציה מחזירה את האובייקט ResponseInfo של המודעה שנטענה.
abstract RewardItem	getRewardItem() הפונקציה מקבלת את פריט התגמול של המודעה המתגמלת שנטענה.
java-static Boolean	isAdAvailable(context: Context, adUnitId: String) הפונקציה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-isAdAvailable.
java-static Unit	load(     context: Context,     adUnitId: String,     adManagerAdRequest: AdManagerAdRequest,     loadCallback: RewardedAdLoadCallback ) טעינת RewardedAd.
java-static Unit	load(     context: Context,     adUnitId: String,     adRequest: AdRequest,     loadCallback: RewardedAdLoadCallback ) טעינת RewardedAd.
java-static RewardedAd?	pollAd(context: Context, adUnitId: String) הפונקציה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-pollAd.
abstract Unit	setFullScreenContentCallback(     fullScreenContentCallback: FullScreenContentCallback? ) הרשמה של פונקציית קריאה חוזרת (callback) שתופעל כשמודעות מוצגות ומסתירות תוכן במסך מלא.
abstract Unit	setImmersiveMode(immersiveModeEnabled: Boolean) הגדרת דגל שקובע אם אובייקט המודעה המתגמלת יוצג במצב immersive.
abstract Unit	setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?) הגדרת OnAdMetadataChangedListener ל-RewardedAd הזה.
abstract Unit	setOnPaidEventListener(listener: OnPaidEventListener?) הרשמה של קריאה חוזרת (callback) שתופעל כשהמודעה הזו תנייב רווחים משוערים.
abstract Unit	setServerSideVerificationOptions(     options: ServerSideVerificationOptions? ) הגדרת ServerSideVerificationOptions ל-RewardedAd הזה.
abstract Unit	show(     activity: Activity,     onUserEarnedRewardListener: OnUserEarnedRewardListener ) הצגת המודעה המתגמלת.

קונסטרוקטורים גלויים לכולם

RewardedAd

RewardedAd()

פונקציות ציבוריות

getAdMetadata

abstract fun getAdMetadata(): Bundle!

הפונקציה מקבלת את כל המטא-נתונים הזמינים של המודעות עבור RewardedAd הזה. המטא-נתונים של המודעה ריקים אם למודעה שנטענת אין מטא-נתונים. המטא-נתונים של המודעות עשויים להתעדכן אחרי הטעינה. משתמשים ב-onAdMetadataChanged כדי להאזין לשינויים.

getAdUnitId

abstract fun getAdUnitId(): String

הפונקציה מחזירה את מזהה יחידת המודעות.

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

הפונקציה מקבלת את הערך של FullScreenContentCallback עבור RewardedAd הזה.

getOnAdMetadataChangedListener

abstract fun getOnAdMetadataChangedListener(): OnAdMetadataChangedListener?

הפונקציה מקבלת את הערך של OnAdMetadataChangedListener עבור RewardedAd הזה.

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

הפונקציה מקבלת את הערך של OnPaidEventListener עבור RewardedAd הזה.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

הפונקציה מחזירה את האובייקט ResponseInfo של המודעה שנטענה.

getRewardItem

abstract fun getRewardItem(): RewardItem

הפונקציה מקבלת את פריט התגמול של המודעה המתגמלת שנטענה.

isAdAvailable

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

הפונקציה הזו הוצאה משימוש.

במקום זאת, אתם צריכים להשתמש ב-isAdAvailable.

הפונקציה מחזירה את הערך true אם יש מודעה מתגמלת זמינה שנטענה מ-startPreload.

משקל

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

טעינת RewardedAd.

פרמטרים
context: Context	ההקשר.
adUnitId: String	מזהה יחידת המודעות.
adManagerAdRequest: AdManagerAdRequest	בקשה להצגת מודעה מ-Google Ad Manager עם פרטי טירגוט.
loadCallback: RewardedAdLoadCallback	פונקציית קריאה חוזרת שתופעל כשהטעינה של מודעה מתגמלת תסתיים.

משקל

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

טעינת RewardedAd.

פרמטרים
context: Context	ההקשר.
adUnitId: String	מזהה יחידת המודעות.
adRequest: AdRequest	בקשה להצגת מודעה עם פרטי טירגוט.
loadCallback: RewardedAdLoadCallback	פונקציית קריאה חוזרת שתופעל כשהטעינה של מודעה מתגמלת תסתיים.

pollAd

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

הפונקציה הזו הוצאה משימוש.

במקום זאת, אתם צריכים להשתמש ב-pollAd.

הפונקציה מאחזרת את מודעת הפרסום המתגמלת הבאה שנטענת מ-startPreload, או מ-null אם אין מודעה זמינה.

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

הרשמה של פונקציית קריאה חוזרת (callback) שתופעל כשמודעות מוצגות ומסתירות תוכן במסך מלא.

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

הגדרת דגל שקובע אם אובייקט המודעה המתגמלת יוצג במצב immersive. צריך להפעיל את השיטה הזו לפני show. במהלך show, אם הדגל הזה מופעל ויש תמיכה במצב immersive, האפשרויות SYSTEM_UI_FLAG_IMMERSIVE_STICKY ו-SYSTEM_UI_FLAG_HIDE_NAVIGATION יופעלו במודעת הפרסום בתמורה לצפייה.

setOnAdMetadataChangedListener

abstract fun setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?): Unit

הגדרת OnAdMetadataChangedListener ל-RewardedAd הזה.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

הרשמה של קריאה חוזרת (callback) שתופעל כשהמודעה הזו תנייב רווחים משוערים.

setServerSideVerificationOptions

abstract fun setServerSideVerificationOptions(
    options: ServerSideVerificationOptions?
): Unit

הגדרת ServerSideVerificationOptions ל-RewardedAd הזה.

הצג

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

הצגת המודעה המתגמלת.

פרמטרים
activity: Activity	הפעילות שממנה המודעה המתגמלת צריכה להופיע.
onUserEarnedRewardListener: OnUserEarnedRewardListener	המאזין יקבל הודעה כשהמשתמש יקבל תגמול.