الجمع بين طلبات الإعلانات المدمجة مع المحتوى المعروضة المخصّصة وإعلانات البانر

من خلال إجراء بعض التغييرات على الرمز، يمكنك دمج الإعلانات المدمجة مع المحتوى وإعلانات البانر في طلبات الإعلانات.

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

• الإصدار 11.0.0 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
• أكمِل البدء.

جارٍ تحميل الإعلان

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

يمكن أيضًا ضبط العنصر AdLoader لإرسال طلبات إعلان يمكن أن تؤدي إلى إعلان بانر أو إعلان مدمج مع المحتوى. إنّ إضافة OnAdManagerAdViewLoadedListener إلى AdLoader أثناء إنشائها تحدّد أنّ إعلانات البانر يجب أن تتنافس مع الإعلانات المدمجة مع المحتوى لملء الطلب.

يوضّح الرمز التالي كيفية إنشاء AdLoader التي يمكنها تحميل إعلان مدمج مع المحتوى أو إعلان بانر في طلب واحد:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/nativeandbanner")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
      @Override
      public void onNativeAdLoaded(NativeAd nativeAd) {
        // Show the ad.
      }
    })
    .forAdManagerAdView(new OnAdManagerAdViewLoadedListener() {
      @Override
      public void onAdManagerAdViewLoaded(AdManagerAdView adView) {
        // Show the banner ad.
      }
    }, AdSize.BANNER, AdSize.MEDIUM_RECTANGLE)
    .withAdListener(new AdListener() {
      @Override
      public void onAdFailedToLoad(LoadAdError error) {
        // Handle the failure by logging, altering the UI, and so on.
      }
    })
    .withAdManagerAdViewOptions(new AdManagerAdViewOptions.Builder()
      // Methods in the AdManagerAdViewOptions.Builder class can be
      // used here to specify individual options settings.
      .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/6499/example/nativeandbanner")
    .forNativeAd { nativeAd ->
      // Show the ad.
    }
    .forAdManagerAdView({ adView ->
      // Show the banner ad.
    }, AdSize.BANNER, AdSize.MEDIUM_RECTANGLE)
    .withAdListener(object: AdListener() {
      override fun onAdFailedToLoad(adError: LoadAdError) {
        // Handle the failure by logging, altering the UI, and so on.
      }
    })
    .withAdManagerAdViewOptions(AdManagerAdViewOptions.Builder()
      // Methods in the AdManagerAdViewOptions.Builder class can be
      // used here to specify individual options settings.
      .build())
    .build()

تعمل طريقة forAdManagerAdView() أعلاه على إعداد AdLoader لتلقّي إعلانات البانر. يجب تحديد قائمة متغيرة الطول بأحجام الإعلانات الصالحة مع OnAdManagerAdViewLoadedListener عند استدعاء forAdManagerAdView().

لتقديم طلب إعلان صالح، يجب تحديد حجم إعلان صالح واحد على الأقل. عند تحميل إعلان بانر بنجاح، يتم استدعاء طريقة onAdManagerAdViewLoaded() لكائن المستمع المحدّد.

نقطة رئيسية: لا يمكن تحميل إعلانات البانر من خلال عناصر AdLoader إلا عند طلبها مع الإعلانات المدمجة مع المحتوى. لتقديم طلب إعلان لإعلانات البانر فقط، اتّبِع الخطوات الموضّحة في إعلانات البانر. بالإضافة إلى ذلك، لا تتم إعادة تحميل إعلانات البانر التي يتم تحميلها من خلال عناصر AdLoader.

إعداد خيارات عرض الإعلان

آخر دالة مضمّنة في إنشاء AdLoader أعلاه هي طريقة اختيارية أخرى، وهي withAdManagerAdViewOptions():

Java

.withAdManagerAdViewOptions(new AdManagerAdViewOptions.Builder()
    // Methods in the AdManagerAdViewOptions.Builder class can be
    // used here to specify individual banner options settings.
    .build()

Kotlin

.withAdManagerAdViewOptions(AdManagerAdViewOptions.Builder()
    // Methods in the AdManagerAdViewOptions.Builder class can be
    // used here to specify individual banner options settings.
    .build()

يتيح الكائن AdManagerAdViewOptions للناشرين تحديد خيارات محدّدة لإعلانات البانر التي يتم تحميلها من خلال AdLoader، مثل:

setManualImpressionsEnabled()

تفعيل إعداد تقارير مرات الظهور اليدوية للحجوزات على "مدير إعلانات Google". يمكن للتطبيقات التي تستخدم مرات الظهور اليدوية أن تحدد بنفسها الوقت المناسب لتسجيل مرة الظهور، ويمكن إجراء ذلك عن طريق الاتصال على AdManagerAdView.recordManualImpression().