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

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

Rewarded Ad

کاتلین | جاوا

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

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

Rewarded Ad

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)

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

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

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

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

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

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