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

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

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

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

הטמעה

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