دمج طلبات الإعلانات المدمجة مع المحتوى وطلبات إعلانات البانر

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

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

  • الإصدار 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, etc.
      }
    })
    .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, etc.
      }
    })
    .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() الخاصة بكائن المستمع المحدّد.

ضبط عنصر 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().