آگهی‌های بینابینی

پلاتفرم را انتخاب کنید: Android iOS Unity Flutter Android (Legacy)

آگهی‌های بینابینی آگهی‌های تمام‌صفحه‌ای هستند که میانای برنامه میزبانشان را می‌پوشانند. این آگهی‌ها معمولاً در نقاط انتقال طبیعی در جریان برنامه نمایش داده می‌شوند، مثلاً بین فعالیت‌ها یا درطول مکث بین مراحل بازی. وقتی برنامه‌ای آگهی بینابینی نشان می‌دهد، کاربر می‌تواند روی آگهی تک‌ضرب بزند و به مقصد آن برود یا آن را ببندد و به برنامه برگردد.

این راهنما نحوه ادغام آگهی‌های بینابینی در برنامه Flutter را توضیح می‌دهد.

همیشه با آگهی‌های آزمایشی آزمایش کنید

هنگام ساختن و آزمایش کردن برنامه‌هایتان، حتماً از آگهی‌های آزمایشی استفاده کنید نه آگهی‌های زنده و تولیدی. انجام ندادن این کار می‌تواند منجر به تعلیق حسابتان شود.

ساده‌ترین راه برای بار کردن آگهی‌های آزمایشی، استفاده از شناسه واحد آگهی آزمایشی اختصاصی ما برای آگهی‌های بینابینی است:

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

واحدهای آگهی آزمایشی به‌گونه‌ای پیکربندی شده‌اند که برای هر درخواست، آگهی آزمایشی برگردانند و می‌توانید آزادانه از آن‌ها در برنامه‌های خودتان هنگام کدنویسی، آزمایش، و اشکال‌زدایی استفاده کنید. فقط مطمئن شوید که قبل‌از انتشار برنامه‌تان، آن‌ها را با شناسه واحد آگهی خودتان جایگزین کنید.

بار کردن آگهی

مثال زیر یک آگهی بینابینی را بار می‌کند:

InterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdRequest(),
  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');
    },
  ),
);

_adUnitId را با شناسه واحد آگهی خودتان جایگزین کنید.

رویدادهای آگهی بینابینی

بااستفاده از FullScreenContentCallback، می‌توانید به رویدادهای چرخه حیات گوش دهید، مثلاً وقتی آگهی نشان داده می‌شود یا بسته می‌شود. InterstitialAd.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.');
  },
);

نمایش آگهی بینابینی

InterstitialAd به‌صورت Overlay در بالای همه محتوای برنامه نمایش داده می‌شود و به‌صورت ایستا قرار می‌گیرد؛ بنابراین، نمی‌توان آن را به درخت ابزاره Flutter اضافه کرد. با فراخوانی show() می‌توانید انتخاب کنید آگهی چه زمانی نشان داده شود.

_interstitialAd?.show();

وقتی show() فراخوانده می‌شود، Ad که به این روش نمایش داده می‌شود را نمی‌توان به‌صورت برنامه‌نویسی رد کرد و به ورودی کاربر نیاز دارد. InterstitialAd فقط یک‌بار می‌تواند نشان داده شود. فراخوانی‌های بعدی برای نمایش، onAdFailedToShowFullScreenContent را راه‌اندازی می‌کند.

وقتی دیگر به آگهی نیازی نیست، باید آن را دور انداخت. بهترین روش برای زمان فراخوانی dispose() در فراخوانی‌های برگشتی FullScreenContentCallback.onAdDismissedFullScreenContent و FullScreenContentCallback.onAdFailedToShowFullScreenContent است.

فقط همین! اکنون برنامه‌تان برای نمایش آگهی‌های بینابینی آماده است.

مراحل بعدی

نمونه کامل در GitHub

برای مشاهده نمونه کامل، نسخه نمایشی میانای برنامه‌سازی کاربردی را ببینید.