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 @NonNull ResponseInfo	getResponseInfo() تعرِض هذه الدالة عنصر ResponseInfo للإعلان المحمَّل.
abstract @NonNull RewardItem	getRewardItem() تحصل على عنصر المكافأة للإعلان الذي يضم مكافأة الذي تم تحميله.
static boolean	isAdAvailable(@NonNull Context context, @NonNull String adUnitId) تعرِض هذه السمة القيمة true إذا كان هناك إعلان متوفّر يضم مكافأة تم تحميله من startPreload.
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) تسترجع الإعلان التالي الذي يضم مكافأة ويتم تحميله من startPreload أو null إذا لم يكن هناك إعلان متاح.
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	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.

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)

تسجِّل هذه الدالة طلبًا لردّ الاتصال يتمّ تنفيذه عندما يُقدَّر أنّ هذا الإعلان قد حقّق أرباحًا.

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