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

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

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

• קוראים את המדריך למתחילים בנושא מודעות באנר.

הטמעה

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

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

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

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

Java

private void loadBannerAd() {
  adView = new AdView(this);
  adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")

  AdSize adSize = getAdSize();
  adView.setAdSize(adSize);
  // 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");

  AdRequest adRequest = new AdRequest.Builder()
      .addNetworkExtrasBundle(AdMobAdapter.class, extras)
     .build();

  adView.loadAd(adRequest);
}

Kotlin

private fun loadBanner() {adView = AdView(this);
  adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"

  adView.setAdSize(adSize)

  // 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")

  val adRequest = AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

  adView.loadAd(adRequest)
}

התנהגות הרענון של המודעות

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

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

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

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

Java

public void onAdLoaded() {
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}

Kotlin

fun onAdLoaded() {
  Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}

גישור

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