این راهنما بار کردن آگهی برنمای تطبیقی لنگرانداخته را در برنامه 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) }
}
اندازه آگهی را تنظیم کنید
برنماهای تطبیقی بزرگ قالب بزرگتری را ارائه میکنند که برای چیدمانهای بدون پیمایش طراحی شده است. درمقایسه با برنمای تطبیقی لنگردار استاندارد، این برنماها حداکثر ارتفاع بلندتری را امکانپذیر میکنند، تا ۲۰٪ ارتفاع صفحهنمایش، و بین ۵۰ تا ۱۵۰ پیکسل مستقل از تراکم. این فضای افزایشیافته برای محتوای ویدیویی بهینهسازی شده است.
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)
اندازه آگهی را کوچکتر یا مساوی اندازه صفحهنمایش دستگاه تنظیم کنید.
برای تعیین حداکثر اندازه صفحهنمایش، از
Resources.getDisplayMetrics
روش استفاده کنید. ابعاد شیء AdSize از پیکسلهای مستقل از تراکم (dp) استفاده میکند. هنگام مقایسه، اندازه صفحه را از پیکسل به dp تبدیل کنید.
برای جزئیات درباره محدودیتهای اندازه،
الزامات اندازه درخواست آگهی را ببینید.
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 مشخص کردهاید پیروی میکند. اگر بازآوری را فعال نکردهاید، درخواست جدیدی صادر کنید. برای جزئیات بیشتر درباره بازآوری واحد آگهی، مانند تنظیم نرخ بازآوری، به استفاده از بازآوری خودکار برای آگهیهای برنما مراجعه کنید.
انتشار منبع آگهی
وقتی استفاده از آگهی برنمایی تمام شد، میتوانید منابع آگهی برنمایی را آزاد کنید.
برای آزاد کردن منبع آگهی، آگهی را از سلسلهمراتب نما بردارید و همه ارجاعهای آن را رها کنید:
جاوا
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، به نمونه 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>
برای کسب اطلاعات بیشتر درباره گزینههای کنترل شتاب سختافزاری، به راهنمای شتاب سختافزاری مراجعه کنید. توجه داشته باشید که اگر فعالیت غیرفعال باشد، نمیتوان نماهای آگهی تکی را برای شتاب سختافزاری فعال کرد، بنابراین خود فعالیت باید شتاب سختافزاری فعال داشته باشد.
مراحل بعدی
برنماهای جمعشدنی
آگهیهای برنمای جمعشدنی آگهیهای برنمایی هستند که در ابتدا بهعنوان رونهاد بزرگتری ارائه میشوند و دکمهای برای جمع کردن آگهی به اندازه کوچکتر دارند. برای بهینهسازی بیشتر عملکردتان، استفاده از آن را درنظر بگیرید. برای جزئیات بیشتر، آگهیهای برنمای جمعشدنی را ببینید.
برنماهای تطبیقی درونخطی
برنماهای تطبیقی درونخطی نسبتبه برنماهای تطبیقی لنگردار بزرگتر و بلندتر هستند. ارتفاع آنها متغیر است و میتواند به اندازه ارتفاع صفحهنمایش دستگاه باشد. برنماهای تطبیقی درونخطی نسبتبه آگهیهای برنمای تطبیقی لنگردار برای برنامههایی که آگهیهای برنما را در محتوای پیمایشی قرار میدهند توصیه میشود. برای جزئیات بیشتر، برنماهای تطبیقی درخط را ببینید.