מודעות Squeezeback מכווצות את תוכן האפליקציה לתצוגה קטנה יותר ומציגות מודעה מותאמת בשטח שמסביב. הפורמט הזה מאפשר למשתמשים לבצע פעולות באפליקציה בזמן שהמודעה מוצגת. כדי להציג מודעות לרשת המדיה שלא מכסות את תוכן האפליקציה, צריך לבחור בפורמט הזה.
במדריך הזה מוסבר איך לבקש ולהציג מודעות squeezeback באפליקציה באמצעות GMA Next-Gen SDK.
לפני שמתחילים
לפני שממשיכים, צריך לבצע את הפעולות הבאות:
מתקינים את GMA Next-Gen SDK בגרסה
1.7.0ואילך.מפעילים מודעות לבדיקה ומשתמשים במזהה הבא של יחידת המודעות המותאמות לבדיקה:
/21775744923/example/squeezeback
טעינת מודעה
כדי לטעון אובייקט SqueezebackAd, יוצרים בקשה להצגת מודעה ומפעילים את ה-method 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 מפעיל את האירוע של הסתרת המודעה, ואי אפשר להציג אותה שוב.
הסתרת המודעה
כדי להסיר את המודעה ולהחזיר את תוכן האפליקציה לגודל מלא, צריך להפעיל את ה-method 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; } }