গুগল অ্যাডভারটাইজিং অ্যান্ড মেজারমেন্ট কমিউনিটি সার্ভারের #gma-next-gen-sdk ডিসকর্ড চ্যানেলে GMA নেক্সট-জেন SDK সম্পর্কে আপনার মতামত শেয়ার করুন।

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

ব্যানার বিজ্ঞাপন সেট আপ করুন,ব্যানার বিজ্ঞাপন সেট আপ করুন

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা)

অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

ব্যানার বিজ্ঞাপন হলো আয়তাকার বিজ্ঞাপন যা অ্যাপের লেআউটের একটি অংশ জুড়ে থাকে। অ্যাঙ্কর্ড অ্যাডাপ্টিভ ব্যানার হলো নির্দিষ্ট আকৃতির বিজ্ঞাপন যা ব্যবহারকারীরা অ্যাপটি ব্যবহার করার সময় স্ক্রিনের উপরে বা নীচে অ্যাঙ্কর করা থাকে।

এই নির্দেশিকায় একটি অ্যান্ড্রয়েড অ্যাপে অ্যাঙ্করড অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপন লোড করার পদ্ধতি আলোচনা করা হয়েছে।

পূর্বশর্ত

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

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

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

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

/21775744923/example/adaptive-banner

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

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

একটি `AdView` অবজেক্ট তৈরি করুন

ব্যানার প্রদর্শন করতে, নিম্নলিখিতগুলি করুন:

কোটলিন

একটি AdView অবজেক্ট তৈরি করুন।
আপনার অ্যাপের লেআউটে AdView অবজেক্টটি যোগ করুন।

নিম্নলিখিত উদাহরণটি একটি অ্যাপ লেআউটে AdView অবজেক্ট তৈরি করে এবং যোগ করে:

private fun createAdView(adViewContainer: FrameLayout, activity: Activity) {
  val adView = AdView(activity)
  adViewContainer.addView(adView)
}
BannerSnippets.kt

জাভা

একটি AdView অবজেক্ট তৈরি করুন।
আপনার অ্যাপের লেআউটে AdView অবজেক্টটি যোগ করুন।

নিম্নলিখিত উদাহরণটি একটি অ্যাপ লেআউটে AdView অবজেক্ট তৈরি করে এবং যোগ করে:

private void createAdView(FrameLayout adViewContainer, Activity activity) {
  AdView adView = new AdView(activity);
  adViewContainer.addView(adView);
}
BannerSnippets.java

এক্সএমএল লেআউট

আপনার লেআউট XML ফাইলে একটি AdView এলিমেন্ট যোগ করুন:

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

  <com.google.android.libraries.ads.mobile.sdk.banner.AdView
      android:id="@+id/adView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      app:layout_constraintBottom_toBottomOf="parent"
      app:layout_constraintEnd_toEndOf="parent"
      app:layout_constraintStart_toStartOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

জেটপ্যাক কম্পোজ

Compose UI-তে একটি AndroidView এলিমেন্ট অন্তর্ভুক্ত করুন।
ব্যানার বিজ্ঞাপন ধারণ করার জন্য একটি mutableStateOf<BannerAd?> ভেরিয়েবল সংজ্ঞায়িত করুন:

// Initialize required variables.
val context = LocalContext.current
var bannerAdState by remember { mutableStateOf<BannerAd?>(null) }

// The AdView is placed at the bottom of the screen.
Column(modifier = modifier.fillMaxSize(), verticalArrangement = Arrangement.Bottom) {
  bannerAdState?.let { bannerAd ->
    Box(modifier = Modifier.fillMaxWidth()) {
      // Display the ad within an AndroidView.
      AndroidView(
        modifier = modifier.wrapContentSize(),
        factory = { bannerAd.getView(requireActivity()) },
      )
    }
  }
}ComposeBannerFragment.kt

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

নিম্নলিখিত উদাহরণটি একটি AdView অবজেক্টে ৩৬০-প্রস্থের অ্যাঙ্করড অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপন লোড করে:

কোটলিন

private fun loadBannerAd(adView: AdView, activity: Activity) {
  // Get a BannerAdRequest for a 360 wide large anchored adaptive banner ad.
  val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360)
  val adRequest = BannerAdRequest.Builder(AD_UNIT_ID, adSize).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.d(TAG, "Banner ad loaded.")
      }

      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Banner ad failed to load: $adError")
      }
    },
  )
}
BannerSnippets.kt

জাভা

private void loadBannerAd(AdView adView, Activity activity) {
  // Get a BannerAdRequest for a 360 wide large anchored adaptive banner ad.
  AdSize adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360);
  BannerAdRequest adRequest = new BannerAdRequest.Builder(AD_UNIT_ID, adSize).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd bannerAd) {
          Log.d(TAG, "Banner ad loaded.");
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Banner ad failed to load: " + adError);
        }
      });
}
BannerSnippets.java

জেটপ্যাক কম্পোজ

// Request an large anchored adaptive banner with a width of 360.
val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(requireContext(), 360)

// Load the ad when the screen is active.
val coroutineScope = rememberCoroutineScope()
val isPreviewMode = LocalInspectionMode.current
LaunchedEffect(context) {
  bannerAdState?.destroy()
  if (!isPreviewMode) {
    coroutineScope.launch {
      when (val result = BannerAd.load(BannerAdRequest.Builder(AD_UNIT_ID, adSize).build())) {
        is AdLoadResult.Success -> {
          bannerAdState = result.ad
        }
        is AdLoadResult.Failure -> {
          showToast("Banner failed to load.")
          Log.w(Constant.TAG, "Banner ad failed to load: $result.error")
        }
      }
    }
  }
}ComposeBannerFragment.kt

একটি বিজ্ঞাপন রিফ্রেশ করুন

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

একটি বিজ্ঞাপন রিসোর্স প্রকাশ করুন

ব্যানার বিজ্ঞাপন ব্যবহার করা শেষ হলে, আপনি সেটির রিসোর্সগুলো মুক্ত করতে পারেন।

বিজ্ঞাপনের রিসোর্সটি মুক্ত করতে, আপনাকে ভিউ হায়ারার্কি থেকে বিজ্ঞাপনটি সরিয়ে ফেলতে হবে এবং এর সমস্ত রেফারেন্স ড্রপ করতে হবে:

কোটলিন

// Remove banner from view hierarchy.
val parentView = adView?.parent
if (parentView is ViewGroup) {
  parentView.removeView(adView)
}

// Destroy the banner ad resources.
adView?.destroy()

// Drop reference to the banner ad.
adView = null

জাভা

// Remove banner from view hierarchy.
if (adView.getParent() instanceof ViewGroup) {
  ((ViewGroup) adView.getParent()).removeView(adView);
}
// Destroy the banner ad resources.
adView.destroy();
// Drop reference to the banner ad.
adView = null;

জেটপ্যাক কম্পোজ


// Destroy the ad when the screen is disposed.
DisposableEffect(Unit) { onDispose { bannerAdState?.destroy() } }ComposeBannerFragment.kt

বিজ্ঞাপন ইভেন্ট

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

কোটলিন

override fun onAdLoaded(ad: BannerAd) {
  ad.adEventCallback =
    object : BannerAdEventCallback {
      override fun onAdImpression() {
        // Banner ad recorded an impression.
        Log.d(TAG, "Banner ad recorded an impression.")
      }

      override fun onAdClicked() {
        // Banner ad recorded a click.
        Log.d(TAG, "Banner ad clicked.")
      }

      override fun onAdShowedFullScreenContent() {
        // Banner ad showed.
        Log.d(TAG, "Banner ad showed full screen content.")
      }

      override fun onAdDismissedFullScreenContent() {
        // Banner ad dismissed.
        Log.d(TAG, "Banner ad dismissed full screen content.")
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // Banner ad failed to show.
        Log.w(TAG, "Banner ad failed to show full screen content: $fullScreenContentError")
      }
    }
}
BannerSnippets.kt

জাভা

@Override
public void onAdLoaded(@NonNull BannerAd bannerAd) {
  bannerAd.setAdEventCallback(
      new BannerAdEventCallback() {
        @Override
        public void onAdImpression() {
          // Banner ad recorded an impression.
          Log.d(TAG, "Banner ad recorded an impression.");
        }

        @Override
        public void onAdClicked() {
          // Banner ad recorded a click.
          Log.d(TAG, "Banner ad clicked.");
        }

        @Override
        public void onAdShowedFullScreenContent() {
          // Banner ad showed.
          Log.d(TAG, "Banner ad showed full screen content.");
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // Banner ad dismissed.
          Log.d(TAG, "Banner ad dismissed full screen content.");
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // Banner ad failed to show.
          Log.w(
              TAG,
              "Banner ad failed to show full screen content: " + fullScreenContentError);
        }
      });
}
BannerSnippets.java

বিজ্ঞাপন রিফ্রেশ কলব্যাক

আপনি যদি ব্যানার বিজ্ঞাপনের জন্য স্বয়ংক্রিয় রিফ্রেশ ব্যবহার করেন, তাহলে BannerAdRefreshCallback বিজ্ঞাপন রিফ্রেশ করার ইভেন্টগুলো পরিচালনা করে। আপনার ভিউ হায়ারার্কিতে বিজ্ঞাপন ভিউ যোগ করার আগে কলব্যাকটি সেট করতে ভুলবেন না। বিজ্ঞাপন রিফ্রেশ করার বিষয়ে বিস্তারিত জানতে, “একটি বিজ্ঞাপন রিফ্রেশ করুন” দেখুন।

কোটলিন

BannerAd.load(
  BannerAdRequest.Builder("/21775744923/example/adaptive-banner", adSize).build(),
  object : AdLoadCallback<BannerAd> {
    override fun onAdLoaded(ad: BannerAd) {
      ad.bannerAdRefreshCallback =
        object : BannerAdRefreshCallback {
          // Set the ad refresh callbacks.
          override fun onAdRefreshed() {
            // Called when the ad refreshes.
          }

          override fun onAdFailedToRefresh(loadAdError: LoadAdError) {
            // Called when the ad fails to refresh.
          }
        }

      // ...
    }
  }
)

জাভা

BannerAd.load(
    new BannerAdRequest.Builder("/21775744923/example/adaptive-banner", adSize).build(),
    new AdLoadCallback<BannerAd>() {
      @Override
      public void onAdLoaded(@NonNull BannerAd ad) {
        ad.setBannerAdRefreshCallback(
            // Set the ad refresh callbacks.
            new BannerAdRefreshCallback() {
              @Override
              public void onAdRefreshed() {
                // Called when the ad refreshes.
              }

              @Override
              public void onAdFailedToRefresh(@NonNull LoadAdError adError) {
                // Called when the ad fails to refresh.
              }
            });
        // ...
      }
    });

ভিডিও বিজ্ঞাপনের জন্য হার্ডওয়্যার অ্যাক্সিলারেশন

আপনার ব্যানার বিজ্ঞাপন ভিউতে ভিডিও বিজ্ঞাপন সফলভাবে দেখানোর জন্য হার্ডওয়্যার অ্যাক্সিলারেশন সক্রিয় থাকতে হবে।

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

হার্ডওয়্যার অ্যাক্সিলারেশন সক্ষম করুন

যদি আপনার অ্যাপটি বিশ্বব্যাপী হার্ডওয়্যার অ্যাক্সিলারেশন চালু থাকা অবস্থায় সঠিকভাবে কাজ না করে, তবে আপনি প্রতিটি অ্যাক্টিভিটির জন্যও এটি নিয়ন্ত্রণ করতে পারেন। হার্ডওয়্যার অ্যাক্সিলারেশন চালু বা বন্ধ করতে, আপনি আপনার AndroidManifest.xml ফাইলের <application> এবং <activity> এলিমেন্টগুলোতে android:hardwareAccelerated অ্যাট্রিবিউটটি ব্যবহার করতে পারেন। নিচের উদাহরণটি পুরো অ্যাপের জন্য হার্ডওয়্যার অ্যাক্সিলারেশন চালু করে কিন্তু একটি অ্যাক্টিভিটির জন্য তা বন্ধ রাখে:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

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

GMA Next-Gen SDK এর ব্যবহার প্রদর্শনকারী উদাহরণ অ্যাপটি ডাউনলোড করে চালান।

পূর্বশর্ত

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

একটি AdView অবজেক্ট তৈরি করুন

কোটলিন

জাভা

এক্সএমএল লেআউট

জেটপ্যাক কম্পোজ

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

কোটলিন

জাভা

জেটপ্যাক কম্পোজ

একটি বিজ্ঞাপন রিফ্রেশ করুন

একটি বিজ্ঞাপন রিসোর্স প্রকাশ করুন

কোটলিন

জাভা

জেটপ্যাক কম্পোজ

বিজ্ঞাপন ইভেন্ট

কোটলিন

জাভা

বিজ্ঞাপন রিফ্রেশ কলব্যাক

কোটলিন

জাভা

ভিডিও বিজ্ঞাপনের জন্য হার্ডওয়্যার অ্যাক্সিলারেশন

হার্ডওয়্যার অ্যাক্সিলারেশন সক্ষম করুন

একটি `AdView` অবজেক্ট তৈরি করুন