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

בחירת פלטפורמה: Android iOS Unity Flutter

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

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

הטמעה

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

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

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

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

Swift

func loadBannerAd() {
   bannerView.adUnitID = "ca-app-pub-3940256099942544/8388050270"
   bannerView.rootViewController = self
   let viewWidth = FRAME_WIDTH
   bannerView.adSize = currentOrientationAnchoredAdaptiveBanner(width: viewWidth)

   let request = AdManagerRequest

   // Create an extra parameter that aligns the bottom of the expanded ad to
   // the bottom of the bannerView.
   let extras = Extras()
   extras.additionalParameters = ["collapsible" : "bottom"]
   request.register(extras)

   bannerView.load(request)
 }

Objective-C

- (void)loadBannerAd {
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/8388050270";
  CGFloat viewWidth = FRAME_WIDTH;
  self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);

  GADRequest *request = [GADRequest request];

  // Create an extra parameter that aligns the bottom of the expanded ad to the
  // bottom of the bannerView.
  GADExtras *extras = [[GADExtras alloc] init];
  extras.additionalParameters = @{@"collapsible" : @"bottom"};
  [request registerAdNetworkExtras:extras];

  [self.bannerView loadRequest:request];
}

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

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

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

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

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

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  print("The last loaded banner is \(bannerView.isCollapsible ? "" : "not") collapsible.")
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  NSLog(@"The last loaded banner is %@collapsible.", (bannerView.isCollapsible ? @"" : @"not "));
}

גישור

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