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

סיכום

‫constructors ציבוריים
RewardedAd()

‫methods ציבוריות
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) הmethod הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-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) הmethod הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-pollAd.
abstract void	setFullScreenContentCallback(     @Nullable FullScreenContentCallback fullScreenContentCallback ) רושמת קריאה חוזרת (callback) שתופעל כשמודעות מוצגות ומבטלות תוכן במסך מלא.
abstract void	setImmersiveMode(boolean immersiveModeEnabled) מגדירה דגל שקובע אם אובייקט המודעה המתגמלת הזה יוצג במצב אימרסיבי.
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 ) מציגה את המודעה המתגמלת.

‫constructors ציבוריים

RewardedAd

public RewardedAd()

‫methods ציבוריות

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)

ה-method הזו הוצאה משימוש.

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

מחזירה 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)

ה-method הזו הוצאה משימוש.

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

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

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

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

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

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

פרמטרים
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	המאזין שיקבל הודעה כשהמשתמש יקבל תגמול.