برای گفتگو و ارائه بازخورد در مورد محصولات ما، به کانال رسمی AdMob Discord در سرور انجمن تبلیغات و اندازه‌گیری Google بپیوندید.

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

Rewarded Ad

کاتلین | جاوا

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 )` تبلیغ پاداش را نشان می دهد.

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

Rewarded Ad

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

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

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

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

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

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

یک شناسه مکان برای تبلیغ پاداش تعیین می کند.

برای اطمینان از اینکه این شناسه مکان در گزارش گنجانده شده است، قبل از نمایش آگهی با این روش تماس بگیرید.

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

setServerSideVerificationOptions

abstract fun setServerSideVerificationOptions(
    options: ServerSideVerificationOptions?
): Unit

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

نشان می دهد

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

تبلیغ پاداش را نشان می دهد.

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