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


পুরস্কৃত বিজ্ঞাপন ব্যবহারকারীদের অ্যাপ-মধ্যস্থ পুরষ্কারের বিনিময়ে তাদের সাথে ইন্টারঅ্যাক্ট করার বিকল্প দেয়। এই নির্দেশিকাটি আপনাকে দেখায় যে কীভাবে Google মোবাইল বিজ্ঞাপন C++ SDK ব্যবহার করে Android এবং iOS অ্যাপে পুরস্কৃত বিজ্ঞাপনগুলিকে একীভূত করতে হয়।

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

পূর্বশর্ত

  • সম্পূর্ণ শুরু করুন ।
  • (শুধুমাত্র অ্যান্ড্রয়েড) JNI jobject রেফারেন্সের সাথে কাজ করার অভিজ্ঞতা ( Android JNI টিপস দেখুন)।

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

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

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

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

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

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

বাস্তবায়ন

পুরস্কৃত বিজ্ঞাপন সংহত করার প্রধান ধাপগুলি হল:

  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. আপনার প্যারেন্ট ভিউ কাস্ট ব্যবহার করে RewardedAd ইনস্ট্যান্সটি একটি AdParent টাইপে শুরু করুন। প্যারেন্ট ভিউ হল একটি JNI jobject রেফারেন্স যা একটি Android Activity অথবা একটি 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 এর সাথে কাজ করার বিষয়ে আরও তথ্যের জন্য, পদ্ধতি কলের সমাপ্তির অবস্থা পর্যবেক্ষণ করতে Futures ব্যবহার করুন দেখুন।

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

একটি বিজ্ঞাপন লোড করা একটি 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() পদ্ধতির মাধ্যমে নিবন্ধিত করা যেতে পারে এবং বিজ্ঞাপনটি সফলভাবে বা অসফলভাবে উপস্থাপন করা হলে এবং এটি বাতিল করা হলে কলব্যাক পাবে।

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

  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 মোবাইল বিজ্ঞাপন C++ SDK Initialize() দ্বারা ফিরে আসা firebase::Future সম্পূর্ণ করে, এমনকি যদি কোনও মধ্যস্থতা নেটওয়ার্ক এখনও initialization সম্পন্ন না করে।
আমি যখন ইনিশিয়ালাইজেশন কলব্যাক পাবো, তখন যদি কিছু মধ্যস্থতা নেটওয়ার্ক প্রস্তুত না থাকে?

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

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

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

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

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

GitHub-এ উদাহরণ