آگهیهای Squeezeback محتوای برنامه شما را در نمای کوچکتری قرار میدهند و آگهی بومی را در فضای اطراف نمایش میدهند. این قالب به کاربران اجازه میدهد با برنامهتان تعامل داشته باشند درحالیکه آگهی همچنان نمایان است. برای نمایش آگهیهایی که محتوای برنامهتان را نمیپوشانند، این قالب را انتخاب کنید.
این راهنما درخواست و نمایش آگهیهای squeezeback در برنامهتان را بااستفاده از GMA Next-Gen SDK پوشش میدهد.
قبلاز شروع
قبلاز ادامه دادن، کارهای زیر را انجام دهید:
GMA Next-Gen SDK نسخه
1.7.0یا جدیدتر را نصب کنید.آگهیهای آزمایشی را فعال کنید و از شناسه واحد آگهی بومی آزمایشی زیر استفاده کنید:
ca-app-pub-3940256099942544/9983381271
بار کردن آگهی
برای بار کردن شیء
SqueezebackAd
، درخواست آگهی ایجاد کنید و روش load را فراخوانی کنید. مثال زیر
آگهی squeezeback بارشده را ذخیره میکند، برای رویدادهای آگهی ثبتنام میکند، و
خطا را درصورت ناموفق بودن ثبت میکند:
Kotlin
جاوا
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.") } }
جاوا
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.") } }
جاوا
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}") } } }
جاوا
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.") } }
جاوا
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 }
جاوا
private void cleanUpSqueezebackAd() { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.destroy(); squeezebackAd = null; } }