الإعلانات التي تضم مكافأة هي إعلانات يتوفّر للمستخدمين خيار التفاعل معها في مقابل للحصول على مكافآت داخل التطبيق يعرض هذا الدليل طريقة دمج الإعلانات التي تضم مكافأة من "مدير الإعلانات" في تطبيق Flutter
الاختبار دائمًا باستخدام الإعلانات الاختبارية
عند إنشاء تطبيقاتك واختبارها، احرص على استخدام إعلانات اختبارية بدلاً من الإعلانات المنشورة. وقد يؤدي عدم الالتزام بذلك إلى تعليق حسابك.
أسهل طريقة لتحميل الإعلانات الاختبارية هي استخدام الرقم التعريفي المخصص للوحدة الإعلانية الاختبارية الإعلانات التي تضم مكافأة:
/21775744923/example/rewarded
يتم ضبط الوحدات الإعلانية الاختبارية لعرض إعلانات اختبارية لكل طلب يمكنك استخدامها في تطبيقاتك الخاصة أثناء الترميز والاختبار وتصحيح الأخطاء. ما عليك سوى التأكد من استبدالها بأرقام تعريف الوحدات الإعلانية لديك قبل نشر التطبيق.
تحميل إعلان
في ما يلي مثال يحمّل إعلانًا يضم مكافأة:
class RewardedExampleState extends State<RewardedExample> { RewardedAd? _rewardedAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/21775744923/example/rewarded'; /// Loads a rewarded ad. void loadAd() { RewardedAd.loadWithAdManagerAdRequest( adUnitId: adUnitId, adManagerAdRequest: const AdManagerAdRequest(), adLoadCallback: RewardedAdLoadCallback( // Called when an ad is successfully received. onAdLoaded: (ad) { debugPrint('$ad loaded.'); // Keep a reference to the ad so you can show it later. _rewardedAd = ad; }, // Called when an ad request failed. onAdFailedToLoad: (LoadAdError error) { debugPrint('RewardedAd failed to load: $error'); }, )); } }
أحداث الإعلانات التي تضم مكافأة
من خلال استخدام "FullScreenContentCallback
"، يمكنك رصد جميع مراحل النشاط.
الأحداث، مثل وقت عرض الإعلان أو رفضه. ضبط
RewardedAd.fullScreenContentCallback
قبل عرض الإعلان الذي تريد استلامه
الإشعارات لهذه الأحداث. ينفذ هذا المثال كل طريقة ويسجل
إلى وحدة التحكم:
class RewardedExampleState extends State<RewardedExample> { RewardedAd? _rewardedAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/21775744923/example/rewarded'; /// Loads a rewarded ad. void loadAd() { RewardedAd.loadWithAdManagerAdRequest( adUnitId: adUnitId, adManagerAdRequest: const AdManagerAdRequest(), adLoadCallback: RewardedAdLoadCallback( // Called when an ad is successfully received. onAdLoaded: (ad) { ad.fullScreenContentCallback = FullScreenContentCallback( // Called when the ad showed the full screen content. onAdShowedFullScreenContent: (ad) {}, // Called when an impression occurs on the ad. onAdImpression: (ad) {}, // Called when the ad failed to show full screen content. onAdFailedToShowFullScreenContent: (ad, err) { // Dispose the ad here to free resources. ad.dispose(); }, // Called when the ad dismissed full screen content. onAdDismissedFullScreenContent: (ad) { // Dispose the ad here to free resources. ad.dispose(); }, // Called when a click is recorded for an ad. onAdClicked: (ad) {}); debugPrint('$ad loaded.'); // Keep a reference to the ad so you can show it later. _rewardedAd = ad; }, // Called when an ad request failed. onAdFailedToLoad: (LoadAdError error) { debugPrint('RewardedAd failed to load: $error'); }, )); } }
إعلان صوري
يتم عرض RewardedAd
كتراكب في أعلى كل محتوى التطبيق
ذات موضع ثابت؛ وبالتالي، لا يمكن إضافته إلى شجرة تطبيقات Flutter المصغّرة. يمكنك
يمكنك اختيار وقت عرض الإعلان من خلال الاتصال بالرقم show()
.
يأخذ الإجراء RewardedAd.show()
OnUserEarnedRewardCallback
، والذي يتمّ استدعاؤه عند
حصول المستخدم على مكافأة. احرص على تنفيذ ذلك ومنح المستخدم مكافأة مقابل
مشاهدة إعلان.
_rewardedAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) { // Reward the user for watching an ad. });
بعد استدعاء show()
، لا يمكن إزالة Ad
المعروض بهذه الطريقة.
آليًا ويتطلب إدخال المستخدم. لا يمكن عرض RewardedAd
سوى
مرّة واحدة. وسيؤدي إظهار المكالمات اللاحقة إلى تشغيل onAdFailedToShowFullScreenContent
.
يجب التخلص من الإعلان عند عدم الحاجة إلى الوصول إليه. أفضل ممارسة
لمعرفة موعد الاتصال بـ dispose()
في
FullScreenContentCallback.onAdDismissedFullScreenContent
و
FullScreenContentCallback.onAdFailedToShowFullScreenContent
طلبات معاودة الاتصال
هذا كل شيء! أصبح تطبيقك جاهزًا الآن لعرض الإعلانات التي تضم مكافأة.