تبلیغات پاداشی

کاتلین | جاوا

public abstract class RewardedAd

---

This class is used to request and display a rewarded ad.

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 () Gets all available ad metadata for this RewardedAd .
abstract @ NonNull String	getAdUnitId () شناسه واحد تبلیغ را برمی‌گرداند.
abstract @ Nullable FullScreenContentCallback	getFullScreenContentCallback () Gets the FullScreenContentCallback for this RewardedAd .
abstract @ Nullable OnAdMetadataChangedListener	getOnAdMetadataChangedListener () Gets the OnAdMetadataChangedListener for this RewardedAd .
abstract @ Nullable OnPaidEventListener	getOnPaidEventListener () Gets the OnPaidEventListener for this 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 ) Registers a callback to be invoked when ads show and dismiss full screen content.
abstract void	setImmersiveMode (boolean immersiveModeEnabled) Sets a flag that controls if this rewarded ad object will be displayed in immersive mode.
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 ) Sets ServerSideVerificationOptions for this RewardedAd .
abstract void	show ( @ NonNull Activity activity, @ NonNull OnUserEarnedRewardListener onUserEarnedRewardListener ) تبلیغ جایزه‌دار را نشان می‌دهد.

سازندگان عمومی

تبلیغات پاداشی

public RewardedAd()

روش‌های عمومی

دریافت فراداده Ad

public abstract Bundle getAdMetadata()

تمام فراداده‌های تبلیغ موجود برای این RewardedAd را دریافت می‌کند. اگر تبلیغ بارگذاری شده فراداده نداشته باشد، فراداده تبلیغ خالی است. فراداده تبلیغ ممکن است پس از بارگذاری به‌روزرسانی شود. برای دریافت تغییرات onAdMetadataChanged استفاده کنید.

دریافت شناسه واحد تبلیغات

public abstract @NonNull String getAdUnitId()

شناسه واحد تبلیغ را برمی‌گرداند.

فراخوانی برگشتی محتوای تمام‌صفحه

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Gets the FullScreenContentCallback for this RewardedAd .

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

OnAdMetadataChangedListener برای این RewardedAd دریافت می‌کند.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Gets the OnPaidEventListener for this RewardedAd .

دریافت شناسه‌ی مکان

public abstract long getPlacementId()

شناسه قرارگیری را برای این RewardedAd دریافت می‌کند.

دریافت اطلاعات پاسخ

public abstract @NonNull ResponseInfo getResponseInfo()

شیء ResponseInfo را برای تبلیغ بارگذاری شده برمی‌گرداند.

دریافت آیتم پاداش

public abstract @NonNull RewardItem getRewardItem()

برای تبلیغ جایزه‌دار بارگذاری‌شده، آیتم جایزه دریافت می‌کند.

موجود است

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

این روش منسوخ شده است.

به جای آن isAdAvailable استفاده کنید.

اگر یک تبلیغ جایزه‌دار از startPreload بارگذاری شده باشد، true را برمی‌گرداند.

بار

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	A Google Ad Manager ad request with targeting information.
@ NonNull RewardedAdLoadCallback loadCallback	A callback to be invoked when a rewarded ad finishes loading.

بار

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	یک فراخوانی برگشتی که پس از اتمام بارگذاری یک تبلیغ جایزه‌دار فراخوانی می‌شود.

نظرسنجی

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

این روش منسوخ شده است.

به جای آن pollAd استفاده کنید.

تبلیغ پاداش‌دار بعدی که از startPreload بارگذاری شده است را بازیابی می‌کند، یا اگر تبلیغی در دسترس نباشد null برمی‌گرداند.

فراخوانی برگشتی محتوای تمام‌صفحه

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

یک فراخوانی مجدد ثبت می‌کند تا هنگام نمایش و رد محتوای تمام صفحه توسط تبلیغات، فراخوانی شود.

حالت فراگیر (ImmersiveMode) را تنظیم کنید

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

یک پرچم تنظیم می‌کند که کنترل می‌کند آیا این شیء تبلیغ جایزه‌دار در حالت فراگیر نمایش داده شود یا خیر. این متد را قبل از 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)

یک تابع فراخوانی ثبت می‌کند تا زمانی که تخمین زده شود این تبلیغ درآمد کسب کرده است، فراخوانی شود.

شناسه‌ی جایگذاری را تنظیم کنید

public abstract void setPlacementId(long placementId)

یک شناسه قرارگیری برای تبلیغ جایزه‌دار تعیین می‌کند.

برای اطمینان از اینکه این شناسه‌ی قرارگیری در گزارش‌دهی لحاظ شده است، قبل از نمایش تبلیغ، این متد را فراخوانی کنید.

پارامترها
long placementId	یک عدد صحیح طولانی که توسط رابط کاربری AdMob برای مکان‌یابی پیکربندی‌شده ارائه شده است.

گزینه‌های تأیید سمت سرور را تنظیم کنید

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	شنونده‌ای که وقتی کاربر پاداشی کسب می‌کند، مطلع می‌شود.