این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

کاتلین | جاوا

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

کارکردهای عمومی

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

abstract fun getAdMetadata(): Bundle!

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

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

abstract fun getAdUnitId(): String

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

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

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

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

getOnAdMetadataChangedListener

abstract fun getOnAdMetadataChangedListener(): OnAdMetadataChangedListener?

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

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

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

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

abstract fun getPlacementId(): Long

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

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

abstract fun getResponseInfo(): ResponseInfo

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

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

abstract fun getRewardItem(): RewardItem

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

موجود است

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

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

بار

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

نظرسنجی

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

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

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

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

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

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

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

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

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

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

abstract fun setPlacementId(placementId: Long): Unit

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

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

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

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

abstract fun setServerSideVerificationOptions(
    options: ServerSideVerificationOptions?
): Unit

ServerSideVerificationOptions را برای این RewardedAd تنظیم می‌کند.

نشان دادن

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

تبلیغ جایزه‌دار را نشان می‌دهد.

پارامترها
`activity: Activity`	فعالیتی که باید از آن تبلیغ جایزه‌دار نمایش داده شود.
`onUserEarnedRewardListener: OnUserEarnedRewardListener`	شنونده‌ای که وقتی کاربر پاداشی کسب می‌کند، مطلع می‌شود.