Squeezeback 광고는 앱 콘텐츠를 더 작은 뷰에 삽입하고 주변 공간에 네이티브 광고를 표시합니다. 이 형식을 사용하면 광고가 표시되는 동안 사용자가 앱과 상호작용할 수 있습니다. 앱 콘텐츠를 가리지 않는 광고를 표시하려면 이 형식을 선택하세요.
이 가이드에서는 GMA Next-Gen SDK를 사용하여 앱에서 squeezeback 광고를 요청하고 표시하는 방법을 설명합니다.
시작하기 전에
계속하기 전에 다음을 수행하세요.
GMA Next-Gen SDK 버전
1.7.0이상을 설치합니다.테스트 광고를 사용 설정하고 다음 테스트 네이티브 광고 단위 ID를 사용합니다.
ca-app-pub-3940256099942544/9983381271
광고 로드
SqueezebackAd 객체를 로드하려면 광고 요청을 만들고 load 메서드를 호출합니다. 다음 예에서는 로드된 squeezeback 광고를 저장하고, 광고 이벤트를 등록하고, 실패 시 오류를 로깅합니다.
Kotlin
자바
AD_UNIT_ID를 광고 단위 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 }
Java
private void cleanUpSqueezebackAd() { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.destroy(); squeezebackAd = null; } }