کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل (Google Mobile Ads SDK) در حالت تعمیر و نگهداری است. برای دریافت آخرین به‌روزرسانی‌ها و ویژگی‌ها، کیت توسعه نرم‌افزاری نسل بعدی GMA را منتقل و راه‌اندازی کنید.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

راه‌اندازی آگهی‌های برنمایی

پلاتفرم را انتخاب کنید: Android iOS Unity Flutter Android (Legacy)

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

این راهنما بار کردن آگهی برنمای تطبیقی لنگرشده در برنامه Android را پوشش می‌دهد.

پیش‌نیازها

‫Google Mobile Ads SDK (Legacy) را راه‌اندازی کنید.
اختیاری: برای نمونه پیاده‌سازی آگهی‌های برنمای، یکی از برنامه‌های نمونه زیر را انتخاب کنید:
- نمونه آگهی‌های برنمای تطبیقی لنگرانداخته Java، Kotlin، یا Jetpack Compose.
- نمایش ویژگی‌های پیشرفته Java یا Kotlin.

همیشه با آگهی‌های آزمایشی آزمایش کنید

هنگام ساختن و آزمایش کردن برنامه‌هایتان، مطمئن شوید که از آگهی‌های آزمایشی به‌جای آگهی‌های زنده و تولید استفاده می‌کنید. انجام ندادن این کار می‌تواند منجر به تعلیق حساب شما شود.

آسان‌ترین راه برای بار کردن آگهی‌های آزمایشی استفاده از شناسه واحد آگهی آزمایشی اختصاصی ما برای برنمای‌های Android است:

ca-app-pub-3940256099942544/9214589741

این واحد تبلیغات به‌طور ویژه پیکربندی شده است تا برای هر درخواست، آگهی‌های آزمایشی برگرداند و می‌توانید از آن در برنامه‌های خودتان هنگام کدنویسی، آزمایش، و اشکال‌زدایی استفاده کنید. فقط مطمئن شوید که قبل‌از انتشار برنامه‌تان، آن را با شناسه واحد آگهی خودتان جایگزین کنید.

برای اطلاعات بیشتر درباره نحوه عملکرد آگهی‌های آزمایشی Google Mobile Ads SDK (Legacy)، به فعال کردن آگهی‌های آزمایشی مراجعه کنید.

تعریف نمای آگهی

چیدمان XML

نمایی به فایل XML چیدمانتان اضافه کنید تا به‌عنوان محفظه آگهی بنری تطبیقی لنگرشده عمل کند:

<!-- Ad view container that fills the width of the screen and adjusts its
    height to the content of the ad. -->
<FrameLayout
        android:id="@+id/ad_view_container"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:layout_alignParentBottom="true" />

Jetpack Compose

پوشه برنامه‌های کمکی JetpackCompose را اضافه کنید. این پوشه شامل یاری‌رسان‌هایی برای نوشتن دارایی‌ها و شیء AdView است.
نوشتن AdView:


// Place the ad view at the bottom of the screen.
Column(modifier = modifier.fillMaxSize(), verticalArrangement = Arrangement.Bottom) {
  Box(modifier = modifier.fillMaxWidth()) { BannerAd(adView, modifier) }
}BannerScreen.kt

تنظیم اندازه آگهی

برنماهای تطبیقی بزرگ قالب بزرگ‌تری را ارائه می‌کنند که برای چیدمان‌های بدون پیمایش طراحی شده است. در مقایسه با برنماهای تطبیقی ثابت استاندارد، این برنماها اجازه می‌دهند حداکثر ارتفاع بلندتری داشته باشند، تا ۲۰٪ ارتفاع صفحه، و بین ۵۰ تا ۱۵۰dp. این فضای افزایش‌یافته برای محتوای ویدیویی بهینه‌سازی شده است.

AdSize را روی نوع بنر تطبیقی لنگرشده با پهنای مشخص تنظیم کنید:

جاوا


// Request a large anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getLargeAnchoredAdaptiveBannerAdSize(this, 360));MyActivity.java

Kotlin


// Request a large anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getLargeAnchoredAdaptiveBannerAdSize(this, 360))MainActivity.kt

Jetpack Compose


// Set a large anchored adaptive banner ad size with a given width.
val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(LocalContext.current, 360)
adView.setAdSize(adSize)BannerScreen.kt

‫`AdView` را به چیدمان اضافه کنید

بااستفاده از اندازه آگهی، AdView ایجاد کنید تا به چیدمان برنامه‌تان اضافه شود:

جاوا


// Create a new ad view.
adView = new AdView(this);
adView.setAdUnitId(AD_UNIT_ID);
// Request a large anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getLargeAnchoredAdaptiveBannerAdSize(this, 360));

// Replace ad container with new ad view.
adContainerView.removeAllViews();
adContainerView.addView(adView);MyActivity.java

Kotlin


// Create a new ad view.
val adView = AdView(this)
adView.adUnitId = AD_UNIT_ID
// Request a large anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getLargeAnchoredAdaptiveBannerAdSize(this, 360))
this.adView = adView

// Replace ad container with new ad view.
binding.adViewContainer.removeAllViews()
binding.adViewContainer.addView(adView)MainActivity.kt

Jetpack Compose


val adView = remember { AdView(context) }

// Setup and load the adview.
// Set the unique ID for this specific ad unit.
adView.adUnitId = BANNER_AD_UNIT_ID

// Set a large anchored adaptive banner ad size with a given width.
val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(LocalContext.current, 360)
adView.setAdSize(adSize)

// Place the ad view at the bottom of the screen.
Column(modifier = modifier.fillMaxSize(), verticalArrangement = Arrangement.Bottom) {
  Box(modifier = modifier.fillMaxWidth()) { BannerAd(adView, modifier) }
}BannerScreen.kt

بار کردن آگهی

مثال زیر آگهی برنمای تطبیقی لنگرشده با عرض ۳۶۰ را در شیء AdView بار می‌کند:

جاوا

AdRequest adRequest = new AdRequest.Builder().build();
adView.loadAd(adRequest);MyActivity.java

Kotlin

val adRequest = AdRequest.Builder().build()
adView.loadAd(adRequest)MainActivity.kt

بازآوری آگهی

اگر واحد آگهی‌تان را برای بازآوری پیکربندی کرده‌اید، وقتی آگهی بار نمی‌شود، لازم نیست آگهی دیگری درخواست کنید. Google Mobile Ads SDK (Legacy) به هر نرخ بازآوری که در AdMob UI مشخص کرده‌اید احترام می‌گذارد. اگر بازآوری را فعال نکرده‌اید، درخواست جدیدی صادر کنید. برای جزئیات بیشتر درباره بازآوری واحد آگهی، مانند تنظیم نرخ بازآوری، به استفاده از بازآوری خودکار برای آگهی‌های برنما مراجعه کنید.

انتشار منبع آگهی

وقتی استفاده از آگهی برنمایی تمام شد، می‌توانید منابع آگهی برنمایی را آزاد کنید.

برای آزاد کردن منبع آگهی، آگهی را از سلسله‌مراتب نمای برمی‌دارید و همه ارجاع‌های آن را رها می‌کنید:

جاوا

public void destroyBanner() {
  // Remove banner from view hierarchy.
  if (adView != null) {
    View parentView = (View) adView.getParent();
    if (parentView instanceof ViewGroup) {
      ((ViewGroup) parentView).removeView(adView);
    }

    // Destroy the banner ad resources.
    adView.destroy();
  }

  // Drop reference to the banner ad.
  adView = null;
}
BannerSnippets.java

Kotlin

fun destroyBanner() {
  // Remove banner from view hierarchy.
  val parentView = adView?.parent
  if (parentView is ViewGroup) {
    parentView.removeView(adView)
  }

  // Destroy the banner ad resources.
  adView?.destroy()

  // Drop reference to the banner ad.
  adView = null
}
BannerSnippets.kt

Jetpack Compose

DisposableEffect(Unit) {
  // Destroy the AdView to prevent memory leaks when the screen is disposed.
  onDispose { adView.destroy() }
}BannerScreen.kt

رویدادهای آگهی

می‌توانید تعدادی از رویدادهای چرخه حیات آگهی را، ازجمله بار کردن، ظهور و کلیک آگهی، و همچنین رویدادهای باز و بسته شدن آگهی را، گوش کنید. توصیه می‌شود پیش‌از بار کردن برنما، برگشت‌پذیر را تنظیم کنید.

جاوا

if (adView != null) {
  adView.setAdListener(
      new AdListener() {
        @Override
        public void onAdClicked() {
          // Code to be executed when the user clicks on an ad.
        }

        @Override
        public void onAdClosed() {
          // Code to be executed when the user is about to return
          // to the app after tapping on an ad.
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          // Code to be executed when an ad request fails.
        }

        @Override
        public void onAdImpression() {
          // Code to be executed when an impression is recorded
          // for an ad.
        }

        @Override
        public void onAdLoaded() {
          // Code to be executed when an ad finishes loading.
        }

        @Override
        public void onAdOpened() {
          // Code to be executed when an ad opens an overlay that
          // covers the screen.
        }
      });
}BannerSnippets.java

Kotlin

adView?.adListener =
  object : AdListener() {
    override fun onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    override fun onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // Code to be executed when an ad request fails.
    }

    override fun onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    override fun onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    override fun onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
  }BannerSnippets.kt

هریک از روش‌های قابل‌لغو در AdListener با رویدادی در چرخه عمر آگهی مطابقت دارد.

روش‌های قابل‌لغو
`onAdClicked()`	وقتی کلیکی برای آگهی ضبط می‌شود، روش `onAdClicked()` فراخوانی می‌شود.
`onAdClosed()`	وقتی کاربر پس‌از مشاهده نشانی وب مقصد آگهی به برنامه برمی‌گردد، روش `onAdClosed()` فراخوانی می‌شود. برنامه شما می‌تواند از آن برای ازسر گرفتن فعالیت‌های تعلیق‌شده یا انجام هر کار دیگری که برای آماده شدن برای تعامل لازم است استفاده کند. برای پیاده‌سازی روش‌های شنونده آگهی در برنامه Android API Demo، به AdMob مثال AdListener مراجعه کنید.
`onAdFailedToLoad()`	روش `onAdFailedToLoad()` تنها روشی است که پارامتر دارد. پارامتر خطای نوع `LoadAdError` شرح می‌دهد که چه خطایی رخ داده است. برای اطلاعات بیشتر، به سند اشکال‌زدایی خطاهای بار کردن آگهی مراجعه کنید.
`onAdImpression()`	روش `onAdImpression()` وقتی ظهور برای آگهی ضبط می‌شود فراخوانی می‌شود.
`onAdLoaded()`	وقتی بار کردن آگهی تمام می‌شود، روش `onAdLoaded()` اجرا می‌شود. اگر می‌خواهید افزودن `AdView` به فعالیت یا قطعه‌تان را تا زمانی‌که مطمئن شوید آگهی بار خواهد شد به‌تأخیر بیندازید، برای مثال، می‌توانید این کار را در اینجا انجام دهید.
`onAdOpened()`	وقتی آگهی هم‌پوشانی‌ای را باز می‌کند که صفحه‌نمایش را می‌پوشاند، روش `onAdOpened()` فراخوانده می‌شود.

شتاب سخت‌افزاری برای آگهی‌های ویدیویی

برای اینکه آگهی‌های ویدیویی با موفقیت در نماهای آگهی برنمای شما نشان داده شوند، شتاب‌دهی سخت‌افزاری باید فعال باشد.

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

فعال کردن شتاب سخت‌افزاری

اگر برنامه شما با فعال بودن شتاب سخت‌افزاری در سطح جهانی به‌درستی عمل نمی‌کند، می‌توانید آن را برای فعالیت‌های جداگانه نیز کنترل کنید. برای فعال یا غیرفعال کردن شتاب سخت‌افزاری، می‌توانید از مشخصه android:hardwareAccelerated برای عناصر <application> و <activity> در AndroidManifest.xml استفاده کنید. مثال زیر شتاب سخت‌افزاری را برای کل برنامه فعال می‌کند اما آن را برای یک فعالیت غیرفعال می‌کند:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

برای اطلاعات بیشتر درباره گزینه‌های کنترل شتاب سخت‌افزاری، راهنمای شتاب سخت‌افزاری را ببینید. توجه داشته باشید که اگر فعالیت غیرفعال باشد، نمی‌توان نماهای آگهی تکی را برای شتاب سخت‌افزاری فعال کرد، بنابراین خود فعالیت باید شتاب سخت‌افزاری فعال داشته باشد.

مراحل بعدی

برنماهای جمع‌شدنی

آگهی‌های برنمای جمع‌شدنی آگهی‌های برنمایی هستند که در ابتدا به‌عنوان رونهاد بزرگ‌تری ارائه می‌شوند و دکمه‌ای برای جمع کردن آگهی به اندازه کوچک‌تر دارند. برای بهینه‌سازی بیشتر عملکردتان، از آن استفاده کنید. برای جزئیات بیشتر، آگهی‌های برنمای جمع‌شدنی را ببینید.

برنماهای تطبیقی به‌خط

برنماهای تطبیقی درون‌خطی نسبت‌به برنماهای تطبیقی لنگردار بزرگ‌تر و بلندتر هستند. ارتفاع آن‌ها متغیر است و می‌تواند به اندازه ارتفاع صفحه‌نمایش دستگاه باشد. برنماهای تطبیقی درون‌خطی برای برنامه‌هایی که آگهی‌های برنمایی را در محتوای پیمایش‌شدنی قرار می‌دهند، نسبت‌به آگهی‌های برنمایی تطبیقی ثابت توصیه می‌شود. برای جزئیات بیشتر، برنماهای تطبیقی درخط را ببینید.

راه‌اندازی آگهی‌های برنمایی با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

پیش‌نیازها

همیشه با آگهی‌های آزمایشی آزمایش کنید

تعریف نمای آگهی

چیدمان XML

Jetpack Compose

تنظیم اندازه آگهی

جاوا

Kotlin

Jetpack Compose

‫AdView را به چیدمان اضافه کنید

جاوا

Kotlin

Jetpack Compose

بار کردن آگهی

جاوا

Kotlin

بازآوری آگهی

انتشار منبع آگهی

جاوا

Kotlin

Jetpack Compose

رویدادهای آگهی

جاوا

Kotlin

شتاب سخت‌افزاری برای آگهی‌های ویدیویی

فعال کردن شتاب سخت‌افزاری

مراحل بعدی

برنماهای جمع‌شدنی

برنماهای تطبیقی به‌خط

کاوش کردن موضوعات دیگر

راه‌اندازی آگهی‌های برنمایی

‫`AdView` را به چیدمان اضافه کنید