পুরস্কার প্রদানকারী বিজ্ঞাপন সেট-আপ করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (Legacy)

পুরস্কার প্রদানকারী বিজ্ঞাপন ভিডিও বিজ্ঞাপন, খেলার উপযুক্ত বিজ্ঞাপন ও সমীক্ষার সাথে ইন্টার‍্যাক্ট করার জন্য অ্যাপ-মধ্যস্থ আইটেম দিয়ে ব্যবহারকারীদের পুরস্কার দিতে দেয়।

Android অ্যাপে কীভাবে পুরস্কার প্রদানকারী বিজ্ঞাপন ইন্টিগ্রেট করতে হয় তা এই নির্দেশিকায় ব্যাখ্যা করা হয়েছে।

শুরু করার আগে

চালিয়ে যাওয়ার আগে, নিম্নলিখিত কাজগুলি করুন:

  • GMA Next-Gen SDK সেট-আপ করুন।
  • টেস্ট পুরস্কার প্রদানকারী বিজ্ঞাপন ইউনিট আইডি /21775744923/example/rewarded ব্যবহার করুন।
    • আপনার অ্যাপ তৈরি ও পরীক্ষা করার সময়, লাইভ, প্রোডাকশন বিজ্ঞাপনের পরিবর্তে পরীক্ষামূলক বিজ্ঞাপন ব্যবহার করছেন কিনা তা ভালো করে দেখে নিন। আপনি টেস্ট বিজ্ঞাপন ইউনিট আইডি ব্যবহার না করলে, Google আপনার অ্যাকাউন্ট সাসপেন্ড করতে পারে।
    • আপনার অ্যাপ প্রকাশ করার আগে, এই আইডির জায়গায় আপনার বিজ্ঞাপন ইউনিট আইডি লিখুন।
    • GMA Next-Gen SDKপরীক্ষামূলক বিজ্ঞাপন সম্পর্কে বিস্তারিত জানতে, পরীক্ষামূলক বিজ্ঞাপন চালু করুন।

বিজ্ঞাপন প্রি-লোডিং (বিটা) সম্পর্কে জানুন

GMA Next-Gen SDK-এ বিজ্ঞাপন প্রি-লোডিং বিজ্ঞাপন লোডিং ও ক্যাশিং অটোমেট করে।

বিজ্ঞাপন প্রি-লোডিংয়ের নিম্নলিখিত সুবিধাগুলি রয়েছে:

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

বিজ্ঞাপন প্রি-লোডিং শুরু করা

বিজ্ঞাপন প্রি-লোড করা শুরু করতে, অ্যাপ চালু করার সময় একবার start মেথড কল করুন। আপনি start মেথড কল করার পরে, GMA Next-Gen SDK অটোমেটিক বিজ্ঞাপন প্রি-লোড করে এবং প্রি-লোড করা কনফিগারেশনের জন্য ব্যর্থ হওয়া অনুরোধ আবার করার চেষ্টা করে।

বিজ্ঞাপন প্রি-লোড করা কীভাবে শুরু করতে হয় তা নিম্নলিখিত উদাহরণ থেকে দেখুন:

Kotlin

val adRequest = AdRequest.Builder(adUnitId).build()
val preloadConfig = PreloadConfiguration(adRequest)
RewardedAdPreloader.start(adUnitId, preloadConfig)

Java

AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
RewardedAdPreloader.start(adUnitId, preloadConfig);

আপনার বিজ্ঞাপন ইউনিট আইডির সাথে AD_UNIT_ID পরিবর্তন করুন।

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

প্রিলোড করা বিজ্ঞাপন পাওয়া ও দেখানো

আপনি কোনও বিজ্ঞাপন দেখাতে চাইলে, pollAd মেথড কল করুন। GMA Next-Gen SDK একটি উপলভ্য বিজ্ঞাপন রিট্রিভ করে এবং ব্যাকগ্রাউন্ডে পরের বিজ্ঞাপন অটোমেটিক প্রি-লোড করে। কোনও বিজ্ঞাপন উপলভ্য না থাকলে, GMA Next-Gen SDK কোনও বিজ্ঞাপন রিটার্ন করে না।

আপনার কাছে উপলভ্য বিজ্ঞাপন অবজেক্ট থাকলে, বিজ্ঞাপন দেখাতে show মেথড কল করুন। পুরস্কার ইভেন্ট ম্যানেজ করতে পুরস্কার লিসনার ব্যবহার করুন। প্রিলোড করা বিজ্ঞাপন কীভাবে রিট্রিভ ও দেখাতে হয় তা নিম্নলিখিত উদাহরণ থেকে দেখুন:

Kotlin

private fun pollAndShowAd(activity: Activity, adUnitId: String) {
  // Polling returns the next available ad and loads another ad in the background.
  val ad = RewardedAdPreloader.pollAd(adUnitId)
  if (ad == null) {
    Log.e(TAG, "Rewarded ad is not available.")
    return
  }

  // Interact with the ad object as needed.
  Log.d(TAG, "Rewarded ad response info: ${ad.getResponseInfo()}")
  ad.adEventCallback =
    object : RewardedAdEventCallback {
      override fun onAdImpression() {
        Log.d(TAG, "Rewarded ad recorded an impression.")
      }
    }
  ad.show(activity) { rewardItem -> Log.d(TAG, "User earned reward: ${rewardItem.amount}") }
}

Java

private void pollAndShowAd(Activity activity, String adUnitId) {
  // Polling returns the next available ad and loads another ad in the background.
  final RewardedAd ad = RewardedAdPreloader.pollAd(adUnitId);

  // Interact with the ad object as needed.
  if (ad == null) {
    Log.e(TAG, "Rewarded ad is not available.");
    return;
  }

  Log.d(TAG, "Rewarded ad response info: " + ad.getResponseInfo());
  ad.setAdEventCallback(
      new RewardedAdEventCallback() {
        @Override
        public void onAdImpression() {
          Log.d(TAG, "Rewarded ad recorded an impression.");
        }
      });

  // Show the ad.
  ad.show(
      activity,
      rewardItem -> {
        Log.d(TAG, "User earned reward: " + rewardItem.getAmount());
      });
}

আপনি বিজ্ঞাপন দেখানোর জন্য প্রস্তুত না হওয়া পর্যন্ত, pollAd মেথড কল করা এড়িয়ে চলুন। বিজ্ঞাপনের উত্তর সম্পর্কিত তথ্য না দেখিয়ে সেটি পড়তে, উত্তরের তথ্য পড়ুন দেখুন।

বিজ্ঞাপন ইভেন্ট শোনা

বিজ্ঞাপন দেখানোর আগে, বিজ্ঞাপন ইভেন্ট শুনুন। নিচে দেওয়া উদাহরণ বিজ্ঞাপন ইভেন্টের জন্য কলব্যাক রেজিস্টার করে:

Kotlin

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = rewardedAd
  if (ad == null) {
    Log.e(TAG, "Rewarded ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : RewardedAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // Rewarded ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // Rewarded ad did dismiss.
        rewardedAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // Rewarded ad failed to show.
        Log.e(TAG, "Rewarded ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // Rewarded ad did record an impression.
      }

      override fun onAdClicked() {
        // Rewarded ad did record a click.
      }
    }
}

Java

private void listenToAdEvents() {
  // Listen for ad events.
  if (rewardedAd == null) {
    Log.e(TAG, "Rewarded ad is not ready yet.");
    return;
  }

  rewardedAd.setAdEventCallback(
      new RewardedAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // Rewarded ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // Rewarded ad did dismiss.
          rewardedAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            FullScreenContentError fullScreenContentError) {
          // Rewarded ad failed to show.
          Log.e(TAG, "Rewarded ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // Rewarded ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // Rewarded ad did record a click.
        }
      });
}

ঐচ্ছিক: সার্ভার-সাইড যাচাইকরণ (SSV) কলব্যাক যাচাই করা

আপনার অ্যাপের সার্ভার-সাইড যাচাইকরণ কলব্যাকে অতিরিক্ত ডেটা প্রয়োজন হলে, বিজ্ঞাপনের কাস্টম ডেটা ফিচার ব্যবহার করুন। Google বিজ্ঞাপন সার্ভার, SSV কলব্যাকের custom_data কোয়েরি প্যারামিটারে বিজ্ঞাপন অবজেক্টে সেট করা যেকোনও স্ট্রিং ভ্যালু পাস করে। কোনও কাস্টম ডেটা ভ্যালু সেট করা না থাকলে, SSV কলব্যাকে custom_data কোয়েরি প্যারামিটার ভ্যালু থাকে না।

নিচে দেওয়া উদাহরণে বিজ্ঞাপন দেখানোর আগে বিজ্ঞাপন অবজেক্টে কাস্টম ডেটা সেট করা হয়েছে:

Kotlin

RewardedAd.load(
  context,
  AD_UNIT_ID,
  AdRequest.Builder().build(),
  object : RewardedAdLoadCallback() {
    override fun onAdLoaded(ad: RewardedAd) {
      rewardedAd = ad
      val options =
        ServerSideVerificationOptions.Builder().setCustomData("SAMPLE_CUSTOM_DATA_STRING").build()
      rewardedAd?.setServerSideVerificationOptions(options)
    }
  },
)

Java

RewardedAd.load(
    context,
    AD_UNIT_ID,
    new AdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(RewardedAd ad) {
        rewardedAd = ad;
        ServerSideVerificationOptions options =
            new ServerSideVerificationOptions.Builder()
                .setCustomData("SAMPLE_CUSTOM_DATA_STRING")
                .build();
        rewardedAd.setServerSideVerificationOptions(options);
      }
    });

SAMPLE_CUSTOM_DATA_STRING-এর পরিবর্তে আপনার কাস্টম ডেটা লিখুন।

ঐচ্ছিক: প্রি-লোডিং ইভেন্ট শোনা

আপনি বিজ্ঞাপন প্রি-লোড করা শুরু করলে, বিজ্ঞাপন সফলভাবে প্রি-লোড করা হলে, প্রি-লোড করা না গেলে বা বিজ্ঞাপন ক্যাশে শেষ হয়ে গেলে বিজ্ঞপ্তি পেতে প্রি-লোড ইভেন্টের জন্য রেজিস্টার করুন।

বিজ্ঞাপন ইভেন্ট প্রি-লোডিংয়ের জন্য কীভাবে রেজিস্টার করতে হয় তা নিম্নলিখিত উদাহরণ থেকে জানতে পারবেন:

Kotlin

val preloadCallback =
  object : PreloadCallback {
    override fun onAdFailedToPreload(preloadId: String, adError: LoadAdError) {
      Log.d(TAG, "Rewarded preload ad $preloadId failed to load with error: ${adError.message}")
    }

    override fun onAdsExhausted(preloadId: String) {
      Log.i(TAG, "Rewarded preload ad $preloadId is not available")
    }

    override fun onAdPreloaded(preloadId: String, responseInfo: ResponseInfo) {
      Log.i(TAG, "Rewarded preload ad $preloadId is available")
    }
  }
val adRequest = AdRequest.Builder(adUnitId).build()
val preloadConfig = PreloadConfiguration(adRequest)
RewardedAdPreloader.start(adUnitId, preloadConfig, preloadCallback)

Java

PreloadCallback preloadCallback =
    new PreloadCallback() {
      @Override
      public void onAdFailedToPreload(String preloadId, LoadAdError adError) {
        Log.d(
            TAG,
            String.format(
                "Rewarded preload ad %s failed to load with error: %s",
                preloadId, adError.getMessage()));
      }

      @Override
      public void onAdsExhausted(String preloadId) {
        Log.i(TAG, "Rewarded preload ad " + preloadId + " is not available");
      }

      @Override
      public void onAdPreloaded(String preloadId, ResponseInfo responseInfo) {
        Log.i(TAG, "Rewarded preload ad " + preloadId + " is available");
      }
    };

AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
RewardedAdPreloader.start(adUnitId, preloadConfig, preloadCallback);

কোনও বিজ্ঞাপন লোড করা না গেলে, GMA Next-Gen SDK অটোমেটিক বিজ্ঞাপন প্রিলোড করে এবং প্রিলোড করা কনফিগারেশনের জন্য ব্যর্থ অনুরোধ আবার চেষ্টা করে।

ঐচ্ছিক: বিজ্ঞাপন উপলভ্য আছে কিনা চেক করা

কোনও বিজ্ঞাপন উপলভ্য আছে কিনা তা জানতে চাইলে, বিজ্ঞাপন উপলভ্যতা চেক করুন। নিম্নলিখিত উদাহরণ থেকে চেক করা হয় যে আগে থেকে লোড করা বিজ্ঞাপন উপলভ্য আছে কিনা:

Kotlin

private fun isAdAvailable(adUnitId: String): Boolean {
  return RewardedAdPreloader.isAdAvailable(adUnitId)
}

Java

private boolean isAdAvailable(String adUnitId) {
  return RewardedAdPreloader.isAdAvailable(adUnitId);
}

ঐচ্ছিক: বাফার সাইজ সেট করুন

মেমরিতে রাখা প্রি-লোড করা বিজ্ঞাপনের সংখ্যা বাফার সাইজ কন্ট্রোল করে। সাধারণত, মেমরি ব্যবহার ও বিজ্ঞাপন দেখানোর লেটেন্সি ব্যালেন্স করতে Google বাফার সাইজ অপ্টিমাইজ করে। মেমরিতে সেভ করা বিজ্ঞাপনের সংখ্যা বাড়াতে, আপনি কাস্টম বাফার সাইজ সেট করতে পারেন। আমরা দুটি প্রি-লোড করা বিজ্ঞাপনের বাফার সাইজ সাজেস্ট করি।

কীভাবে বাফার সাইজ সেট করতে হয় তা নিম্নলিখিত উদাহরণ থেকে দেখুন:

Kotlin

val adRequest = AdRequest.Builder(adUnitId).build()
// Define a PreloadConfiguration and set the buffer size to 2 preloaded ads.
val preloadConfig = PreloadConfiguration(adRequest, bufferSize = 2)
RewardedAdPreloader.start(adUnitId, preloadConfig)

Java

AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
// Define a PreloadConfiguration and set the buffer size to 2 preloaded ads.
PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest, 2);
RewardedAdPreloader.start(adUnitId, preloadConfig);

প্রিলোড ক্যাশের সীমা

GMA Next-Gen SDK সব বিজ্ঞাপন ইউনিট ও প্রিলোড আইডি জুড়ে প্রিলোড করা বিজ্ঞাপনের মোট সংখ্যার উপর অ্যাপ-ব্যাপী সীমা প্রয়োগ করে:

  • ডিফল্ট সীমা: Google মেমরিতে সর্বাধিক ছয়টি প্রি-লোড করা বিজ্ঞাপন ধরে রাখে। এই সীমা সব ফর্ম্যাট ও প্রি-লোড আইডি জুড়ে শেয়ার করা হয়।
  • আমরা প্রতিটি প্রি-লোড আইডির জন্য দুটি করে বাফার সাইজ রাখার সাজেশন দিই।

ঐচ্ছিক: বিজ্ঞাপন প্রি-লোড করা বন্ধ করুন

আপনি যদি সেশনে কোনও নির্দিষ্ট প্রি-লোড আইডির জন্য আবার বিজ্ঞাপন দেখাতে না চান, তাহলে বিজ্ঞাপন প্রি-লোড করা বন্ধ করতে পারেন। নির্দিষ্ট প্রিলোড আইডির জন্য বিজ্ঞাপন লোড করা বন্ধ করতে, প্রিলোড আইডির সাথে destroy মেথড কল করুন। destroy মেথড কল করলে, ক্যাশে থাকা প্রিলোড আইডি সম্পর্কিত সব প্রি-লোডেড বিজ্ঞাপন সরিয়ে দেওয়া হয়।

নিম্নলিখিত উদাহরণ থেকে কীভাবে বিজ্ঞাপন প্রি-লোড করা বন্ধ করতে হয় তা জানুন:

Kotlin

private fun stopPreloading(adUnitId: String) {
  // Stops the preloading and destroy preloaded ads.
  RewardedAdPreloader.destroy(adUnitId)
}

Java

private void stopPreloading(String adUnitId) {
  // Stops the preloading and destroy preloaded ads.
  RewardedAdPreloader.destroy(adUnitId);
}

ঐচ্ছিক: উত্তরের তথ্য পড়ুন

ক্যাশে থেকে বিজ্ঞাপন না সরিয়েই পরবর্তী প্রি-লোড করা বিজ্ঞাপনের উত্তর সংক্রান্ত তথ্য পড়ুন।

পরবর্তী প্রি-লোড করা বিজ্ঞাপন সংক্রান্ত উত্তরের তথ্য কীভাবে পড়তে হয় তা নিম্নলিখিত উদাহরণ থেকে দেখুন:

Kotlin

val responseInfo = RewardedAdPreloader.peekAdResponseInfo(preloadId)
if (responseInfo == null) {
  Log.e(TAG, "Failed to peek ad response info.")
  return
}

Log.d(TAG, "Peeked ad response ID: ${responseInfo.responseId}")

Java

ResponseInfo responseInfo = RewardedAdPreloader.peekAdResponseInfo(preloadId);
if (responseInfo == null) {
  Log.e(TAG, "Failed to peek ad response info.");
  return;
}

Log.d(TAG, "Peeked ad response ID: " + responseInfo.getResponseId());