পুরস্কৃত বিজ্ঞাপন


রিওয়ার্ডেড অ্যাড ব্যবহারকারীদের অ্যাপের ভেতরের পুরস্কারের বিনিময়ে সেগুলোর সাথে ইন্টারঅ্যাক্ট করার সুযোগ দেয়। এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে Google Mobile Ads C++ SDK ব্যবহার করে অ্যান্ড্রয়েড এবং iOS অ্যাপে রিওয়ার্ডেড অ্যাড ইন্টিগ্রেট করতে হয়।

কিছু গ্রাহক সাফল্যের গল্প পড়ুন: কেস স্টাডি ১ , কেস স্টাডি ২ ।

পূর্বশর্ত

সর্বদা টেস্ট অ্যাড দিয়ে পরীক্ষা করুন

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

টেস্ট অ্যাড লোড করার সবচেয়ে সহজ উপায় হলো রিওয়ার্ডেড অ্যাডের জন্য আমাদের ডেডিকেটেড টেস্ট অ্যাড ইউনিট আইডি ব্যবহার করা, যা ডিভাইস প্ল্যাটফর্ম অনুযায়ী ভিন্ন ভিন্ন হয়:

  • অ্যান্ড্রয়েড: ca-app-pub-3940256099942544/5224354917
  • iOS: ca-app-pub-3940256099942544/1712485313

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

মোবাইল অ্যাডস এসডিকে-এর টেস্ট অ্যাডগুলো কীভাবে কাজ করে সে সম্পর্কে আরও তথ্যের জন্য, টেস্ট অ্যাডস দেখুন।

বাস্তবায়ন

রিওয়ার্ডেড অ্যাড ইন্টিগ্রেট করার প্রধান ধাপগুলো হলো:

  1. একটি বিজ্ঞাপন লোড করুন।
  2. কলব্যাকের জন্য নিবন্ধন করুন।
  3. বিজ্ঞাপনটি প্রদর্শন করুন এবং পুরস্কার ইভেন্টটি পরিচালনা করুন।

একটি RewardedAd কনফিগার করুন

রিওয়ার্ডেড বিজ্ঞাপনগুলো RewardedAd অবজেক্টে প্রদর্শিত হয়, তাই আপনার অ্যাপে রিওয়ার্ডেড বিজ্ঞাপন যুক্ত করার প্রথম ধাপ হলো RewardedAd এর একটি ইনস্ট্যান্স তৈরি এবং ইনিশিয়ালাইজ করা।

  1. আপনার অ্যাপের C++ কোডে নিম্নলিখিত হেডারটি যোগ করুন:

     #include "firebase/gma/rewarded_ad.h"

  2. একটি RewardedAd অবজেক্ট ঘোষণা এবং ইনস্ট্যানশিয়েট করুন:

     firebase::gma::RewardedAd* rewarded_ad;
 rewarded_ad = new firebase::gma::RewardedAd();

  3. আপনার প্যারেন্ট ভিউকে AdParent টাইপে কাস্ট করে RewardedAd ইনস্ট্যান্সটি ইনিশিয়ালাইজ করুন। প্যারেন্ট ভিউ হলো একটি Android Activity র JNI jobject রেফারেন্স অথবা একটি iOS UIView এর পয়েন্টার।

    // my_ad_parent is a jobject reference to an Android Activity or
// a pointer to an iOS UIView.
firebase::gma::AdParent ad_parent =
  static_cast<firebase::gma::AdParent>(my_ad_parent);
firebase::Future<void> result = rewarded_ad->Initialize(ad_parent);

  4. ভবিষ্যৎকে একটি ভেরিয়েবল হিসেবে ধরে রাখার বিকল্প হিসেবে, আপনি RewardedAd অবজেক্টে InitializeLastResult() কল করে পর্যায়ক্রমে ইনিশিয়ালাইজেশন অপারেশনের অবস্থা পরীক্ষা করতে পারেন। এটি আপনার গ্লোবাল গেম লুপে ইনিশিয়ালাইজেশন প্রক্রিয়ার উপর নজর রাখতে সহায়ক হতে পারে।

    // Monitor the status of the future in your game loop:
firebase::Future<void> result = rewarded_ad->InitializeLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  // Initialization completed.
  if(future.error() == firebase::gma::kAdErrorCodeNone) {
    // Initialization successful.
  } else {
    // An error has occurred.
  }
} else {
  // Initialization on-going.
}

firebase::Future নিয়ে কাজ করার বিষয়ে আরও তথ্যের জন্য, "Use Futures to monitor the completion status of method calls" দেখুন।

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

একটি RewardedAd অবজেক্টের LoadAd() মেথড ব্যবহার করে বিজ্ঞাপন লোড করা হয়। এই লোড মেথডটি ব্যবহার করার জন্য RewardedAd অবজেক্টটি ইনিশিয়ালাইজ করা, আপনার অ্যাড ইউনিট আইডি এবং একটি AdRequest অবজেক্ট থাকা আবশ্যক। এর ফলে একটি firebase::Future রিটার্ন করা হয়, যা ব্যবহার করে আপনি লোড অপারেশনের অবস্থা এবং ফলাফল পর্যবেক্ষণ করতে পারেন।

নিম্নলিখিত কোডটি দেখায় কিভাবে RewardedAd সফলভাবে ইনিশিয়ালাইজ হয়ে গেলে একটি বিজ্ঞাপন লোড করতে হয়:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = rewarded_ad->LoadAd(rewarded_ad_unit_id, ad_request);

কলব্যাকের জন্য নিবন্ধন করুন

রিওয়ার্ডেড অ্যাড প্রদর্শন এবং লাইফসাইকেল ইভেন্টের নোটিফিকেশন পেতে হলে আপনাকে অবশ্যই FullScreenContentListener ক্লাসটি এক্সটেন্ড করতে হবে। আপনার কাস্টম FullScreenContentListener সাবক্লাসটি RewardedAd::SetFullScreenContentListener() মেথডের মাধ্যমে রেজিস্টার করা যাবে, এবং অ্যাডটি সফলভাবে বা অসফলভাবে প্রদর্শিত হলে, কিংবা ডিসমিস করা হলে এটি কলব্যাক পাবে।

নিম্নলিখিত কোডটি দেখায় কিভাবে ক্লাসটি এক্সটেন্ড করতে হয় এবং এটিকে ad-তে অ্যাসাইন করতে হয়:

  class ExampleFullScreenContentListener
      : public firebase::gma::FullScreenContentListener {

   public:
    ExampleFullScreenContentListener() {}

    void OnAdClicked() override {
      // This method is invoked when the user clicks the ad.
    }

    void OnAdDismissedFullScreenContent() override {
     // This method is invoked when the ad dismisses full screen content.
    }

    void OnAdFailedToShowFullScreenContent(const AdError& error) override {
      // This method is invoked when the ad failed to show full screen content.
      // Details about the error are contained within the AdError parameter.
    }

    void OnAdImpression() override {
      // This method is invoked when an impression is recorded for an ad.
    }

    void OnAdShowedFullScreenContent() override {
      // This method is invoked when the ad showed its full screen content.
    }
  };

  ExampleFullScreenContentListener* example_full_screen_content_listener =
    new ExampleFullScreenContentListener();
  rewarded_ad->SetFullScreenContentListener(example_full_screen_content_listener);

RewardedAd একটি একবার ব্যবহারযোগ্য অবজেক্ট। এর মানে হলো, একবার একটি রিওয়ার্ডেড অ্যাড দেখানো হলে, তা আর পুনরায় দেখানো যায় না। একটি উত্তম পদ্ধতি হলো আপনার FullScreenContentListener এর OnAdDismissedFullScreenContent() মেথডে আরেকটি রিওয়ার্ডেড অ্যাড লোড করা, যাতে আগেরটি ডিসমিস হওয়ার সাথে সাথেই পরবর্তী রিওয়ার্ডেড অ্যাডটি লোড হওয়া শুরু করে।

বিজ্ঞাপনটি দেখান এবং পুরস্কার ইভেন্টটি পরিচালনা করুন

ব্যবহারকারীদের কাছে পুরস্কারযুক্ত বিজ্ঞাপন দেখানোর আগে, আপনাকে অবশ্যই পুরস্কারের বিনিময়ে বিজ্ঞাপনের বিষয়বস্তু দেখার জন্য ব্যবহারকারীকে একটি সুস্পষ্ট বিকল্প দিতে হবে। পুরস্কারযুক্ত বিজ্ঞাপন সবসময় একটি ঐচ্ছিক অভিজ্ঞতা হতে হবে।

আপনার বিজ্ঞাপন দেখানোর সময়, ব্যবহারকারীর পুরস্কার পরিচালনার জন্য আপনাকে অবশ্যই একটি UserEarnedReward অবজেক্ট প্রদান করতে হবে।

নিম্নলিখিত কোডটি দেখায় কিভাবে একটি RewardedAd প্রদর্শন করতে হয়:

// A simple listener track UserEarnedReward events.
class ExampleUserEarnedRewardListener :
    public firebase::gma::UserEarnedRewardListener {
 public:
   ExampleUserEarnedRewardListener() { }

  void OnUserEarnedReward(const firebase::gma::AdReward& reward) override {
    // Reward the user!
  }
};

ExampleUserEarnedRewardListener* user_earned_reward_listener =
  new ExampleUserEarnedRewardListener();
firebase::Future<void> result = rewarded_ad->Show(user_earned_reward_listener);

প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী

ইনিশিয়ালাইজেশন কলের জন্য কি কোনো টাইমআউট আছে?
১০ সেকেন্ড পর, কোনো মিডিয়েশন নেটওয়ার্কের ইনিশিয়ালাইজেশন তখনও সম্পূর্ণ না হলেও, Google Mobile Ads C++ SDK Initialize() দ্বারা রিটার্ন করা firebase::Future সম্পূর্ণ করে।
ইনিশিয়ালাইজেশন কলব্যাক পাওয়ার সময় যদি কিছু মিডিয়েশন নেটওয়ার্ক প্রস্তুত না থাকে, তাহলে কী হবে?

এসডিকে ইনিশিয়ালাইজেশন সম্পন্ন হওয়ার পর বিজ্ঞাপন লোড করা একটি উত্তম অভ্যাস। এমনকি যদি কোনো মিডিয়েশন নেটওয়ার্ক প্রস্তুত না-ও থাকে, গুগল মোবাইল অ্যাডস সি++ এসডিকে তবুও সেই নেটওয়ার্কের কাছে একটি বিজ্ঞাপনের জন্য অনুরোধ করবে। তাই যদি কোনো মিডিয়েশন নেটওয়ার্ক টাইমআউটের পরে ইনিশিয়ালাইজেশন সম্পন্ন করে, তবে এটি সেই সেশনে ভবিষ্যতের বিজ্ঞাপনের অনুরোধগুলোও পূরণ করতে পারবে।

আপনার অ্যাপ সেশন চলাকালীন আপনি GetInitializationStatus() কল করে সমস্ত অ্যাডাপ্টারের ইনিশিয়ালাইজেশন স্ট্যাটাস পোল করা চালিয়ে যেতে পারেন।

আমি কীভাবে জানব কেন একটি নির্দিষ্ট মধ্যস্থতা নেটওয়ার্ক প্রস্তুত নয়?

AdapterStatus.description() বর্ণনা করে কেন একটি অ্যাডাপ্টার এডি অনুরোধগুলি পরিষেবা দেওয়ার জন্য প্রস্তুত নয়। মিডিয়েশন অ্যাডাপ্টারের স্ট্যাটাস লগ করার একটি উদাহরণের জন্য GitHub-এ আমাদের উদাহরণ কুইকস্টার্ট অ্যাপটির সোর্স কোড দেখুন।

অতিরিক্ত সম্পদ

গিটহাবে উদাহরণ