โฆษณาSqueezebackจะแทรกเนื้อหาแอปของคุณลงในมุมมองที่เล็กลงและแสดงโฆษณาเนทีฟในพื้นที่โดยรอบ รูปแบบนี้ช่วยให้ผู้ใช้โต้ตอบกับแอปได้ขณะที่โฆษณายังคงปรากฏอยู่ หากต้องการแสดงโฆษณา Display ที่ไม่บดบังเนื้อหาแอป ให้เลือกรูปแบบนี้
คู่มือนี้ครอบคลุมการขอและการแสดงโฆษณา squeezeback ในแอปโดยใช้ GMA Next-Gen SDK
ก่อนเริ่มต้น
โปรดทำสิ่งต่อไปนี้ก่อนดำเนินการต่อ
ติดตั้ง 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; } }