آگهی‌های بینابینی پاداش‌دار

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

بینابینی پاداش‌دار نوعی قالب آگهی تشویقی است که به شما امکان می‌دهد برای آگهی‌هایی که به‌طور خودکار درطول انتقال‌های طبیعی برنامه ظاهر می‌شوند، پاداش ارائه دهید. برخلاف آگهی‌های پاداش‌دار، کاربران برای مشاهده آگهی بینابینی پاداش‌دار ملزم به موافقت نیستند. این راهنما نشان می‌دهد که چگونه آگهی‌های بینابینی پاداش‌دار را از AdMob در برنامه Flutter ادغام کنید.

پیش‌نیازها

پیش‌از ادامه دادن، کارهای زیر را انجام دهید:

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

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

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

Android

ca-app-pub-3940256099942544/5354046379

iOS

ca-app-pub-3940256099942544/6978759866

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

بار کردن آگهی

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

RewardedInterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdRequest(),
  rewardedInterstitialAdLoadCallback: RewardedInterstitialAdLoadCallback(
    onAdLoaded: (RewardedInterstitialAd ad) {
      // Called when an ad is successfully received.
      debugPrint('Ad was loaded.');
      // Keep a reference to the ad so you can show it later.
      _rewardedInterstitialAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      // Called when an ad request failed.
      debugPrint('Ad failed to load with error: $error');
    },
  ),
);

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

رویدادهای آگهی بینابینی پاداش‌دار

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

آگهی تصویری

RewardedInterstitialAd به‌عنوان «برافزایی» روی همه محتوای برنامه نمایش داده می‌شود و به‌صورت ایستا قرار می‌گیرد؛ بنابراین، نمی‌توان آن را به درخت ابزاره Flutter اضافه کرد. با فراخوانی show() می‌توانید انتخاب کنید آگهی چه زمانی نشان داده شود. ‫RewardedInterstitialAd.show() یک OnUserEarnedRewardCallback می‌گیرد که وقتی کاربر پاداشی کسب می‌کند فراخوانده می‌شود. حتماً این مورد را پیاده‌سازی کنید و به کاربر برای تماشای آگهی پاداش دهید.

_rewardedInterstitialAd?.show(
  onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) {
    debugPrint('Reward amount: ${rewardItem.amount}');
  },
);

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

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

[اختیاری] اعتبارسنجی تماس‌های برگشتی درستی‌سنجی سمت سرور (SSV)

برنامه‌هایی که به داده‌های اضافی در بازخوانی‌های درستی‌سنجی سمت سرور نیاز دارند باید از ویژگی داده‌های سفارشی آگهی‌های پاداشی استفاده کنند. هر مقدار رشته‌ای که در شیء آگهی پاداش‌دار تنظیم شده باشد به پارامتر پُرسمان custom_data فراخوان SSV ارسال می‌شود. اگر مقدار داده سفارشی تنظیم نشده باشد، مقدار پارامتر پُرسمان custom_data در فراخوانی SSV وجود نخواهد داشت.

نمونه کد زیر نشان می‌دهد که چگونه گزینه‌های SSV را پس‌از بارگیری آگهی بینابینی پاداش‌دار تنظیم کنید:

RewardedInterstitialAd.load(
  adUnitId: "_adUnitId",
  request: AdRequest(),
  rewardedInterstitialAdLoadCallback: RewardedInterstitialAdLoadCallback(
    onAdLoaded: (ad) {
      ServerSideVerificationOptions _options =
          ServerSideVerificationOptions(
            customData: 'SAMPLE_CUSTOM_DATA_STRING',
          );
      ad.setServerSideOptions(_options);
      _rewardedInterstitialAd = ad;
    },
    onAdFailedToLoad: (error) {},
  ),
);

SAMPLE_CUSTOM_DATA_STRING را با داده‌های سفارشی‌تان جایگزین کنید.

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

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