استخدام إعلانات البانر القابلة للتصغير

اختيار النظام الأساسي: Android Android iOS Unity Flutter

"إعلانات البانر القابلة للتصغير" هي إعلانات بانر تظهر في البداية كتراكب أكبر، مع زرّ لتصغيرها إلى حجم البانر المطلوب في الأصل. تهدف "إعلانات البانر القابلة للتصغير" إلى تحسين أداء الإعلانات الثابتة التي تكون عادةً بحجم أصغر. يوضّح هذا الدليل كيفية تفعيل "إعلانات البانر القابلة للتصغير" لمواضع إعلانات البانر الحالية.

المتطلبات الأساسية

• أكمِل دليل البدء في استخدام إعلانات البانر.

التنفيذ

تأكَّد من تحديد عرض البانر بالحجم الذي تريد أن يظهر للمستخدمين في حالة البانر العادي (المصغَّر). أدرِج مَعلمة إضافات في طلب الإعلان مع 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 = Request()

   // 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];
}

**ملاحظة مهمة:** لا تتوفّر ميزة "إعلان البانر القابل للتصغير" لإعلانات البانر التكيّفية الثابتة الكبيرة. إذا كان تطبيقك يتطلّب وظيفة قابلة للتصغير، استخدِم إعلانات البانر التكيّفية الثابتة العادية.

سلوك إعادة تحميل الإعلانات

بالنسبة إلى التطبيقات التي تُعدّ إعادة التحميل التلقائي لإعلانات البانر في واجهة ويب AdMob، عند طلب "إعلان بانر قابل للتصغير" لخانة بانر، لن تطلب عمليات إعادة تحميل الإعلانات اللاحقة "إعلانات البانر القابلة للتصغير". ويرجع ذلك إلى أنّ عرض "إعلان بانر قابل للتصغير" في كل عملية إعادة تحميل قد يؤثّر سلبًا في تجربة المستخدم.

إذا أردت تحميل "إعلان بانر قابل للتصغير" آخر لاحقًا في الجلسة، يمكنك تحميل إعلان يدويًا من خلال طلب يحتوي على المَعلمة القابلة للتصغير.

التحقّق ممّا إذا كان الإعلان الذي تم تحميله قابلاً للتصغير

تكون إعلانات البانر غير القابلة للتصغير مؤهّلة للعرض لطلبات "إعلانات البانر القابلة للتصغير" لزيادة الأداء إلى أقصى حد. استخدِم الدالة isCollapsible للتحقّق ممّا إذا كان آخر بانر تم تحميله قابلاً للتصغير. إذا تعذّر تحميل الطلب وكان البانر السابق قابلاً للتصغير، تعرض واجهة برمجة التطبيقات القيمة 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. تظهر الإعلانات التي يتم عرضها من خلال الوساطة كإعلانات بانر عادية غير قابلة للتصغير.