Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

RewardedAd

Kotlin |Java

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

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

تعرِض هذه الطريقة true إذا كان هناك إعلان مقابل مكافأة متاح تم تحميله من startPreload.

حمولة

java-static fun load(
    context: Context,
    adUnitId: String,
    adManagerAdRequest: AdManagerAdRequest,
    loadCallback: RewardedAdLoadCallback
): Unit

تحميل RewardedAd

المعلمات
`context: Context`	السياق
`adUnitId: String`	رقم تعريف الوحدة الإعلانية.
`adManagerAdRequest: AdManagerAdRequest`	طلب إعلان في "مدير إعلانات Google" يتضمّن معلومات الاستهداف
`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 لموضع الإعلان الذي تم ضبط إعداداته.

setServerSideVerificationOptions

abstract fun setServerSideVerificationOptions(
    options: ServerSideVerificationOptions?
): Unit

يضبط ServerSideVerificationOptions لـ RewardedAd.

إظهار

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

تعرِض هذه الطريقة الإعلان مقابل مكافأة.

المعلمات
`activity: Activity`	النشاط الذي يجب عرض "الإعلان مقابل مكافأة" منه
`onUserEarnedRewardListener: OnUserEarnedRewardListener`	يجب إعلام أداة معالجة الأحداث هذه عندما يحصل المستخدم على مكافأة.