ডিসপ্লে-টাইপ কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট ও ওপেন মেজারমেন্ট

এই নির্দেশিকায় কীভাবে ওপেন মেজারমেন্টের সাথে কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট ইন্টিগ্রেট করতে হয় তা ব্যাখ্যা করা হয়েছে।

পূর্বশর্ত

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

ইন্টিগ্রেশন

আপনি যদি কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটের সাথে ওপেন মেজারমেন্ট ব্যবহার করার পরিকল্পনা করেন, যেগুলিতে ভিডিও অ্যাসেট নেই, তাহলে আপনাকে নিজেই ওপেন মেজারমেন্ট API কল করতে হবে।

আপনি যদি ভিডিও অ্যাসেট সহ কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট ব্যবহার করেন, তাহলে আপনাকে এই নির্দেশিকা অনুসরণ করতে হবে না; Mobile Ads SDK আপনার হয়ে ভিডিও অ্যাসেটের ভিউঅ্যাবিলিটি ট্র্যাক করে।

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

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

Java

private void loadCustomNativeAd(Context context, ViewGroup nativeCustomFormatAdContainer) {

  AdLoader adLoader =
      new AdLoader.Builder(context, "AD_UNIT_ID")
          .forCustomFormatAd(
              "CUSTOM_TEMPLATE_ID",
              new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
                @Override
                public void onCustomFormatAdLoaded(@NonNull NativeCustomFormatAd ad) {
                  // Show the ad first and then register your view and begin open measurement.
                  // Make sure to do this on the main thread.

                  // ...
                  // Show ad
                  // ...

                  startOpenMeasurement(ad, nativeCustomFormatAdContainer);
                }
              },
              new NativeCustomFormatAd.OnCustomClickListener() {
                @Override
                public void onCustomClick(NativeCustomFormatAd ad, String assetName) {
                  // Handle the click action
                }
              })
          .build();
  adLoader.loadAd(new AdRequest.Builder().build());
}

Kotlin

private fun loadCustomNativeAd(context: Context, nativeCustomFormatAdContainer: ViewGroup) {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forCustomFormatAd(
        "CUSTOM_TEMPLATE_ID",
        NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad ->
          // Show the ad first and then register your view and begin open measurement. Make sure
          // to do this on the main thread.

          // ...
          // Show ad
          // ...

          startOpenMeasurement(ad, nativeCustomFormatAdContainer)
        },
        NativeCustomFormatAd.OnCustomClickListener { ad, assetName ->
          // Handle the click action.
        },
      )
      .build()

  adLoader.loadAd(AdRequest.Builder().build())
}

আপনার বিজ্ঞাপন ইউনিট আইডি ও কাস্টম টেমপ্লেট আইডি দিয়ে AD_UNIT_ID ও CUSTOM_TEMPLATE_ID পাল্টে দিন।

আপনার ভিউ রেজিস্টার করুন এবং পরিমাপ করা শুরু করুন

কাস্টম নেটিভ বিজ্ঞাপনে ওপেন মেজারমেন্ট চালু করতে, প্রথমে বিজ্ঞাপনটি দেখান এবং তারপরে কাস্টম নেটিভ বিজ্ঞাপনের সাথে যুক্ত DisplayOpenMeasurement অবজেক্টের সাথে আপনার কাস্টম বিজ্ঞাপন ভিউ রেজিস্টার করুন। DisplayOpenMeasurement অবজেক্ট ওপেন মেজারমেন্টের সাথে আপনার কন্টেনার ভিউ রেজিস্টার করার setView() পদ্ধতি প্রদান করে।

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

এটি দেখতে কেমন তা এখানে দেওয়া হল:

Java

private void startOpenMeasurement(
    NativeCustomFormatAd ad, ViewGroup nativeCustomFormatAdContainer) {
  DisplayOpenMeasurement displayOpenMeasurement = ad.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeCustomFormatAdContainer);
    displayOpenMeasurement.start();
  }
}

Kotlin

private fun startOpenMeasurement(
  ad: NativeCustomFormatAd,
  nativeCustomFormatAdContainer: ViewGroup,
) {
  ad.getDisplayOpenMeasurement()?.let { displayOpenMeasurement ->
    displayOpenMeasurement.setView(nativeCustomFormatAdContainer)
    displayOpenMeasurement.start()
  }
}

মনে রাখবেন, আপনার মতামত জানানোর আগে বিজ্ঞাপনটি দেখাতে হবে। আপনার বিজ্ঞাপন দেখানো কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটে কভার করা আছে।

customTemplateAdFrame লেআউট হল কাস্টম নেটিভ বিজ্ঞাপনের জন্য বিজ্ঞাপন কন্টেনার এবং এতে ভিউয়ের বাউন্ডিং বক্সের মধ্যে থাকা সব অ্যাসেট থাকতে হবে।

IAB-এর মাধ্যমে সার্টিফাই করা

আপনার অ্যাপ রিলিজ করার পরে, আপনি পরিমাপ সংক্রান্ত ডেটা পেতে শুরু করবেন; তবে, আপনি IAB সার্টিফিকেশন প্রসেস সম্পূর্ণ না করা পর্যন্ত আপনার ডেটা সার্টিফাই করা হবে না।