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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা) অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

রিওয়ার্ডেড অ্যাডের মাধ্যমে আপনি ভিডিও অ্যাড, প্লেয়েবল অ্যাড এবং সার্ভের সাথে ইন্টারঅ্যাক্ট করার জন্য ব্যবহারকারীদের অ্যাপের ভেতরের আইটেম দিয়ে পুরস্কৃত করতে পারেন।

পূর্বশর্ত

GMA Next-Gen SDK সেট আপ করুন ।

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

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

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

/21775744923/example/rewarded

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

GMA Next-Gen SDK টেস্ট অ্যাড সম্পর্কে বিস্তারিত জানতে, ‘টেস্ট অ্যাড সক্ষম করুন’ দেখুন।

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

বিজ্ঞাপন লোড করার জন্য, GMA Next-Gen SDK নিম্নলিখিত সুবিধাগুলো প্রদান করে:

• একক বিজ্ঞাপন লোডিং এপিআই দিয়ে লোড করুন।

• অ্যাড প্রি-লোডিং এপিআই (API) ব্যবহার করে লোড করুন, যা ম্যানুয়াল অ্যাড লোডিং এবং ক্যাশিংয়ের প্রয়োজনীয়তা দূর করে।

একক বিজ্ঞাপন লোডিং এপিআই দিয়ে লোড করুন

নিচের উদাহরণটি আপনাকে দেখাবে কীভাবে একটি একক বিজ্ঞাপন লোড করতে হয়:

কোটলিন

import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback
import com.google.android.libraries.ads.mobile.sdk.MobileAds

class RewardedActivity : Activity() {
  private var rewardedAd: RewardedAd? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Load ads after you inititalize GMA Next-Gen SDK.
    RewardedAd.load(
      AdRequest.Builder(AD_UNIT_ID).build(),
      object : AdLoadCallback<RewardedAd> {
        override fun onAdLoaded(ad: RewardedAd) {
          // Rewarded ad loaded.
          rewardedAd = ad
        }

        override fun onAdFailedToLoad(adError: LoadAdError) {
          // Rewarded ad failed to load.
          rewardedAd = null
        }
      },
    )
  }

  companion object {
    // Sample rewarded ad unit ID.
    const val AD_UNIT_ID = "/21775744923/example/rewarded"
  }
}

জাভা

import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback;
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest;
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError;
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback;
import com.google.android.libraries.ads.mobile.sdk.MobileAds;

class RewardedActivity extends Activity {
  // Sample rewarded ad unit ID.
  private static final String AD_UNIT_ID = "/21775744923/example/rewarded";
  private RewardedAd rewardedAd;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Load ads after you initialize GMA Next-Gen SDK.
    RewardedAd.load(
        new AdRequest.Builder(AD_UNIT_ID).build(),
        new AdLoadCallback<RewardedAd>() {
          @Override
          public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
            // Rewarded ad loaded.
            AdLoadCallback.super.onAdLoaded(rewardedAd);
            RewardedActivity.this.rewardedAd = rewardedAd;
          }

          @Override
          public void onAdFailedToLoad(@NonNull LoadAdError adError) {
            // Rewarded ad failed to load.
            AdLoadCallback.super.onAdFailedToLoad(adError);
            rewardedAd = null;
          }
        }
    );
  }
}

বিজ্ঞাপন প্রি-লোডিং এপিআই দিয়ে লোড করুন

প্রি-লোডিং শুরু করতে, নিম্নলিখিতগুলি করুন:

1. একটি বিজ্ঞাপন অনুরোধের মাধ্যমে প্রিলোড কনফিগারেশন শুরু করুন।

2. আপনার অ্যাড ইউনিট আইডি এবং প্রিলোড কনফিগারেশন ব্যবহার করে রিওয়ার্ডেড অ্যাডের জন্য প্রিলোডারটি চালু করুন:

কোটলিন

private fun startPreloading(adUnitId: String) {
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  RewardedAdPreloader.start(adUnitId, preloadConfig)
}
RewardedAdSnippets.kt

জাভা

private void startPreloading(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  RewardedAdPreloader.start(adUnitId, preloadConfig);
}
RewardedAdSnippets.java

যখন আপনি বিজ্ঞাপনটি দেখানোর জন্য প্রস্তুত হবেন, তখন প্রি-লোডার থেকে বিজ্ঞাপনটির জন্য পোল করুন:

কোটলিন

// Polling returns the next available ad and loads another ad in the background.
val ad = RewardedAdPreloader.pollAd(adUnitId)
RewardedAdSnippets.kt

জাভা

// Polling returns the next available ad and loads another ad in the background.
final RewardedAd ad = RewardedAdPreloader.pollAd(adUnitId);
RewardedAdSnippets.java

RewardedAdEventCallback সেট করুন

RewardedAdEventCallback আপনার RewardedAd প্রদর্শনের সাথে সম্পর্কিত ইভেন্টগুলো পরিচালনা করে। রিওয়ার্ডেড অ্যাড দেখানোর আগে, কলব্যাকটি সেট করতে ভুলবেন না:

কোটলিন

// Listen for ad events.
rewardedAd?.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.
      rewardedAd = null
    }

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

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

জাভা

// Listen for ad events.
rewardedAd.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdShowedFullScreenContent() {
        // Rewarded ad did show.
        RewardedAdEventCallback.super.onAdShowedFullScreenContent();
      }

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

      @Override
      public void onAdFailedToShowFullScreenContent(
          @NonNull FullScreenContentError fullScreenContentError) {
        // Rewarded ad failed to show.
        RewardedAdEventCallback.super.onAdFailedToShowFullScreenContent(
            fullScreenContentError);
        rewardedAd = null;
      }

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

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

বিজ্ঞাপনটি দেখান

পুরস্কারযুক্ত বিজ্ঞাপন দেখানোর জন্য show() মেথডটি ব্যবহার করুন। পুরস্কার ইভেন্টগুলো পরিচালনা করতে একটি OnUserEarnedRewardListener অবজেক্ট ব্যবহার করুন।

কোটলিন

// Show the ad.
rewardedAd?.show(
  this@RewardedActivity,
  object : OnUserEarnedRewardListener {
    override fun onUserEarnedReward(rewardItem: RewardItem) {
      // User earned the reward.
      val rewardAmount = rewardItem.amount
      val rewardType = rewardItem.type
    }
  },
)

জাভা

// Show the ad.
rewardedAd.show(
    RewardedActivity.this,
    new OnUserEarnedRewardListener() {
      @Override
      public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
        // User earned the reward.
        int rewardAmount = rewardItem.getAmount();
        String rewardType = rewardItem.getType();
    }
});

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

ইনিশিয়ালাইজেশন কলের জন্য কি কোনো টাইমআউট আছে?

১০ সেকেন্ড পর, কোনো মিডিয়েশন নেটওয়ার্কের ইনিশিয়ালাইজেশন তখনও সম্পূর্ণ না হলেও, GMA Next-Gen SDK ‘ OnInitializationCompleteListener কে কল করে।

ইনিশিয়ালাইজেশন কলব্যাক পাওয়ার সময় যদি কিছু মিডিয়েশন নেটওয়ার্ক প্রস্তুত না থাকে, তাহলে কী হবে?

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

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

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

AdapterStatus.getDescription() বর্ণনা করে কেন একটি অ্যাডাপ্টার অ্যাড অনুরোধগুলি পরিষেবা দেওয়ার জন্য প্রস্তুত নয়।

onUserEarnedReward() কলব্যাকটি কি সবসময় onAdDismissedFullScreenContent() কলব্যাকের আগে কল করা হয়?

গুগল বিজ্ঞাপনের ক্ষেত্রে, সমস্ত onUserEarnedReward() কল onAdDismissedFullScreenContent() এর আগে ঘটে। মিডিয়েশনের মাধ্যমে পরিবেশিত বিজ্ঞাপনের জন্য, তৃতীয় পক্ষের বিজ্ঞাপন নেটওয়ার্ক SDK-এর ইমপ্লিমেন্টেশন কলব্যাকের ক্রম নির্ধারণ করে। যে সমস্ত বিজ্ঞাপন নেটওয়ার্ক SDK পুরস্কারের তথ্যসহ একটিমাত্র ক্লোজ কলব্যাক প্রদান করে, তাদের ক্ষেত্রে মিডিয়েশন অ্যাডাপ্টার onAdDismissedFullScreenContent( onUserEarnedReward() onAdDismissedFullScreenContent() কল করে।

উদাহরণ

GMA Next-Gen SDK এর ব্যবহার প্রদর্শনকারী উদাহরণ অ্যাপটি ডাউনলোড করে চালান।