الإعلانات البينية

اختيار النظام الأساسي: Android جديد Android iOS Unity Flutter

الإعلانات البينية هي إعلانات بملء الشاشة تغطي واجهة التطبيق المضيف. وعادةً ما تظهر في نقاط الانتقال العادية في تدفق التطبيق، مثلاً بين الأنشطة أو أثناء فترة الإيقاف المؤقت بين المستويات في الألعاب. عندما يعرض التطبيق إعلانًا بينيًا، يمكن للمستخدم إما النقر على الإعلان والانتقال إلى وجهته أو إغلاقه والعودة إلى التطبيق.

يشرح هذا الدليل كيفية دمج الإعلانات البينية في تطبيق Flutter.

الاختبار دائمًا باستخدام الإعلانات الاختبارية

عند إنشاء تطبيقاتك واختبارها، احرص على استخدام الإعلانات الاختبارية بدلاً من الإعلانات الفعلية المعروضة للمستخدمين. وقد يؤدي عدم إجراء ذلك إلى تعليق حسابك.

أسهل طريقة لتحميل الإعلانات الاختبارية هي استخدام رقم تعريف الوحدة الإعلانية الاختبارية المخصّص للإعلانات البينية:

  • /21775744923/example/interstitial

تم ضبط الوحدات الإعلانية الاختبارية لعرض إعلانات اختبارية لكل طلب، ويمكنك استخدامها في تطبيقاتك أثناء الترميز والاختبار وتحديد الأخطاء وحلّها. ما عليك سوى استبدالها بأرقام تعريف الوحدات الإعلانية الخاصة بك قبل نشر تطبيقك.

تحميل إعلان

يعرض المثال التالي كيفية تحميل إعلان بيني:

InterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdManagerAdRequest(),
  adLoadCallback: InterstitialAdLoadCallback(
    onAdLoaded: (InterstitialAd ad) {
      // Called when an ad is successfully received.
      debugPrint('Ad was loaded.');
      // Keep a reference to the ad so you can show it later.
      _interstitialAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      // Called when an ad request failed.
      debugPrint('Ad failed to load with error: $error');
    },
  ),
);
interstitial_ad_snippets.dart

استبدِل _adUnitId برقم تعريف الوحدة الإعلانية الخاصة بك.

أحداث الإعلانات البينية

باستخدام FullScreenContentCallback، يمكنك الاستماع إلى أحداث مراحل نشاط الإعلان، مثل وقت ظهور الإعلان أو إغلاقه. اضبط AdManagerInterstitialAd.fullScreenContentCallback قبل عرض الإعلان لتلقّي إشعارات بشأن هذه الأحداث. يعرض هذا المثال كيفية تنفيذ كل طريقة:

ad.fullScreenContentCallback = FullScreenContentCallback(
  onAdShowedFullScreenContent: (ad) {
    // Called when the ad showed the full screen content.
    debugPrint('Ad showed full screen content.');
  },
  onAdFailedToShowFullScreenContent: (ad, err) {
    // Called when the ad failed to show full screen content.
    debugPrint('Ad failed to show full screen content with error: $err');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdDismissedFullScreenContent: (ad) {
    // Called when the ad dismissed full screen content.
    debugPrint('Ad was dismissed.');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdImpression: (ad) {
    // Called when an impression occurs on the ad.
    debugPrint('Ad recorded an impression.');
  },
  onAdClicked: (ad) {
    // Called when a click is recorded for an ad.
    debugPrint('Ad was clicked.');
  },
);
interstitial_ad_snippets.dart

عرض إعلان بيني

يتم عرض AdManagerInterstitialAd كـ Overlay أعلى كل محتوى التطبيق ويتم وضعه بشكل ثابت، لذا لا يمكن إضافته إلى شجرة عناصر واجهة مستخدم Flutter. يمكنك اختيار وقت عرض الإعلان من خلال استدعاء show().

_interstitialAd?.show();
main.dart

بعد استدعاء show()، لا يمكن إغلاق Ad المعروض بهذه الطريقة آليًا ويتطلب بيانات أدخلها المستخدم. لا يمكن عرض AdManagerInterstitialAd إلا مرة واحدة. وستؤدي عمليات استدعاء `show` اللاحقة إلى تفعيل onAdFailedToShowFullScreenContent.

يجب إيقاف الإعلان عندما لا يعود هناك حاجة إلى الوصول إليه. أفضل ممارسة لتحديد وقت استدعاء dispose() هي في معاودة الاتصال FullScreenContentCallback.onAdDismissedFullScreenContent وFullScreenContentCallback.onAdFailedToShowFullScreenContent.

هذا كل شيء! تطبيقك الآن جاهز لعرض الإعلانات البينية.

الخطوات التالية