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

একক-লোড এপিআই সহ এসডিকে।

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

আরও তথ্যের জন্য, অ্যাপ খোলার বিজ্ঞাপন নির্দেশিকা দেখুন।

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

পূর্বশর্ত

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

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

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

টেস্ট বিজ্ঞাপন লোড করতে, অ্যান্ড্রয়েড অ্যাপে বিজ্ঞাপন খোলার জন্য নির্দিষ্ট টেস্ট অ্যাড ইউনিট আইডি ব্যবহার করুন:

ca-app-pub-3940256099942544/9257395921

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

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

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

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

কোটলিন 

// Load ads after you initialize MobileAds.
AppOpenAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<AppOpenAd> {
    override fun onAdLoaded(ad: AppOpenAd) {
      // App open ad loaded.
      appOpenAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // App open ad failed to load.
      Log.e(TAG, "App open ad failed to load: ${adError.message}")
      appOpenAd = null
    }
  },
)

জাভা 

// Load ads after you initialize MobileAds.
AppOpenAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<AppOpenAd>() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // App open ad loaded.
        appOpenAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError adError) {
        // App open ad failed to load.
        Log.e(TAG, "App open ad failed to load: " + adError.getMessage());
        appOpenAd = null;
      }
    });

পরীক্ষা করার সময়, এই টেস্ট অ্যাড ইউনিট আইডিটি ব্যবহার করুন: ca-app-pub-3940256099942544/9257395921 ।

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

অ্যাপ খোলার বিজ্ঞাপন দেখাতে, show মেথডটি ব্যবহার করুন।

কোটলিন 

private fun showAd(appOpenAd: AppOpenAd, activity: Activity) {
  // Show the ad.
  appOpenAd.show(activity)
}

জাভা 

private void showAd(AppOpenAd appOpenAd, Activity activity) {
  // Show the ad.
  appOpenAd.show(activity);
}

বিজ্ঞাপনের ঘটনাগুলো শুনুন

বিজ্ঞাপন দেখানোর আগে, বিজ্ঞাপনের জীবনচক্রের ঘটনাগুলো শুনুন:

কোটলিন 

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

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

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

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

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

জাভা 

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

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

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

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

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

কোল্ড স্টার্ট এবং লোডিং স্ক্রিন

কোল্ড স্টার্ট ঘটে যখন আপনার অ্যাপ একেবারে নতুন করে চালু হয়, যেমন—যখন কোনো ব্যবহারকারী প্রথমবারের মতো আপনার অ্যাপটি খোলেন অথবা মেমরি বন্ধ হয়ে যাওয়ার পর। কোল্ড স্টার্টের সময়, সাথে সাথে দেখানোর জন্য আগে থেকে লোড করা কোনো অ্যাপ ওপেন অ্যাড থাকে না।

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

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

সর্বোত্তম অনুশীলন

অ্যাপ খোলার বিজ্ঞাপন (app open ads) পাওয়ার জন্য এই সেরা পদ্ধতিগুলো অনুসরণ করুন:

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