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

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

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

הטמעה

חשוב לוודא שהתצוגה של מודעת הבאנר מוגדרת בגודל שתרצו שהמשתמשים יראו במצב הבאנר הרגיל (המכווץ). כוללים פרמטר 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)
}

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

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

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

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

כדי למקסם את הביצועים, מודעות באנר שלא ניתן לכווץ יכולות להופיע בתגובה לבקשות להצגת מודעות באנר שאפשר לכווץ. אפשר להפעיל את הפונקציה 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 במהלך תקופת הבטא. מודעות שמוצגות דרך גישור מוצגות כמודעות באנר רגילות שלא ניתנות לכיווץ.