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