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

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

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

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

הטמעה

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

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

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

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);
}

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)
}

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

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

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

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

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

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

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

גישור

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