כדי לדון במוצרים שלנו ולספק משוב, אתם יכולים להצטרף לערוץ הרשמי של AdMob ב-Discord בשרת Google Advertising and Measurement Community.

דף זה תורגם על ידי Cloud Translation API.

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 Long`	`getPlacementId()` מקבל את מזהה מיקום המודעה של `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? )` רושם קריאה חוזרת להפעלה כשמודעות מוצגות ומסתירות תוכן במסך מלא.
`abstract Unit`	`setImmersiveMode(immersiveModeEnabled: Boolean)` הגדרת דגל שקובע אם אובייקט המודעה המתגמלת יוצג במצב immersive.
`abstract Unit`	`setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?)` הגדרת `OnAdMetadataChangedListener` ל-`RewardedAd` הזה.
`abstract Unit`	`setOnPaidEventListener(listener: OnPaidEventListener?)` רושמת קריאה חוזרת להפעלה כשהמערכת מעריכה שהמודעה הזו הניבה רווחים.
`abstract Unit`	`setPlacementId(placementId: Long)` מגדיר מזהה מיקום של המודעה המתגמלת.
`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.

getPlacementId

abstract fun getPlacementId(): Long

מקבל את מזהה מיקום המודעה של RewardedAd.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

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

getRewardItem

abstract fun getRewardItem(): RewardItem

מחזירה את פריט התגמול של המודעה המתגמלת שנטענה.

isAdAvailable

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

הפונקציה מחזירה 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?

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

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

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

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

הגדרת דגל שקובע אם אובייקט המודעה המתגמלת יוצג במצב immersive. צריך להפעיל את השיטה הזו לפני show. במהלך show, אם ה-flag הזה מופעל ויש תמיכה במצב 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

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

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

מגדיר מזהה מיקום של המודעה המתגמלת.

כדי לוודא שמזהה מיקום המודעה הזה ייכלל בדוחות, צריך להפעיל את השיטה הזו לפני הצגת המודעה.

פרמטרים
`placementId: Long`	מספר שלם ארוך שמופיע בממשק המשתמש של AdMob למיקום המודעה שהוגדר.

setServerSideVerificationOptions

abstract fun setServerSideVerificationOptions(
    options: ServerSideVerificationOptions?
): Unit

מגדיר את ServerSideVerificationOptions עבור RewardedAd.

הצג

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

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

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