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

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

RewardedAd

Kotlin |Java

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 )` تعرِض هذه السمة الإعلان مقابل مكافأة.

الدوال الإنشائية العامة

RewardedAd

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)

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

حمولة

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" يتضمّن معلومات الاستهداف
`@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 للموضع الإعلاني الذي تم ضبطه.

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