Iklan Squeezeback menyisipkan konten aplikasi Anda ke dalam tampilan yang lebih kecil dan menampilkan iklan native di ruang sekitarnya. Format ini memungkinkan pengguna berinteraksi dengan aplikasi Anda saat iklan tetap terlihat. Untuk menampilkan iklan yang tidak menutupi konten aplikasi Anda, pilih format ini.
Panduan ini membahas cara meminta dan menampilkan iklan squeezeback di aplikasi Anda menggunakan GMA Next-Gen SDK.
Sebelum memulai
Sebelum melanjutkan, lakukan hal berikut:
Instal GMA Next-Gen SDK versi
1.7.0atau yang lebih baru.Aktifkan iklan pengujian dan gunakan ID unit iklan native pengujian berikut:
/21775744923/example/squeezeback
Memuat iklan
Untuk memuat objek
SqueezebackAd,
buat permintaan iklan dan panggil metode load. Contoh berikut
menyimpan iklan squeezeback yang dimuat, mendaftar untuk peristiwa iklan, dan mencatat
error ke dalam log jika terjadi kegagalan:
Kotlin
Java
Ganti AD_UNIT_ID dengan ID unit iklan Anda.
Menampilkan iklan
Untuk menampilkan iklan squeezeback di layar, panggil metode 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."); } }
Menetapkan warna latar belakang penggantian
Secara default, GMA Next-Gen SDK menampilkan latar belakang abu-abu gelap di balik konten aplikasi dan iklan yang diperkecil. Untuk menyesuaikan warna ini, tentukan warna latar belakang pengganti di opsi iklan Anda saat menampilkan iklan. Contoh berikut menetapkan warna latar belakang pengganti ke abu-abu gelap dan menampilkan iklan:
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."); } }
Memproses peristiwa iklan
Untuk menangani peristiwa siklus proses iklan squeezeback, daftarkan peristiwa iklan sebelum menampilkan iklan. Peristiwa ini melaporkan interaksi iklan, seperti klik dan tayangan iklan. Peristiwa ini juga melaporkan peristiwa khusus squeezeback, seperti saat iklan ditampilkan, gagal ditampilkan, atau disembunyikan.
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()); } }); }
Setelah pengguna menutup iklan, GMA Next-Gen SDK akan memanggil peristiwa iklan disembunyikan, dan Anda tidak dapat lagi menampilkan iklan tersebut.
Menyembunyikan iklan
Untuk menghapus iklan dan memulihkan konten aplikasi Anda ke ukuran penuh, panggil metode hide. Metode ini memanggil peristiwa iklan disembunyikan. Contoh berikut memeriksa
referensi iklan squeezeback yang disimpan dan menyembunyikan iklan jika tersedia:
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."); } }
Membersihkan resource iklan
Untuk menghindari kebocoran memori, hapus referensi Anda ke objek iklan saat aplikasi Anda selesai menggunakan iklan. Contoh berikut membersihkan iklan:
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; } }