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

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

পূর্বশর্ত

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

একীকরণ

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

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

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

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

জাভা 

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());
}

CustomNativeOMIDSnippets.java

কোটলিন 

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())
}

CustomNativeOMIDSnippets.kt

AD_UNIT_ID এবং CUSTOM_TEMPLATE_ID জায়গায় আপনার অ্যাড ইউনিট আইডি এবং কাস্টম টেমপ্লেট আইডি বসান।

আপনার মতামত নিবন্ধন করুন এবং পরিমাপ শুরু করুন।

একটি কাস্টম নেটিভ অ্যাডে ওপেন মেজারমেন্ট সক্রিয় করতে, প্রথমে অ্যাডটি প্রদর্শন করুন এবং তারপরে কাস্টম নেটিভ অ্যাডের সাথে যুক্ত DisplayOpenMeasurement অবজেক্টের সাথে আপনার কাস্টম অ্যাড ভিউটি রেজিস্টার করুন। DisplayOpenMeasurement অবজেক্টটি আপনার কন্টেইনার ভিউকে ওপেন মেজারমেন্টের সাথে রেজিস্টার করার জন্য setView() মেথড প্রদান করে।

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

এটা দেখতে এইরকম:

জাভা 

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

কোটলিন 

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

CustomNativeOMIDSnippets.kt

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

customTemplateAdFrame লেআউটটি হলো কাস্টম নেটিভ অ্যাডের অ্যাড কন্টেইনার এবং এর মধ্যে অবশ্যই ভিউটির বাউন্ডিং বক্সের ভেতরের সমস্ত অ্যাসেট থাকতে হবে।

IAB দ্বারা প্রত্যয়িত

আপনার অ্যাপটি প্রকাশ করার পর আপনি পরিমাপের ডেটা পেতে শুরু করবেন; তবে, IAB সার্টিফিকেশন প্রক্রিয়াটি সম্পন্ন না করা পর্যন্ত আপনার ডেটা প্রত্যয়িত হবে না।