لمناقشة منتجاتنا وتقديم ملاحظات بشأنها، انضمّ إلى قناة Discord الرسمية في منتدى Google للإعلان وقياس الأداء.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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`	يجب إعلام المستمع عندما يحصل المستخدم على مكافأة.