מודעות באנר ניתנות לכיווץ

הפלטפורמה: Android iOS Unity Flutter

מודעות באנר שאפשר לכווץ הן מודעות באנר שמוצגות בהתחלה כשכבת-על גדולה יותר, עם כפתור שאפשר ללחוץ עליו כדי לכווץ אותן לגודל המקורי שהוגדר בבקשה להצגת המודעה. מודעות מהסוג הזה נועדו לשפר את הביצועים של מודעות עוגן שקטנות יותר כשהן במצב הלא מורחב. במדריך הזה מוסבר איך לאפשר את ההצגה של מודעות כאלה במיקומים קיימים של מודעות באנר.

דרישות מוקדמות

הטמעה

הקפידו להגדיר את גודל התצוגה של מודעת הבאנר לגודל שבו אתם רוצים שהמשתמשים יראו אותה במצב הרגיל (הממוזער). הבקשה להצגת מודעה צריכה לכלול את הפרמטר extras עם collapsible בתור המפתח ועם מיקום המודעה בתור הערך.

המיקום של מודעת הבאנר שאפשר לכווץ מגדיר איך האזור המורחב ממוקם יחסית למודעת הבאנר.

ערך של Placement התנהגות תרחיש שימוש מיועד
top החלק העליון של המודעה במצב מלא מיושר עם החלק העליון של המודעה הממוזערת. המודעה מוצבת בחלק העליון של המסך.
bottom החלק התחתון של המודעה במצב מלא מיושר עם החלק התחתון של המודעה הממוזערת. המודעה מוצבת בתחתית המסך.

אם המודעה שנטענת היא מודעת באנר שאפשר לכווץ, שכבת העל הניתנת לכיווץ תוצג בבאנר מיד אחרי שהיא תוצב בהיררכיית התצוגה.

Java

private void loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  // Create an ad request.
  AdRequest adRequest =
      new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest);
}

CollapsibleBannerFragment.java

Kotlin

private fun loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  // Create an ad request.
  val adRequest =
    AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest)
}

CollapsibleBannerFragment.kt

מה קורה כשמתבצע רענון של המודעה

נסביר מה קורה באפליקציות שמוגדר בהן רענון אוטומטי של מודעות באנר בממשק האינטרנט של Ad Manager, אחרי שנשלחת בקשה להצגת מודעת באנר שאפשר לכווץ במיקום של מודעת באנר: בכל פעם שיתבצע רענון של המודעה, לא תישלח בקשה למודעה שאפשר לכווץ. הסיבה היא שאם בכל פעם שמרעננים את המודעה מציגים מודעת באנר שאפשר לכווץ, זה עלול לפגוע בחוויית המשתמש.

אם רוצים לטעון עוד מודעת באנר שאפשר לכווץ בשלב מאוחר יותר בסשן, אפשר לטעון מודעה באופן ידני עם בקשה שכוללת את הפרמטר collapsible.

איך בודקים אם מודעה שנטענה ניתנת לכיווץ

כדי למקסם את הביצועים, מודעות באנר שאי אפשר לכווץ יכולות להופיע בתגובה לבקשות להצגת מודעות באנר שאפשר לכווץ. כדי לבדוק אם מודעת הבאנר האחרונה שנטענה ניתנת לכיווץ, אפשר לקרוא לפונקציה isCollapsible. אם הבקשה לא נטענת ומודעת הבאנר הקודמת ניתנת לכיווץ, ה-API מחזיר true.

Java

public void onAdLoaded() {
  Log.i(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}
CollapsibleBannerFragment.java

Kotlin

override fun onAdLoaded() {
  Log.i(
    MainActivity.LOG_TAG,
    "Ad loaded. adView.isCollapsible() is ${adView.isCollapsible}.",
  )
}
CollapsibleBannerFragment.kt

גישור

ניתן להציג מודעות באנר שאפשר לכווץ רק בתגובה לביקוש ב-Google. מודעות שמוצגות באמצעות תהליך בחירת הרשת מופיעות בתור מודעות באנר שאי אפשר לכווץ.