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

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

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

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

تحميل الإعلان

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

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

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

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native-and-banner")
    .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, "/21775744923/example/native-and-banner")
    .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.

ضبط AdViewOptions

الدالة الأخيرة المضمّنة في إنشاء 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().