Squeezeback বিজ্ঞাপন আপনার অ্যাপের কন্টেন্টকে ছোট করে দেখায় এবং আশেপাশের ফাঁকা জায়গায় নেটিভ বিজ্ঞাপন দেখায়। এই ফর্ম্যাট ব্যবহারকারীদের বিজ্ঞাপন দেখার সময় আপনার অ্যাপের সাথে ইন্টার্যাক্ট করতে দেয়। আপনার অ্যাপের কন্টেন্ট ঢেকে দেয় না এমন বিজ্ঞাপন দেখাতে, এই ফর্ম্যাট বেছে নিন।
এই নির্দেশিকায় GMA Next-Gen SDK ব্যবহার করে আপনার অ্যাপে squeezeback বিজ্ঞাপন দেখানোর অনুরোধ করা ও দেখানোর ব্যাপারে বলা হয়েছে।
শুরু করার আগে
চালিয়ে যাওয়ার আগে, নিম্নলিখিত কাজগুলি করুন:
GMA Next-Gen SDK-এর
1.7.0বা তার পরের ভার্সন ইনস্টল করুন।টেস্ট বিজ্ঞাপন চালু করুন এবং নিম্নলিখিত টেস্ট নেটিভ বিজ্ঞাপন ইউনিট আইডি ব্যবহার করুন:
/21775744923/example/squeezeback
বিজ্ঞাপন লোড করা
SqueezebackAd
অবজেক্ট লোড করতে, বিজ্ঞাপনের অনুরোধ তৈরি করুন এবং load মেথড কল করুন। নিচের উদাহরণটি
লোড করা squeezeback বিজ্ঞাপন সেভ করে, বিজ্ঞাপন ইভেন্টের জন্য রেজিস্টার করে এবং ব্যর্থ হলে
একটি ত্রুটি লগ করে:
Kotlin
Java
AD_UNIT_ID-এর জায়গায় আপনার বিজ্ঞাপন ইউনিট আইডি লিখুন।
বিজ্ঞাপনটি দেখান
স্ক্রিনে squeezeback বিজ্ঞাপন দেখাতে, show মেথড কল করুন:
Kotlin
private fun showSqueezebackAd(activity: Activity) { // Capture the ad reference saved from the onAdLoaded callback. val ad = squeezebackAd if (ad != null) { ad.show(activity) } else { Log.d(TAG, "No ad to show.") } }
Java
private void showSqueezebackAd(@NonNull Activity activity) { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.show(activity); } else { Log.d(TAG, "No ad to show."); } }
ফলব্যাক ব্যাকগ্রাউন্ডের রঙ সেট করুন
ডিফল্ট হিসেবে, GMA Next-Gen SDK অ্যাপের কন্টেন্ট ও বিজ্ঞাপনের সাইজ কমিয়ে তার পিছনে গাঢ় ধূসর রঙের ব্যাকগ্রাউন্ড দেখায়। এই রঙ কাস্টমাইজ করতে, বিজ্ঞাপন দেখানোর সময় আপনার বিজ্ঞাপনের বিকল্পে একটি ফলব্যাক ব্যাকগ্রাউন্ড রঙ উল্লেখ করুন। নিম্নলিখিত উদাহরণে ফলব্যাক ব্যাকগ্রাউন্ডের রঙ গাঢ় ধূসর হিসেবে সেট করা হয়েছে এবং বিজ্ঞাপন দেখানো হয়েছে:
Kotlin
private fun showSqueezebackAdWithFallbackBackgroundColor(activity: Activity) { // Capture the ad reference saved from the onAdLoaded callback. val ad = squeezebackAd if (ad != null) { val options = SqueezebackAdOptions.Builder() // Sets the fallback background color for the space behind the shrunken content and ad. .setFallbackBackgroundColor(Color.DKGRAY) .build() ad.show(activity, options) } else { Log.d(TAG, "No ad to show.") } }
Java
private void showSqueezebackAdWithFallbackBackgroundColor(@NonNull Activity activity) { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { SqueezebackAdOptions options = new SqueezebackAdOptions.Builder() // Sets the fallback background color for the space behind the shrunken content and // ad. .setFallbackBackgroundColor(Color.DKGRAY) .build(); squeezebackAd.show(activity, options); } else { Log.d(TAG, "No ad to show."); } }
বিজ্ঞাপন ইভেন্ট শুনুন
squeezeback বিজ্ঞাপন লাইফসাইকেল ইভেন্ট ম্যানেজ করতে, আপনার বিজ্ঞাপন দেখানোর আগে বিজ্ঞাপন ইভেন্টের জন্য রেজিস্টার করুন। এইসব ইভেন্ট বিজ্ঞাপন সংক্রান্ত ইন্টার্যাকশন রিপোর্ট করে, যেমন ক্লিক ও ইম্প্রেশন। এইসব ইভেন্ট squeezeback-নির্দিষ্ট ইভেন্টও রিপোর্ট করে, যেমন কখন বিজ্ঞাপন দেখানো হয়, দেখানো যায় না বা লুকানো হয়।
Kotlin
private fun setAdEventCallback(squeezebackAd: SqueezebackAd) { squeezebackAd.adEventCallback = object : SqueezebackAdEventCallback { override fun onAdShown() { Log.d(TAG, "Squeezeback ad shown.") } override fun onAdHidden() { // Called when hide() is invoked or the user taps the close button. // The ad cannot be shown again after it is hidden. Log.d(TAG, "Squeezeback ad hidden.") } override fun onAdFailedToShow(error: FullScreenContentError) { Log.w(TAG, "Squeezeback ad failed to show: $error") } override fun onAdImpression() { Log.d(TAG, "Squeezeback ad recorded an impression.") } override fun onAdClicked() { Log.d(TAG, "Squeezeback ad recorded a click.") } override fun onAdShowedFullScreenContent() { Log.d(TAG, "Squeezeback ad showed full screen content.") } override fun onAdDismissedFullScreenContent() { Log.d(TAG, "Squeezeback ad dismissed full screen content.") } override fun onAdFailedToShowFullScreenContent( fullScreenContentError: FullScreenContentError ) { Log.w(TAG, "Squeezeback ad failed to show full screen content: $fullScreenContentError") } override fun onAdPaid(value: AdValue) { Log.d(TAG, "Squeezeback ad paid: ${value.valueMicros} ${value.currencyCode}") } } }
Java
private void setAdEventCallback(@NonNull SqueezebackAd squeezebackAd) { squeezebackAd.setAdEventCallback( new SqueezebackAdEventCallback() { @Override public void onAdShown() { Log.d(TAG, "Squeezeback ad shown."); } @Override public void onAdHidden() { // Called when hide() is invoked or the user taps the close button. // The ad cannot be shown again after it is hidden. Log.d(TAG, "Squeezeback ad hidden."); } @Override public void onAdFailedToShow(@NonNull FullScreenContentError error) { Log.w(TAG, "Squeezeback ad failed to show: " + error); } @Override public void onAdImpression() { Log.d(TAG, "Squeezeback ad recorded an impression."); } @Override public void onAdClicked() { Log.d(TAG, "Squeezeback ad recorded a click."); } @Override public void onAdShowedFullScreenContent() { Log.d(TAG, "Squeezeback ad showed full screen content."); } @Override public void onAdDismissedFullScreenContent() { Log.d(TAG, "Squeezeback ad dismissed full screen content."); } @Override public void onAdFailedToShowFullScreenContent( @NonNull FullScreenContentError fullScreenContentError) { Log.w( TAG, "Squeezeback ad failed to show full screen content: " + fullScreenContentError); } @Override public void onAdPaid(@NonNull AdValue value) { Log.d( TAG, "Squeezeback ad paid: " + value.getValueMicros() + " " + value.getCurrencyCode()); } }); }
ব্যবহারকারী বিজ্ঞাপনটি বাতিল করার পরে, GMA Next-Gen SDK বিজ্ঞাপন লুকানোর ইভেন্টটি চালু করে এবং আপনি আর বিজ্ঞাপনটি দেখাতে পারবেন না।
বিজ্ঞাপন লুকান
বিজ্ঞাপন সরিয়ে দিতে এবং আপনার অ্যাপ কন্টেন্ট সম্পূর্ণ সাইজে ফিরিয়ে আনতে, hide
মেথড কল করুন। এই পদ্ধতি বিজ্ঞাপন লুকানোর ইভেন্টকে কল করে। নিম্নলিখিত উদাহরণটি সেভ করা squeezeback বিজ্ঞাপন রেফারেন্সের জন্য চেক করে
এবং উপলভ্য থাকলে বিজ্ঞাপনটি লুকায়:
Kotlin
private fun hideSqueezebackAd() { // Capture the ad reference saved from the onAdLoaded callback. val ad = squeezebackAd if (ad != null) { ad.hide() } else { Log.d(TAG, "No ad to hide.") } }
Java
private void hideSqueezebackAd() { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.hide(); } else { Log.d(TAG, "No ad to hide."); } }
বিজ্ঞাপন রিসোর্স ক্লিন-আপ করুন
মেমরি লিক এড়াতে, আপনার অ্যাপ বিজ্ঞাপন ব্যবহার করা শেষ করলে বিজ্ঞাপন অবজেক্টের রেফারেন্স ড্রপ করুন। নিম্নলিখিত উদাহরণটি বিজ্ঞাপনটি পরিষ্কার করে:
Kotlin
private fun cleanUpSqueezebackAd() { squeezebackAd?.destroy() squeezebackAd = null }
Java
private void cleanUpSqueezebackAd() { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.destroy(); squeezebackAd = null; } }