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

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

RewardedAd

‫Kotlin |Java

public 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 @NonNull String`	`getAdUnitId()` מחזירה את המזהה של יחידת המודעות.
`abstract @Nullable FullScreenContentCallback`	`getFullScreenContentCallback()` הפונקציה מחזירה את `FullScreenContentCallback` של `RewardedAd`.
`abstract @Nullable OnAdMetadataChangedListener`	`getOnAdMetadataChangedListener()` הפונקציה מחזירה את `OnAdMetadataChangedListener` של `RewardedAd`.
`abstract @Nullable OnPaidEventListener`	`getOnPaidEventListener()` הפונקציה מחזירה את `OnPaidEventListener` של `RewardedAd`.
`abstract long`	`getPlacementId()` מקבל את מזהה מיקום המודעה של `RewardedAd`.
`abstract @NonNull ResponseInfo`	`getResponseInfo()` מחזירה את האובייקט `ResponseInfo` של המודעה שנטענה.
`abstract @NonNull RewardItem`	`getRewardItem()` מחזירה את פריט התגמול של המודעה המתגמלת שנטענה.
`static boolean`	`isAdAvailable(@NonNull Context context, @NonNull String adUnitId)` השיטה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-`isAdAvailable`.
`static void`	`load( @NonNull Context context, @NonNull String adUnitId, @NonNull AdManagerAdRequest adManagerAdRequest, @NonNull RewardedAdLoadCallback loadCallback )` טעינה של `RewardedAd`.
`static void`	`load( @NonNull Context context, @NonNull String adUnitId, @NonNull AdRequest adRequest, @NonNull RewardedAdLoadCallback loadCallback )` טעינה של `RewardedAd`.
`static @Nullable RewardedAd`	`pollAd(@NonNull Context context, @NonNull String adUnitId)` השיטה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-`pollAd`.
`abstract void`	`setFullScreenContentCallback( @Nullable FullScreenContentCallback fullScreenContentCallback )` רושם קריאה חוזרת להפעלה כשמודעות מוצגות ומסתירות תוכן במסך מלא.
`abstract void`	`setImmersiveMode(boolean immersiveModeEnabled)` הגדרת דגל שקובע אם אובייקט המודעה המתגמלת יוצג במצב immersive.
`abstract void`	`setOnAdMetadataChangedListener( @Nullable OnAdMetadataChangedListener listener )` הגדרת `OnAdMetadataChangedListener` ל-`RewardedAd` הזה.
`abstract void`	`setOnPaidEventListener(@Nullable OnPaidEventListener listener)` רושמת קריאה חוזרת להפעלה כשהמערכת מעריכה שהמודעה הזו הניבה רווחים.
`abstract void`	`setPlacementId(long placementId)` מגדיר מזהה מיקום של המודעה המתגמלת.
`abstract void`	`setServerSideVerificationOptions( @Nullable ServerSideVerificationOptions options )` מגדיר את `ServerSideVerificationOptions` עבור `RewardedAd`.
`abstract void`	`show( @NonNull Activity activity, @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener )` הצגת המודעה המתגמלת.

בוני אובייקטים ציבוריים

RewardedAd

public RewardedAd()

שיטות ציבוריות

getAdMetadata

public abstract Bundle getAdMetadata()

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

getAdUnitId

public abstract @NonNull String getAdUnitId()

מחזירה את המזהה של יחידת המודעות.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

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

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

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

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

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

getPlacementId

public abstract long getPlacementId()

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

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

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

getRewardItem

public abstract @NonNull RewardItem getRewardItem()

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

isAdAvailable

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

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

משקל

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

טעינה של RewardedAd.

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

משקל

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

טעינה של RewardedAd.

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

pollAd

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

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

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

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

setOnAdMetadataChangedListener

public abstract void setOnAdMetadataChangedListener(
    @Nullable OnAdMetadataChangedListener listener
)

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

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

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

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

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

setServerSideVerificationOptions

public abstract void setServerSideVerificationOptions(
    @Nullable ServerSideVerificationOptions options
)

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

הצג

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

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

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