আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

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

প্ল্যাটফর্ম বেছে নিন: Android iOS Android (Legacy)

নেটিভ বিজ্ঞাপন লোড হলে, GMA Next-Gen SDK সংশ্লিষ্ট বিজ্ঞাপন ফর্ম্যাটের জন্য লিসনারকে ইনভোক করে। আপনার অ্যাপকে বিজ্ঞাপন দেখাতে হবে, যদিও এটি সঙ্গে সঙ্গে করতে হবে না। সিস্টেম-সংজ্ঞায়িত বিজ্ঞাপন ফর্ম্যাট দেখানো সহজ করতে, SDK কিছু সহায়ক রিসোর্স অফার করে, যেমন নিচে বর্ণনা করা হয়েছে।

`NativeAdView` ক্লাস সম্পর্কে ব্যাখ্যা করো

NativeAdView ক্লাস বলতে কী বোঝায় তা ব্যাখ্যা করো। এই ক্লাসটি একটি ViewGroup ক্লাস এবং এটি NativeAdView ক্লাসের জন্য সবচেয়ে উপরের লেভেলের কন্টেনার। প্রতিটি নেটিভ বিজ্ঞাপন ভিউতে নেটিভ বিজ্ঞাপন অ্যাসেট থাকে, যেমন MediaView ভিউ এলিমেন্ট বা Title ভিউ এলিমেন্ট, যা অবশ্যই NativeAdView অবজেক্টের চাইল্ড হতে হবে।

XML লেআউট

আপনার প্রোজেক্টে XML NativeAdView যোগ করুন:

<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
    <LinearLayout
    android:orientation="vertical">
        <LinearLayout
        android:orientation="horizontal">
          <ImageView
          android:id="@+id/ad_app_icon" />
          <TextView
            android:id="@+id/ad_headline" />
        </LinearLayout>
        <!--Add remaining assets such as the image and media view.-->
    </LinearLayout>
</com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView>

Jetpack Compose

JetpackCompose Utilities ফোল্ডার অন্তর্ভুক্ত করুন। এই ফোল্ডারে NativeAdView অবজেক্ট ও অ্যাসেট কম্পোজ করার জন্য সহায়ক টুল রয়েছে।

NativeAdView কম্পোজ করুন:

  import com.google.android.gms.compose_util.NativeAdAttribution
  import com.google.android.gms.compose_util.NativeAdView

  @Composable
  /** Display a native ad with a user defined template. */
  fun DisplayNativeAdView(nativeAd: NativeAd) {
      NativeAdView {
          // Display the ad attribution.
          NativeAdAttribution(text = context.getString("Ad"))
          // Add remaining assets such as the image and media view.
        }
    }

লোড করা নেটিভ বিজ্ঞাপন ম্যানেজ করা

নেটিভ বিজ্ঞাপন লোড হলে, কলব্যাক ইভেন্ট ম্যানেজ করুন, নেটিভ বিজ্ঞাপন ভিউ বড় করুন এবং ভিউ হায়ারার্কিতে যোগ করুন:

Kotlin

// Build an ad request with native ad options to customize the ad.
val adTypes = listOf(NativeAd.NativeAdType.NATIVE)
val adRequest = NativeAdRequest
  .Builder("/21775744923/example/native", adTypes)
  .build()

val adCallback =
  object : NativeAdLoaderCallback {
    override fun onNativeAdLoaded(nativeAd: NativeAd) {
      activity?.runOnUiThread {

        val nativeAdBinding = NativeAdBinding.inflate(layoutInflater)
        val adView = nativeAdBinding.root
        val frameLayout = myActivityLayout.nativeAdPlaceholder

        // Populate and register the native ad asset views.
        displayNativeAd(nativeAd, nativeAdBinding)

        // Remove all old ad views and add the new native ad
        // view to the view hierarchy.
        frameLayout.removeAllViews()
        frameLayout.addView(adView)
      }
    }
  }

// Load the native ad with our request and callback.
NativeAdLoader.load(adRequest, adCallback)

Java

// Build an ad request with native ad options to customize the ad.
List<NativeAd.NativeAdType> adTypes = Arrays.asList(NativeAd.NativeAdType.NATIVE);
NativeAdRequest adRequest = new NativeAdRequest
                                .Builder("/21775744923/example/native", adTypes)
                                .build();

NativeAdLoaderCallback adCallback = new NativeAdLoaderCallback() {
    @Override
    public void onNativeAdLoaded(NativeAd nativeAd) {
      if (getActivity() != null) {
        getActivity()
          .runOnUiThread(() -> {
            // Inflate the native ad view and add it to the view hierarchy.
            NativeAdBinding nativeAdBinding = NativeAdBinding.inflate(getLayoutInflater());
            NativeAdView adView = (NativeAdView) nativeAdBinding.getRoot();
            FrameLayout frameLayout = myActivityLayout.nativeAdPlaceholder;

            // Populate and register the native ad asset views.
            displayNativeAd(nativeAd, nativeAdBinding);

            // Remove all old ad views and add the new native ad
            // view to the view hierarchy.
            frameLayout.removeAllViews();
            frameLayout.addView(adView);
        });
      }
    }
};

// Load the native ad with our request and callback.
NativeAdLoader.load(adRequest, adCallback);

মনে রাখবেন, কোনও নির্দিষ্ট নেটিভ বিজ্ঞাপনের সব অ্যাসেটকে NativeAdView লেআউটের মধ্যে রেন্ডার করতে হবে। GMA Next-Gen SDK সতর্কতা লগ করার চেষ্টা করে যখন নেটিভ বিজ্ঞাপন ভিউ লেআউটের বাইরে নেটিভ অ্যাসেট রেন্ডার করা হয়।

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

রেকর্ডিং ক্লিক
স্ক্রিনে প্রথম পিক্সেল দেখা গেলে ইম্প্রেশন রেকর্ড করা
নেটিভ ব্যাকফিল ক্রিয়েটিভের জন্য AdChoices ওভারলে দেখানো—বর্তমানে বাছাই করা প্রকাশকদের একটি গ্রুপের মধ্যে সীমাবদ্ধ

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

নিম্নলিখিত উদাহরণ থেকে কীভাবে নেটিভ বিজ্ঞাপন দেখানো যায় তা বোঝা যায়:

Kotlin

private fun displayNativeAd(nativeAd: NativeAd, nativeAdBinding : NativeAdBinding) {
  // Set the native ad view elements.
  val nativeAdView = nativeAdBinding.root
  nativeAdView.advertiserView = nativeAdBinding.adAdvertiser
  nativeAdView.bodyView = nativeAdBinding.adBody
  nativeAdView.callToActionView = nativeAdBinding.adCallToAction
  nativeAdView.headlineView = nativeAdBinding.adHeadline
  nativeAdView.iconView = nativeAdBinding.adAppIcon
  nativeAdView.priceView = nativeAdBinding.adPrice
  nativeAdView.starRatingView = nativeAdBinding.adStars
  nativeAdView.storeView = nativeAdBinding.adStore

  // Set the view element with the native ad assets.
  nativeAdBinding.adAdvertiser.text = nativeAd.advertiser
  nativeAdBinding.adBody.text = nativeAd.body
  nativeAdBinding.adCallToAction.text = nativeAd.callToAction
  nativeAdBinding.adHeadline.text = nativeAd.headline
  nativeAdBinding.adAppIcon.setImageDrawable(nativeAd.icon?.drawable)
  nativeAdBinding.adPrice.text = nativeAd.price
  nativeAd.starRating?.toFloat().let { value ->
    nativeAdBinding.adStars.rating = value
  }
  nativeAdBinding.adStore.text = nativeAd.store

  // Hide views for assets that don't have data.
  nativeAdBinding.adAdvertiser.visibility = getAssetViewVisibility(nativeAd.advertiser)
  nativeAdBinding.adBody.visibility = getAssetViewVisibility(nativeAd.body)
  nativeAdBinding.adCallToAction.visibility = getAssetViewVisibility(nativeAd.callToAction)
  nativeAdBinding.adHeadline.visibility = getAssetViewVisibility(nativeAd.headline)
  nativeAdBinding.adAppIcon.visibility = getAssetViewVisibility(nativeAd.icon)
  nativeAdBinding.adPrice.visibility = getAssetViewVisibility(nativeAd.price)
  nativeAdBinding.adStars.visibility = getAssetViewVisibility(nativeAd.starRating)
  nativeAdBinding.adStore.visibility = getAssetViewVisibility(nativeAd.store)

  // Inform GMA Next-Gen SDK that you have finished populating
  // the native ad views with this native ad.
  nativeAdView.registerNativeAd(nativeAd, nativeAdBinding.adMedia)
}

/**
* Determines the visibility of an asset view based on the presence of its asset.
*
* @param asset The native ad asset to check for nullability.
* @return [View.VISIBLE] if the asset is not null, [View.INVISIBLE] otherwise.
*/
private fun getAssetViewVisibility(asset: Any?): Int {
  return if (asset == null) View.INVISIBLE else View.VISIBLE
}

Java

private void displayNativeAd(ad: NativeAd, nativeAdBinding : NativeAdBinding) {
  // Set the native ad view elements.
  NativeAdView nativeAdView = nativeAdBinding.getRoot();
  nativeAdView.setAdvertiserView(nativeAdBinding.adAdvertiser);
  nativeAdView.setBodyView(nativeAdBinding.adBody);
  nativeAdView.setCallToActionView(nativeAdBinding.adCallToAction);
  nativeAdView.setHeadlineView(nativeAdBinding.adHeadline);
  nativeAdView.setIconView(nativeAdBinding.adAppIcon);
  nativeAdView.setPriceView(nativeAdBinding.adPrice);
  nativeAdView.setStarRatingView(nativeAdBinding.adStars);
  nativeAdView.setStoreView(nativeAdBinding.adStore);

  // Set the view element with the native ad assets.
  nativeAdBinding.adAdvertiser.setText(nativeAd.getAdvertiser());
  nativeAdBinding.adBody.setText(nativeAd.getBody());
  nativeAdBinding.adCallToAction.setText(nativeAd.getCallToAction());
  nativeAdBinding.adHeadline.setText(nativeAd.getHeadline());
  if (nativeAd.getIcon() != null) {
      nativeAdBinding.adAppIcon.setImageDrawable(nativeAd.getIcon().getDrawable());
  }
  nativeAdBinding.adPrice.setText(nativeAd.getPrice());
  if (nativeAd.getStarRating() != null) {
      nativeAdBinding.adStars.setRating(nativeAd.getStarRating().floatValue());
  }
  nativeAdBinding.adStore.setText(nativeAd.getStore());

  // Hide views for assets that don't have data.
  nativeAdBinding.adAdvertiser.setVisibility(getAssetViewVisibility(nativeAd.getAdvertiser()));
  nativeAdBinding.adBody.setVisibility(getAssetViewVisibility(nativeAd.getBody()));
  nativeAdBinding.adCallToAction.setVisibility(getAssetViewVisibility(nativeAd.getCallToAction()));
  nativeAdBinding.adHeadline.setVisibility(getAssetViewVisibility(nativeAd.getHeadline()));
  nativeAdBinding.adAppIcon.setVisibility(getAssetViewVisibility(nativeAd.getIcon()));
  nativeAdBinding.adPrice.setVisibility(getAssetViewVisibility(nativeAd.getPrice()));
  nativeAdBinding.adStars.setVisibility(getAssetViewVisibility(nativeAd.getStarRating()));
  nativeAdBinding.adStore.setVisibility(getAssetViewVisibility(nativeAd.getStore()));

  // Inform GMA Next-Gen SDK that you have finished populating
  // the native ad views with this native ad.
  nativeAdView.registerNativeAd(nativeAd, nativeAdBinding.adMedia);
}

/**
* Determines the visibility of an asset view based on the presence of its asset.
*
* @param asset The native ad asset to check for nullability.
* @return {@link View#VISIBLE} if the asset is not null, {@link View#INVISIBLE} otherwise.
*/
private int getAssetViewVisibility(Object asset) {
    return (asset == null) ? View.INVISIBLE : View.VISIBLE;
}

AdChoices ওভারলে

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

প্রোগ্র্যামাটিক নেটিভ বিজ্ঞাপনের জন্য বিজ্ঞাপন অ্যাট্রিবিউশন

প্রোগ্রামাটিক নেটিভ বিজ্ঞাপন দেখানোর সময়, ভিউটি যে একটি বিজ্ঞাপন তা বোঝাতে আপনাকে অবশ্যই একটি বিজ্ঞাপন অ্যাট্রিবিউশন দেখাতে হবে। আমাদের নীতি নির্দেশিকা থেকে আরও জানুন।

ক্লিক ম্যানেজ করা

নেটিভ বিজ্ঞাপন ভিউয়ের উপরে বা সেটির মধ্যে কোনও ভিউতে কাস্টম ক্লিক হ্যান্ডলার প্রয়োগ করবেন না। আপনি সঠিকভাবে অ্যাসেট ভিউ পপুলেট ও রেজিস্টার করলে, SDK বিজ্ঞাপন ভিউ অ্যাসেটে হওয়া ক্লিক ম্যানেজ করে।

ক্লিক শোনার জন্য, GMA Next-Gen SDK ক্লিক কলব্যাক প্রয়োগ করুন:

Kotlin

private fun setEventCallback(nativeAd: NativeAd) {
  nativeAd.adEventCallback =
    object : NativeAdEventCallback {
      override fun onAdClicked() {
        Log.d(Constant.TAG, "Native ad recorded a click.")
      }
    }
}

Java

private void setEventCallback(NativeAd nativeAd) {
  nativeAd.setAdEventCallback(new NativeAdEventCallback() {
      @Override
      public void onAdClicked() {
        Log.d(Constant.TAG, "Native ad recorded a click.");
      }
  });
}

ImageScaleType

ছবি দেখানোর সময় MediaView ক্লাসে ImageScaleType প্রপার্টি থাকে। MediaView-এ কোনও ছবি কীভাবে স্কেল করা হয় তা পরিবর্তন করতে চাইলে, MediaView-এর setImageScaleType() মেথড ব্যবহার করে সংশ্লিষ্ট ImageView.ScaleType সেট করুন:

Kotlin

nativeAdViewBinding.mediaView.imageScaleType = ImageView.ScaleType.CENTER_CROP

Java

nativeAdViewBinding.mediaView.setImageScaleType(ImageView.ScaleType.CENTER_CROP);

MediaContent

MediaContent ক্লাসে নেটিভ বিজ্ঞাপনের মিডিয়া কন্টেন্ট সম্পর্কিত ডেটা থাকে যা MediaView ক্লাস ব্যবহার করে দেখানো হয়। MediaContent ইনস্ট্যান্সের সাথে MediaView mediaContent প্রপার্টি সেট করা হলে:

ভিডিও অ্যাসেট উপলভ্য থাকলে, সেটি বাফার করা হয় এবং MediaView-এর মধ্যে চালানো শুরু হয়। ভিডিও অ্যাসেট উপলভ্য আছে কিনা তা আপনি hasVideoContent() চেক করে দেখতে পারেন।
বিজ্ঞাপনে ভিডিও অ্যাসেট না থাকলে, mainImage অ্যাসেট ডাউনলোড করা হয় এবং তার পরিবর্তে MediaView-এর মধ্যে প্লেস করা হয়।

ক্রিয়েটিভের সারসংক্ষেপ যোগ করা

কনভারসেশনাল ও AI চ্যাট অ্যাপ্লিকেশনে, GMA Next-Gen SDK বিজ্ঞাপনের ক্রিয়েটিভের জন্য একটি ক্রিয়েটিভ সারসংক্ষেপ অ্যাসেট (creativeSummary) প্রদান করে। আপনি একটি প্রাথমিক মেসেজের মাধ্যমে আপনার অ্যাপের চ্যাট ফ্লোতে বিজ্ঞাপন যোগ করতে পারবেন।

আপনার লেআউটে টেক্সট ভিউ যোগ করুন

আপনার NativeAdView কন্টেনার লেআউটের মধ্যে ক্রিয়েটিভ সারসংক্ষেপ অ্যাসেটের জন্য TextView যোগ করুন:

<TextView
    android:id="@+id/ad_creative_summary"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:textSize="13sp" />

ভিউ পপুলেট ও রেজিস্টার করা

creativeSummary দিয়ে TextView পূরণ করুন এবং আপনার NativeAdView অবজেক্টে creativeSummaryView প্রপার্টির সাথে এটি রেজিস্টার করুন। ভিউ রেজিস্টার করলে, ক্রিয়েটিভ সারসংক্ষেপ অ্যাসেটের জন্য অটোমেটিক ক্লিক ট্র্যাক করা যায়।

Kotlin

private fun populateCreativeSummary(
  nativeAd: NativeAd,
  nativeAdBinding: NativeAdBinding,
  nativeAdView: NativeAdView,
) {
  val summary = nativeAd.creativeSummary
  if (summary == null) {
    nativeAdBinding.adCreativeSummary.visibility = View.GONE
    return
  }

  nativeAdBinding.adCreativeSummary.text = summary
  nativeAdBinding.adCreativeSummary.visibility = View.VISIBLE
  nativeAdView.creativeSummaryView = nativeAdBinding.adCreativeSummary
}

Java

private void populateCreativeSummary(
    NativeAd nativeAd, NativeAdBinding nativeAdBinding, NativeAdView nativeAdView) {
  String summary = nativeAd.getCreativeSummary();
  if (summary == null) {
    nativeAdBinding.adCreativeSummary.setVisibility(View.GONE);
    return;
  }

  nativeAdBinding.adCreativeSummary.setText(summary);
  nativeAdBinding.adCreativeSummary.setVisibility(View.VISIBLE);
  nativeAdView.setCreativeSummaryView(nativeAdBinding.adCreativeSummary);
}

ক্লিক ট্র্যাকিং ও পরিবর্তিত টেক্সট

সরাসরি রেন্ডারিং: SDK-এর দেওয়া creativeSummary স্ট্রিং ঠিকঠাক রেন্ডার করলে, SDK ক্লিক হ্যান্ডেল করার সুবিধা চালু করতে, NativeAdView কন্টেনারের মধ্যে থাকা creativeSummaryView প্রপার্টির সাথে এটি রেজিস্টার করুন।
পরিবর্তিত ভূমিকা: আপনার অ্যাপ যদি ক্রিয়েটিভ সারসংক্ষেপে কাস্টম কথোপকথনের টেক্সট পরিবর্তন, সংক্ষিপ্ত বা যোগ করে, তাহলে পরিবর্তিত টেক্সটটি NativeAdView কন্টেনারের বাইরে রাখুন।

বিজ্ঞাপন সরিয়ে দেওয়া

নেটিভ বিজ্ঞাপন দেখানোর পরে, বিজ্ঞাপনটি সরিয়ে দিন। নিচের উদাহরণটি একটি নেটিভ বিজ্ঞাপন ধ্বংস করে:

Kotlin

nativeAd.destroy()

Java

nativeAd.destroy();

নেটিভ বিজ্ঞাপন কোড পরীক্ষা করা

সরাসরি বিক্রি হওয়া বিজ্ঞাপন

সরাসরি বিক্রি করা নেটিভ বিজ্ঞাপন কেমন হয় তা পরীক্ষা করে দেখতে চাইলে, আপনি এই Ad Manager বিজ্ঞাপন ইউনিট আইডি ব্যবহার করতে পারেন:

/21775744923/example/native

এটি স্যাম্পেল অ্যাপ ইনস্টল ও কন্টেন্ট বিজ্ঞাপন এবং নিম্নলিখিত অ্যাসেট সহ কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট পরিবেশন করার জন্য কনফিগার করা হয়েছে:

শিরোনাম (টেক্সট)
MainImage (image)
ক্যাপশন (টেক্সট)

কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটের টেমপ্লেট আইডি হল 10063170।

নেটিভ ব্যাকফিল বিজ্ঞাপন

Ad Exchange ব্যাকফিল সীমিত সংখ্যক প্রকাশকদের জন্য উপলভ্য। নেটিভ ব্যাকফিল বিজ্ঞাপনের আচরণ টেস্ট করতে, এই Ad Manager বিজ্ঞাপন ইউনিট ব্যবহার করুন:

/21775744923/example/native-backfill

এটি AdChoices ওভারলে সহ নমুনা অ্যাপ ইনস্টল ও কন্টেন্ট বিজ্ঞাপন পরিবেশন করে।

লাইভ হওয়ার আগে আপনার আসল বিজ্ঞাপন ইউনিট ও টেমপ্লেট আইডি রেফার করার জন্য কোড আপডেট করতে ভুলবেন না।

পরবর্তী ধাপ

নিম্নলিখিত বিষয়গুলি এক্সপ্লোর করুন:

ব্যবহারকারীর গোপনীয়তা

উদাহরণ

GMA Next-Gen SDK-এর ব্যবহার ডেমোনস্ট্রেট করে এমন উদাহরণ অ্যাপ ডাউনলোড ও রান করান।

NativeAdView ক্লাস সম্পর্কে ব্যাখ্যা করো

XML লেআউট

Jetpack Compose

লোড করা নেটিভ বিজ্ঞাপন ম্যানেজ করা

Kotlin

Java

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

Kotlin

Java

AdChoices ওভারলে

প্রোগ্র্যামাটিক নেটিভ বিজ্ঞাপনের জন্য বিজ্ঞাপন অ্যাট্রিবিউশন

ক্লিক ম্যানেজ করা

Kotlin

Java

ImageScaleType

Kotlin

Java

MediaContent

ক্রিয়েটিভের সারসংক্ষেপ যোগ করা

আপনার লেআউটে টেক্সট ভিউ যোগ করুন

ভিউ পপুলেট ও রেজিস্টার করা

Kotlin

Java

ক্লিক ট্র্যাকিং ও পরিবর্তিত টেক্সট

বিজ্ঞাপন সরিয়ে দেওয়া

Kotlin

Java

নেটিভ বিজ্ঞাপন কোড পরীক্ষা করা

সরাসরি বিক্রি হওয়া বিজ্ঞাপন

নেটিভ ব্যাকফিল বিজ্ঞাপন

পরবর্তী ধাপ

উদাহরণ

`NativeAdView` ক্লাস সম্পর্কে ব্যাখ্যা করো