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

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

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

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

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