পুরস্কৃত

পুরস্কৃত বিজ্ঞাপন হল সেই বিজ্ঞাপন যা ব্যবহারকারীদের অ্যাপ-মধ্যস্থ পুরস্কারের বিনিময়ে ইন্টারঅ্যাক্ট করার বিকল্প থাকে। এই নির্দেশিকাটি দেখায় যে কীভাবে Ad Manager থেকে পুরস্কৃত বিজ্ঞাপনগুলিকে একটি Flutter অ্যাপে একীভূত করতে হয়।

সর্বদা পরীক্ষার বিজ্ঞাপন দিয়ে পরীক্ষা করুন

আপনার অ্যাপ তৈরি এবং পরীক্ষা করার সময়, নিশ্চিত করুন যে আপনি লাইভ, প্রোডাকশন বিজ্ঞাপনের পরিবর্তে পরীক্ষামূলক বিজ্ঞাপন ব্যবহার করছেন। এটি করতে ব্যর্থ হলে আপনার অ্যাকাউন্ট স্থগিত হতে পারে।

পরীক্ষার বিজ্ঞাপন লোড করার সবচেয়ে সহজ উপায় হল পুরস্কৃত বিজ্ঞাপনের জন্য আমাদের ডেডিকেটেড টেস্ট বিজ্ঞাপন ইউনিট আইডি ব্যবহার করা:

• /6499/example/rewarded

পরীক্ষার বিজ্ঞাপন ইউনিটগুলি প্রতিটি অনুরোধের জন্য পরীক্ষার বিজ্ঞাপনগুলি ফেরত দেওয়ার জন্য কনফিগার করা হয়েছে এবং আপনি কোডিং, পরীক্ষা এবং ডিবাগ করার সময় আপনার নিজের অ্যাপগুলিতে সেগুলি ব্যবহার করতে পারবেন৷ আপনার অ্যাপ প্রকাশ করার আগে শুধু নিশ্চিত করুন যে আপনি সেগুলিকে আপনার নিজস্ব বিজ্ঞাপন ইউনিট আইডি দিয়ে প্রতিস্থাপন করেছেন।

একটি বিজ্ঞাপন লোড করুন

নিম্নলিখিত উদাহরণটি একটি পুরস্কৃত বিজ্ঞাপন লোড করে:

class RewardedExampleState extends State<RewardedExample> {
  RewardedAd? _rewardedAd;

  // TODO: replace this test ad unit with your own ad unit.
  final adUnitId = '/6499/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 = '/6499/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');
          },
        ));
  }
}

মূল পয়েন্ট: একটি বিজ্ঞাপন দেখার জন্য ব্যবহারকারীকে পুরস্কৃত করার জন্য onRewardedAdUserEarnedReward ইভেন্টটি বাস্তবায়ন করা নিশ্চিত করুন।

বিজ্ঞাপন প্রদর্শন করুন

একটি RewardedAd সমস্ত অ্যাপ সামগ্রীর উপরে একটি ওভারলে হিসাবে প্রদর্শিত হয় এবং স্থিরভাবে স্থাপন করা হয়; সুতরাং, এটি ফ্লাটার উইজেট ট্রিতে যোগ করা যাবে না। আপনি 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 কলব্যাক।

এটাই! আপনার অ্যাপ এখন পুরস্কৃত বিজ্ঞাপন প্রদর্শনের জন্য প্রস্তুত।