تبلیغات بومی و درخواست های تبلیغات بنری را ترکیب کنید

با کمی تغییر در کد خود، می‌توانید تبلیغات بومی و بنری را در درخواست‌های تبلیغاتی خود ترکیب کنید.

پیش‌نیازها

  • نسخه ۱۱.۰.۰ یا بالاتر از SDK تبلیغات موبایلی گوگل.

بارگذاری یک تبلیغ

تبلیغات بومی رندر شده سفارشی با استفاده از کلاس AdLoader بارگذاری می‌شوند، که کلاس AdLoader.Builder مخصوص به خود را برای سفارشی‌سازی در طول ساخت دارد. با اضافه کردن شنونده‌ها به AdLoader در حین ساخت آن، یک برنامه مشخص می‌کند که چه نوع فرمت‌های تبلیغاتی را آماده دریافت دارد. سپس AdLoader فقط آن نوع‌ها را درخواست می‌کند.

شیء AdLoader همچنین می‌تواند طوری پیکربندی شود که درخواست‌های تبلیغاتی را ارسال کند که می‌تواند منجر به یک بنر تبلیغاتی یا یک تبلیغ بومی شود. اضافه کردن یک OnAdManagerAdViewLoadedListener به AdLoader هنگام ساخت آن، مشخص می‌کند که تبلیغات بنری باید برای پر کردن درخواست با تبلیغات بومی رقابت کنند.

کد زیر نحوه ساخت یک AdLoader را نشان می‌دهد که می‌تواند یک تبلیغ بومی یا بنری را در یک درخواست واحد بارگذاری کند:

جاوا 

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();

کاتلین 

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 برای دریافت تبلیغات بنری آماده می‌کند. هنگام فراخوانی forAdManagerAdView() باید لیستی با طول متغیر از اندازه‌های معتبر تبلیغات در کنار OnAdManagerAdViewLoadedListener مشخص شود.

برای ارسال یک درخواست تبلیغ معتبر، حداقل باید یک اندازه تبلیغ معتبر مشخص شود. هنگامی که یک بنر تبلیغاتی با موفقیت بارگذاری شد، متد onAdManagerAdViewLoaded() از شیء شنونده مشخص شده فراخوانی می‌شود.

شیء AdViewOptions را تنظیم کنید

آخرین تابعی که در ایجاد AdLoader گنجانده شده است، یک متد اختیاری دیگر به نام withAdManagerAdViewOptions() است:

جاوا 

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

کاتلین 

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

شیء AdManagerAdViewOptions به ناشران اجازه می‌دهد گزینه‌های خاصی را برای بنرهای بارگذاری شده توسط AdLoader تنظیم کنند، مانند:

setManualImpressionsEnabled()
گزارش‌دهی دستی نمایش تبلیغات را برای رزروهای Google Ad Manager فعال می‌کند. برنامه‌هایی که از نمایش‌های دستی استفاده می‌کنند می‌توانند خودشان تعیین کنند که چه زمانی یک نمایش باید ثبت شود و می‌توانند این کار را با فراخوانی AdManagerAdView.recordManualImpression() انجام دهند.