بینابینی

پلتفرم مورد نظر: اندروید، iOS، یونیتی ، فلاتر

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

این راهنما نحوه ادغام تبلیغات بینابینی را در یک برنامه 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 است.

تمام! برنامه شما اکنون آماده نمایش تبلیغات بینابینی است.

مراحل بعدی