این راهنما بار کردن آگهی برنمای تطبیقی لنگرشده در برنامه 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) }
}
تنظیم اندازه آگهی
برنماهای تطبیقی بزرگ قالب بزرگتری را ارائه میکنند که برای چیدمانهای بدون پیمایش طراحی شده است. در مقایسه با برنماهای تطبیقی ثابت استاندارد، این برنماها اجازه میدهند حداکثر ارتفاع بلندتری داشته باشند، تا ۲۰٪ ارتفاع صفحه، و بین ۵۰ تا ۱۵۰dp. این فضای افزایشیافته برای محتوای ویدیویی بهینهسازی شده است.
AdSize را روی نوع بنر تطبیقی لنگرشده با پهنای مشخص تنظیم کنید:
جاوا
// Request a large anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getLargeAnchoredAdaptiveBannerAdSize(this, 360));
Kotlin
// Request a large anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getLargeAnchoredAdaptiveBannerAdSize(this, 360))
Jetpack Compose
// Set a large anchored adaptive banner ad size with a given width.
val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(LocalContext.current, 360)
adView.setAdSize(adSize)
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);
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)
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) }
}
بار کردن آگهی
مثال زیر آگهی برنمای تطبیقی لنگرشده با عرض ۳۶۰ را در شیء
AdView بار میکند:
جاوا
AdRequest adRequest = new AdRequest.Builder().build();
adView.loadAd(adRequest);
Kotlin
val adRequest = AdRequest.Builder().build()
adView.loadAd(adRequest)
بازآوری آگهی
اگر واحد آگهیتان را برای بازآوری پیکربندی کردهاید، وقتی آگهی بار نمیشود، لازم نیست آگهی دیگری درخواست کنید. 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;
}
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
}
Jetpack Compose
DisposableEffect(Unit) {
// Destroy the AdView to prevent memory leaks when the screen is disposed.
onDispose { adView.destroy() }
}
رویدادهای آگهی
میتوانید تعدادی از رویدادهای چرخه حیات آگهی را، ازجمله بار کردن، ظهور و کلیک آگهی، و همچنین رویدادهای باز و بسته شدن آگهی را، گوش کنید. توصیه میشود پیشاز بار کردن برنما، برگشتپذیر را تنظیم کنید.
جاوا
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.
}
});
}
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.
}
}
هریک از روشهای قابللغو در 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>
برای اطلاعات بیشتر درباره گزینههای کنترل شتاب سختافزاری، راهنمای شتاب سختافزاری را ببینید. توجه داشته باشید که اگر فعالیت غیرفعال باشد، نمیتوان نماهای آگهی تکی را برای شتاب سختافزاری فعال کرد، بنابراین خود فعالیت باید شتاب سختافزاری فعال داشته باشد.
مراحل بعدی
برنماهای جمعشدنی
آگهیهای برنمای جمعشدنی آگهیهای برنمایی هستند که در ابتدا بهعنوان رونهاد بزرگتری ارائه میشوند و دکمهای برای جمع کردن آگهی به اندازه کوچکتر دارند. برای بهینهسازی بیشتر عملکردتان، از آن استفاده کنید. برای جزئیات بیشتر، آگهیهای برنمای جمعشدنی را ببینید.
برنماهای تطبیقی بهخط
برنماهای تطبیقی درونخطی نسبتبه برنماهای تطبیقی لنگردار بزرگتر و بلندتر هستند. ارتفاع آنها متغیر است و میتواند به اندازه ارتفاع صفحهنمایش دستگاه باشد. برنماهای تطبیقی درونخطی برای برنامههایی که آگهیهای برنمایی را در محتوای پیمایششدنی قرار میدهند، نسبتبه آگهیهای برنمایی تطبیقی ثابت توصیه میشود. برای جزئیات بیشتر، برنماهای تطبیقی درخط را ببینید.