Squeezeback reklamlar, uygulama içeriğinizi daha küçük bir görünüme yerleştirir ve çevredeki alanda bir doğal reklam gösterir. Bu biçim, reklam görünür durumdayken kullanıcıların uygulamanızla etkileşim kurmasına olanak tanır. Uygulama içeriğinizi kapatmayan görüntülü reklamlar göstermek için bu biçimi seçin.
Bu kılavuzda, GMA Next-Gen SDK kullanarak uygulamanızda squeezeback reklamları isteme ve gösterme konusu ele alınmaktadır.
Başlamadan önce
Devam etmeden önce şunları yapın:
GMA Next-Gen SDK
1.7.0veya sonraki bir sürümü yükleyin.Test reklamlarını etkinleştirin ve aşağıdaki test doğal reklam birimi kimliğini kullanın:
/21775744923/example/squeezeback
Reklam yükleme
SqueezebackAd nesnesi yüklemek için bir reklam isteği oluşturun ve load yöntemini çağırın. Aşağıdaki örnekte, yüklenen squeezeback reklamı kaydedilir, reklam etkinlikleri için kaydolunur ve hata durumunda bir hata günlüğe kaydedilir:
Kotlin
Java
AD_UNIT_ID yerine reklam birimi kimliğinizi yazın.
Reklamı göster
squeezeback reklamını ekranda göstermek için show yöntemini çağırın:
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."); } }
Yedek arka plan rengini ayarlama
Varsayılan olarak GMA Next-Gen SDK, küçültülmüş uygulama içeriğinin ve reklamın arkasında koyu gri bir arka plan gösterir. Bu rengi özelleştirmek için reklamı gösterirken reklam seçeneklerinizde bir yedek arka plan rengi belirtin. Aşağıdaki örnekte, yedek arka plan rengi koyu gri olarak ayarlanır ve reklam gösterilir:
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."); } }
Reklam etkinliklerini dinleme
squeezeback reklam yaşam döngüsü etkinliklerini işlemek için reklamınızı göstermeden önce reklam etkinliklerine kaydolun. Bu etkinlikler, tıklama ve gösterim gibi reklam etkileşimlerini raporlar. Bu etkinlikler, reklamın gösterilmesi, gösterilememesi veya gizlenmesi gibi squeezeback ile ilgili etkinlikleri de raporlar.
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()); } }); }
Kullanıcı reklamı kapattıktan sonra GMA Next-Gen SDK, reklam gizlendi etkinliğini çağırır ve reklamı tekrar gösteremezsiniz.
Reklamı gizleme
Reklamı kaldırmak ve uygulama içeriğinizi tam boyuta geri yüklemek için hide yöntemini çağırın. Bu yöntem, reklam gizlendi etkinliğini çağırır. Aşağıdaki örnekte, kaydedilmiş bir squeezeback reklam referansı olup olmadığı kontrol edilir ve varsa reklam gizlenir:
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."); } }
Reklam kaynaklarını temizleme
Bellek sızıntılarını önlemek için uygulamanız reklamı kullanmayı bitirdiğinde reklam nesnesine olan referansınızı bırakın. Aşağıdaki örnekte reklam temizlenmektedir:
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; } }