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

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

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

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

التنفيذ

تأكَّد من تحديد عرض البانر بالحجم الذي تريد أن يراه المستخدمون في حالة البانر العادي (المصغَّر). أدرِج مَعلمة إضافية في طلب عرض الإعلان مع استخدام collapsible كمفتاح وموضع الإعلان كقيمة.

يحدّد موضع الإعلان القابل للتصغير كيفية تثبيت المنطقة الموسّعة في "إعلان البانر".

إذا كان الإعلان الذي تم تحميله هو "إعلان بانر قابل للتصغير"، يعرض البانر التراكب القابل للتصغير فور وضعه في هيكلية طرق العرض:

private fun loadCollapsibleBannerAd(adView: AdView, activity: Activity) {
  val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360)

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the adView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  val adRequest =
    BannerAdRequest.Builder(AD_UNIT_ID, adSize).setGoogleExtrasBundle(extras).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.i(
          TAG,
          "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
        )
      }


      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Banner ad failed to load: $adError")
      }
    },
  )
}
BannerSnippets.kt

private void loadCollapsibleBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  AdSize adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360);

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the adView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  BannerAdRequest adRequest =
      new BannerAdRequest.Builder(AD_UNIT_ID, adSize).setGoogleExtrasBundle(extras).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          Log.i(
              TAG,
              String.format(
                  "The last loaded banner is %scollapsible.", ad.isCollapsible() ? "" : "not "));
        }


        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Banner ad failed to load: " + adError);
        }
      });
}
BannerSnippets.java

استبدِل AD_UNIT_ID بمعرّف وحدتك الإعلانية.

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

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

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

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

تكون "إعلانات البانر غير القابلة للتصغير" مؤهَّلة للظهور استجابةً لطلبات "إعلانات البانر القابلة للتصغير" من أجل تحقيق أفضل أداء. إذا تعذّر تحميل الطلب وكان البانر السابق قابلاً للتصغير، ستعرض واجهة برمجة التطبيقات القيمة true. للتحقّق مما إذا كان آخر إعلان بانر تم تحميله قابلاً للتصغير، يمكنك استدعاء طريقة isCollapsible:

override fun onAdLoaded(ad: BannerAd) {
  Log.i(
    TAG,
    "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
  )
}
BannerSnippets.kt

@Override
public void onAdLoaded(@NonNull BannerAd ad) {
  Log.i(
      TAG,
      String.format(
          "The last loaded banner is %scollapsible.", ad.isCollapsible() ? "" : "not "));
}
BannerSnippets.java

الوساطة

لا تتوفّر "إعلانات البانر القابلة للتصغير" إلّا للطلب الإعلاني على منصات Google. تظهر الإعلانات المعروضة من خلال التوسّط كإعلانات بانر عادية غير قابلة للتصغير.