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

পূর্বশর্ত
- শুরু করুন নির্দেশিকাটি সম্পূর্ণ করুন।
সর্বদা পরীক্ষামূলক বিজ্ঞাপন দিয়ে পরীক্ষা করুন
আপনার অ্যাপ তৈরি এবং পরীক্ষা করার সময়, লাইভ, প্রোডাকশন বিজ্ঞাপনের পরিবর্তে পরীক্ষামূলক বিজ্ঞাপন ব্যবহার করুন। এটি না করলে আপনার অ্যাকাউন্ট সাসপেন্ড হতে পারে।
পরীক্ষামূলক বিজ্ঞাপন লোড করার সবচেয়ে সহজ উপায় হল অ্যাপ খোলা বিজ্ঞাপনের জন্য আমাদের ডেডিকেটেড পরীক্ষামূলক বিজ্ঞাপন ইউনিট আইডি ব্যবহার করা:
ca-app-pub-3940256099942544/9257395921
এটি বিশেষভাবে প্রতিটি অনুরোধের জন্য পরীক্ষামূলক বিজ্ঞাপন ফেরত দেওয়ার জন্য কনফিগার করা হয়েছে এবং কোডিং, পরীক্ষা এবং ডিবাগিংয়ের সময় আপনি এটি আপনার নিজস্ব অ্যাপে ব্যবহার করতে পারেন। আপনার অ্যাপ প্রকাশ করার আগে এটি আপনার নিজস্ব বিজ্ঞাপন ইউনিট আইডি দিয়ে প্রতিস্থাপন করুন।
Google মোবাইল বিজ্ঞাপন SDK পরীক্ষার বিজ্ঞাপন কীভাবে কাজ করে সে সম্পর্কে আরও তথ্যের জন্য, পরীক্ষামূলক বিজ্ঞাপন সক্ষম করুন দেখুন।
অ্যাপ্লিকেশন ক্লাস প্রসারিত করুন
 একটি নতুন ক্লাস তৈরি করুন যা Application ক্লাসকে প্রসারিত করে। এটি একটি জীবনচক্র-সচেতন উপায় প্রদান করে যা একটি একক Activity পরিবর্তে অ্যাপ্লিকেশনের অবস্থার সাথে সংযুক্ত বিজ্ঞাপনগুলি পরিচালনা করে: 
জাভা
public class MyApplication extends Application
    implements ActivityLifecycleCallbacks, DefaultLifecycleObserver {
  private AppOpenAdManager appOpenAdManager;
  private Activity currentActivity;
  @Override
  public void onCreate() {
    super.onCreate();
    this.registerActivityLifecycleCallbacks(this);
    ProcessLifecycleOwner.get().getLifecycle().addObserver(this);
    appOpenAdManager = new AppOpenAdManager();
  }
কোটলিন
class MyApplication :
  MultiDexApplication(), Application.ActivityLifecycleCallbacks, DefaultLifecycleObserver {
  private lateinit var appOpenAdManager: AppOpenAdManager
  private var currentActivity: Activity? = null
  override fun onCreate() {
    super<MultiDexApplication>.onCreate()
    registerActivityLifecycleCallbacks(this)
    ProcessLifecycleOwner.get().lifecycle.addObserver(this)
    appOpenAdManager = AppOpenAdManager()
  }
 এরপর, আপনার AndroidManifest.xml এ নিম্নলিখিত কোডটি যোগ করুন:
<!-- TODO: Update to reference your actual package name. -->
<application
    android:name="com.google.android.gms.example.appopendemo.MyApplication" ...>
...
</application>
আপনার ইউটিলিটি কম্পোনেন্টটি বাস্তবায়ন করুন
আপনার বিজ্ঞাপনটি দ্রুত দেখানো উচিত, তাই বিজ্ঞাপনটি প্রদর্শনের আগে লোড করাই ভালো। এইভাবে, ব্যবহারকারী আপনার অ্যাপে প্রবেশ করার সাথে সাথেই আপনার কাছে একটি বিজ্ঞাপন প্রস্তুত থাকবে।
 অ্যাপ ওপেন বিজ্ঞাপন লোড করা এবং দেখানোর সাথে সম্পর্কিত কাজকে অন্তর্ভুক্ত করার জন্য একটি ইউটিলিটি উপাদান AppOpenAdManager প্রয়োগ করুন: 
জাভা
private class AppOpenAdManager {
  private static final String LOG_TAG = "AppOpenAdManager";
  private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/9257395921";
  private AppOpenAd appOpenAd = null;
  private boolean isLoadingAd = false;
  private boolean isShowingAd = false;
  /** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
  private long loadTime = 0;
  /** Constructor. */
  public AppOpenAdManager() {}
কোটলিন
private inner class AppOpenAdManager {
  private var appOpenAd: AppOpenAd? = null
  private var isLoadingAd = false
  var isShowingAd = false
  /** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
  private var loadTime: Long = 0
 AppOpenAdManager ব্যবহার করতে, singleton MyApplication ইনস্ট্যান্সে public wrapper পদ্ধতিগুলি কল করুন। Application ক্লাসটি বাকি কোডের সাথে ইন্টারফেস করে, লোডিং এবং বিজ্ঞাপনটি ম্যানেজারকে দেখানোর কাজ অর্পণ করে।
একটি বিজ্ঞাপন লোড করুন
 পরবর্তী ধাপ হল loadAd() পদ্ধতিটি পূরণ করা এবং বিজ্ঞাপন লোড কলব্যাকগুলি পরিচালনা করা। 
জাভা
কোটলিন
AD_UNIT_ID পরিবর্তে আপনার নিজস্ব বিজ্ঞাপন ইউনিট আইডি দিন।
বিজ্ঞাপনটি দেখান
অ্যাপ ওপেন বাস্তবায়নের সবচেয়ে সাধারণ পদ্ধতি হল অ্যাপ লঞ্চের কাছাকাছি সময়ে একটি অ্যাপ ওপেন বিজ্ঞাপন দেখানোর চেষ্টা করা, বিজ্ঞাপনটি প্রস্তুত না থাকলে অ্যাপ কন্টেন্ট শুরু করা এবং পরবর্তী অ্যাপ খোলার সুযোগের জন্য আরেকটি বিজ্ঞাপন প্রিলোড করা। বাস্তবায়নের উদাহরণগুলির জন্য অ্যাপ ওপেন বিজ্ঞাপন নির্দেশিকা দেখুন।
নিম্নলিখিত কোডটি একটি বিজ্ঞাপন দেখায় এবং পরবর্তীতে পুনরায় লোড করে:
জাভা
public void showAdIfAvailable(
    @NonNull final Activity activity,
    @NonNull OnShowAdCompleteListener onShowAdCompleteListener) {
  // If the app open ad is already showing, do not show the ad again.
  if (isShowingAd) {
    Log.d(TAG, "The app open ad is already showing.");
    return;
  }
  // If the app open ad is not available yet, invoke the callback then load the ad.
  if (appOpenAd == null) {
    Log.d(TAG, "The app open ad is not ready yet.");
    onShowAdCompleteListener.onShowAdComplete();
    // Load an ad.
    return;
  }
  isShowingAd = true;
  appOpenAd.show(activity);
}
কোটলিন
fun showAdIfAvailable(activity: Activity, onShowAdCompleteListener: OnShowAdCompleteListener) {
  // If the app open ad is already showing, do not show the ad again.
  if (isShowingAd) {
    Log.d(TAG, "The app open ad is already showing.")
    return
  }
  // If the app open ad is not available yet, invoke the callback then load the ad.
  if (appOpenAd == null) {
    Log.d(TAG, "The app open ad is not ready yet.")
    onShowAdCompleteListener.onShowAdComplete()
    // Load an ad.
    return
  }
  isShowingAd = true
  appOpenAd?.show(activity)
}
FullScreenContentCallback সেট করুন
 FullScreenContentCallback আপনার AppOpenAd প্রদর্শনের সাথে সম্পর্কিত ইভেন্টগুলি পরিচালনা করে। AppOpenAd দেখানোর আগে, কলব্যাক সেট করতে ভুলবেন না: 
জাভা
appOpenAd.setFullScreenContentCallback(
    new FullScreenContentCallback() {
      @Override
      public void onAdDismissedFullScreenContent() {
        // Called when full screen content is dismissed.
        Log.d(TAG, "Ad dismissed fullscreen content.");
        // Don't forget to set the ad reference to null so you
        // don't show the ad a second time.
        appOpenAd = null;
        isShowingAd = false;
        onShowAdCompleteListener.onShowAdComplete();
        // Load an ad.
      }
      @Override
      public void onAdFailedToShowFullScreenContent(@NonNull AdError adError) {
        // Called when full screen content failed to show.
        Log.d(TAG, adError.getMessage());
        appOpenAd = null;
        // Don't forget to set the ad reference to null so you
        // don't show the ad a second time.
        isShowingAd = false;
        onShowAdCompleteListener.onShowAdComplete();
        // Load an ad.
      }
      @Override
      public void onAdShowedFullScreenContent() {
        Log.d(TAG, "Ad showed fullscreen content.");
      }
      @Override
      public void onAdImpression() {
        // Called when an impression is recorded for an ad.
        Log.d(TAG, "The ad recorded an impression.");
      }
      @Override
      public void onAdClicked() {
        // Called when ad is clicked.
        Log.d(TAG, "The ad was clicked.");
      }
    });
কোটলিন
appOpenAd?.fullScreenContentCallback =
  object : FullScreenContentCallback() {
    override fun onAdDismissedFullScreenContent() {
      // Called when full screen content is dismissed.
      Log.d(TAG, "Ad dismissed fullscreen content.")
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      appOpenAd = null
      isShowingAd = false
      onShowAdCompleteListener.onShowAdComplete()
      // Load an ad.
    }
    override fun onAdFailedToShowFullScreenContent(adError: AdError) {
      // Called when full screen content failed to show.
      Log.d(TAG, adError.message)
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      appOpenAd = null
      isShowingAd = false
      onShowAdCompleteListener.onShowAdComplete()
      // Load an ad.
    }
    override fun onAdShowedFullScreenContent() {
      Log.d(TAG, "Ad showed fullscreen content.")
    }
    override fun onAdImpression() {
      // Called when an impression is recorded for an ad.
      Log.d(TAG, "The ad recorded an impression.")
    }
    override fun onAdClicked() {
      // Called when ad is clicked.
      Log.d(TAG, "The ad was clicked.")
    }
  }
বিজ্ঞাপনের মেয়াদ শেষ হওয়ার কথা বিবেচনা করুন
 মেয়াদোত্তীর্ণ বিজ্ঞাপন যাতে না দেখায়, তার জন্য AppOpenAdManager এ একটি পদ্ধতি যোগ করুন যা আপনার বিজ্ঞাপনের রেফারেন্স লোড হওয়ার পর কতক্ষণ হয়েছে তা পরীক্ষা করে। তারপর, বিজ্ঞাপনটি এখনও বৈধ কিনা তা পরীক্ষা করার জন্য সেই পদ্ধতিটি ব্যবহার করুন। 
জাভা
/** Check if ad was loaded more than n hours ago. */
private boolean wasLoadTimeLessThanNHoursAgo(long numHours) {
  long dateDifference = (new Date()).getTime() - loadTime;
  long numMilliSecondsPerHour = 3600000;
  return (dateDifference < (numMilliSecondsPerHour * numHours));
}
/** Check if ad exists and can be shown. */
private boolean isAdAvailable() {
  // For time interval details, see: https://support.google.com/admob/answer/9341964
  return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4);
}
কোটলিন
/** Check if ad was loaded more than n hours ago. */
private fun wasLoadTimeLessThanNHoursAgo(numHours: Long): Boolean {
  val dateDifference: Long = Date().time - loadTime
  val numMilliSecondsPerHour: Long = 3600000
  return dateDifference < numMilliSecondsPerHour * numHours
}
/** Check if ad exists and can be shown. */
private fun isAdAvailable(): Boolean {
  // For time interval details, see: https://support.google.com/admob/answer/9341964
  return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4)
}
বর্তমান কার্যকলাপের উপর নজর রাখুন
 বিজ্ঞাপনটি দেখানোর জন্য, আপনার একটি Activity প্রসঙ্গ প্রয়োজন। ব্যবহৃত সাম্প্রতিক কার্যকলাপের ট্র্যাক রাখতে, Application.ActivityLifecycleCallbacks জন্য নিবন্ধন করুন এবং বাস্তবায়ন করুন। 
জাভা
@Override
public void onActivityCreated(@NonNull Activity activity, @Nullable Bundle savedInstanceState) {}
@Override
public void onActivityStarted(@NonNull Activity activity) {
  // An ad activity is started when an ad is showing, which could be AdActivity class from Google
  // SDK or another activity class implemented by a third party mediation partner. Updating the
  // currentActivity only when an ad is not showing will ensure it is not an ad activity, but the
  // one that shows the ad.
  if (!appOpenAdManager.isShowingAd) {
    currentActivity = activity;
  }
}
@Override
public void onActivityResumed(@NonNull Activity activity) {}
@Override
public void onActivityPaused(@NonNull Activity activity) {}
@Override
public void onActivityStopped(@NonNull Activity activity) {}
@Override
public void onActivitySaveInstanceState(@NonNull Activity activity, @NonNull Bundle outState) {}
@Override
public void onActivityDestroyed(@NonNull Activity activity) {}
কোটলিন
override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}
override fun onActivityStarted(activity: Activity) {
  // An ad activity is started when an ad is showing, which could be AdActivity class from Google
  // SDK or another activity class implemented by a third party mediation partner. Updating the
  // currentActivity only when an ad is not showing will ensure it is not an ad activity, but the
  // one that shows the ad.
  if (!appOpenAdManager.isShowingAd) {
    currentActivity = activity
  }
}
override fun onActivityResumed(activity: Activity) {}
override fun onActivityPaused(activity: Activity) {}
override fun onActivityStopped(activity: Activity) {}
override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}
override fun onActivityDestroyed(activity: Activity) {}
 registerActivityLifecycleCallbacks আপনাকে সমস্ত Activity ইভেন্ট শুনতে দেয়। Activity কখন শুরু এবং ধ্বংস করা হয় তা শুনে, আপনি বর্তমান Activity এর একটি রেফারেন্স ট্র্যাক করতে পারেন, যা আপনি আপনার অ্যাপ খোলা বিজ্ঞাপন উপস্থাপনের জন্য ব্যবহার করবেন।
অ্যাপের ফোরগ্রাউন্ডিং ইভেন্টগুলি শুনুন
অ্যাপের ফোরগ্রাউন্ড ইভেন্ট শুনতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
আপনার gradle ফাইলে লাইব্রেরিগুলি যোগ করুন
 অ্যাপ ফোরগ্রাউন্ডিং ইভেন্ট সম্পর্কে অবহিত হতে, আপনাকে একটি DefaultLifecycleObserver নিবন্ধন করতে হবে। আপনার অ্যাপ-লেভেল বিল্ড ফাইলে এর নির্ভরতা যোগ করুন: 
কোটলিন
dependencies { implementation("com.google.android.gms:play-services-ads:24.7.0") implementation("androidx.lifecycle:lifecycle-process:2.8.3") }
খাঁজকাটা
dependencies { implementation 'com.google.android.gms:play-services-ads:24.7.0' implementation 'androidx.lifecycle:lifecycle-process:2.8.3' }
জীবনচক্র পর্যবেক্ষক ইন্টারফেস বাস্তবায়ন করুন
 আপনি DefaultLifecycleObserver ইন্টারফেস প্রয়োগ করে ফোরগ্রাউন্ডিং ইভেন্টগুলি শুনতে পারেন।
 অ্যাপটি খোলা বিজ্ঞাপন দেখানোর জন্য onStart() প্রয়োগ করুন। 
জাভা
@Override
public void onStart(@NonNull LifecycleOwner owner) {
  DefaultLifecycleObserver.super.onStart(owner);
  // Show the ad (if available) when the app moves to foreground.
  appOpenAdManager.showAdIfAvailable(currentActivity);
}
কোটলিন
override fun onStart(owner: LifecycleOwner) {
  super.onStart(owner)
  currentActivity?.let {
    // Show the ad (if available) when the app moves to foreground.
    appOpenAdManager.showAdIfAvailable(it)
  }
}
কোল্ড স্টার্ট এবং লোডিং স্ক্রিন
এখন পর্যন্ত ডকুমেন্টেশন ধরে নিয়েছে যে ব্যবহারকারীরা যখন আপনার অ্যাপটি মেমোরিতে সাসপেন্ড করা থাকে তখনই কেবল অ্যাপ ওপেন বিজ্ঞাপন দেখান। "কোল্ড স্টার্ট" তখন ঘটে যখন আপনার অ্যাপটি চালু হয় কিন্তু আগে মেমোরিতে সাসপেন্ড করা হয়নি।
কোল্ড স্টার্টের একটি উদাহরণ হল যখন একজন ব্যবহারকারী প্রথমবার আপনার অ্যাপটি খোলেন। কোল্ড স্টার্টের মাধ্যমে, আপনার কাছে পূর্বে লোড করা কোনও অ্যাপ খোলা বিজ্ঞাপন থাকবে না যা তাৎক্ষণিকভাবে দেখানোর জন্য প্রস্তুত। আপনি যখন একটি বিজ্ঞাপনের অনুরোধ করেন এবং একটি বিজ্ঞাপন ফেরত পান তার মধ্যে বিলম্ব এমন পরিস্থিতি তৈরি করতে পারে যেখানে ব্যবহারকারীরা আপনার অ্যাপটি সংক্ষিপ্তভাবে ব্যবহার করতে সক্ষম হন এবং তারপরে কোনও অপ্রাসঙ্গিক বিজ্ঞাপন দেখে অবাক হন। এটি এড়ানো উচিত কারণ এটি একটি খারাপ ব্যবহারকারীর অভিজ্ঞতা।
কোল্ড স্টার্টে অ্যাপ ওপেন বিজ্ঞাপন ব্যবহার করার পছন্দের উপায় হল আপনার গেম বা অ্যাপ অ্যাসেট লোড করার জন্য একটি লোডিং স্ক্রিন ব্যবহার করা এবং শুধুমাত্র লোডিং স্ক্রিন থেকে বিজ্ঞাপনটি দেখানো। যদি আপনার অ্যাপ লোডিং সম্পন্ন করে থাকে এবং ব্যবহারকারীকে আপনার অ্যাপের মূল কন্টেন্টে পাঠিয়ে থাকে, তাহলে বিজ্ঞাপনটি দেখাবেন না।
সেরা অনুশীলন
অ্যাপ ওপেন বিজ্ঞাপনগুলি আপনার অ্যাপের লোডিং স্ক্রিন থেকে অর্থ উপার্জন করতে সাহায্য করে, অ্যাপটি প্রথম চালু হওয়ার সময় এবং অ্যাপ পরিবর্তনের সময়, তবে আপনার ব্যবহারকারীরা যাতে আপনার অ্যাপটি ব্যবহার করে উপভোগ করতে পারেন তার জন্য সেরা অনুশীলনগুলি মনে রাখা গুরুত্বপূর্ণ। এটি করা সবচেয়ে ভালো:
- আপনার ব্যবহারকারীরা আপনার অ্যাপটি কয়েকবার ব্যবহার করার পরে আপনার প্রথম অ্যাপ খোলা বিজ্ঞাপনটি দেখান।
- যখন আপনার ব্যবহারকারীরা আপনার অ্যাপ লোড হওয়ার জন্য অপেক্ষা করবেন, তখন অ্যাপ খোলার বিজ্ঞাপনগুলি দেখান।
-  যদি অ্যাপের নিচে একটি লোডিং স্ক্রিন থাকে এবং বিজ্ঞাপনটি খারিজ হওয়ার আগেই আপনার লোডিং স্ক্রিন লোডিং সম্পন্ন করে, তাহলে আপনি onAdDismissedFullScreenContent()পদ্ধতিতে আপনার লোডিং স্ক্রিন খারিজ করতে চাইতে পারেন।
GitHub-এ উদাহরণ
পরবর্তী পদক্ষেপ
নিম্নলিখিত বিষয়গুলি অন্বেষণ করুন: