آگهیهای بینابینی آگهیهای تمامصفحهای هستند که میانای برنامه میزبان را میپوشانند. این آگهیها معمولاً در نقاط انتقال طبیعی در جریان برنامه نمایش داده میشوند، مثلاً بین فعالیتها یا درطول وقفه بین مراحل بازی. وقتی برنامهای آگهی بینابینی نشان میدهد، کاربر میتواند روی آگهی تکضرب بزند و به مقصد آن برود یا آن را ببندد و به برنامه برگردد.
این راهنما نحوه ادغام کردن آگهیهای بینابینی را در برنامه Android توضیح میدهد.
پیشنیازها
بار کردن آگهی
برای بار کردن آگهی بینابینی، روش ثابت AdManagerInterstitialAd
load() را فراخوانی کنید و
AdManagerInterstitialAdLoadCallback را ارسال کنید تا آگهی بارشده یا هرگونه خطای احتمالی را
دریافت کنید. AdManagerInterstitialAdLoadCallback از LoadAdError برای ارائه جزئیات خطا استفاده میکند.
جاوا
AdManagerInterstitialAd.load(
this,
AD_UNIT_ID,
new AdManagerAdRequest.Builder().build(),
new AdManagerInterstitialAdLoadCallback() {
@Override
public void onAdLoaded(@NonNull AdManagerInterstitialAd interstitialAd) {
Log.d(TAG, "Ad was loaded.");
MyActivity.this.interstitialAd = interstitialAd;
}
@Override
public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
Log.d(TAG, loadAdError.getMessage());
interstitialAd = null;
}
});
Kotlin
AdManagerInterstitialAd.load(
this,
AD_UNIT_ID,
AdManagerAdRequest.Builder().build(),
object : AdManagerInterstitialAdLoadCallback() {
override fun onAdLoaded(interstitialAd: AdManagerInterstitialAd) {
Log.d(TAG, "Ad was loaded.")
this@MyActivity.interstitialAd = interstitialAd
}
override fun onAdFailedToLoad(adError: LoadAdError) {
Log.d(TAG, adError.message)
interstitialAd = null
}
},
)
تنظیم FullScreenContentCallback
FullScreenContentCallback رویدادهای مربوط به نمایش
InterstitialAd شما را مدیریت میکند. قبلاز نمایش InterstitialAd، حتماً
فراخوانی برگشتی را تنظیم کنید:
جاوا
interstitialAd.setFullScreenContentCallback(
new FullScreenContentCallback() {
@Override
public void onAdDismissedFullScreenContent() {
// Called when fullscreen content is dismissed.
Log.d(TAG, "The ad was dismissed.");
// Make sure to set your reference to null so you don't
// show it a second time.
MyActivity.this.interstitialAd = null;
}
@Override
public void onAdFailedToShowFullScreenContent(AdError adError) {
// Called when fullscreen content failed to show.
Log.d(TAG, "The ad failed to show.");
// Make sure to set your reference to null so you don't
// show it a second time.
MyActivity.this.interstitialAd = null;
}
@Override
public void onAdShowedFullScreenContent() {
// Called when fullscreen content is shown.
Log.d(TAG, "The ad was shown.");
}
@Override
public void onAdImpression() {
// Called when an impression is recorded for an ad.
Log.d(TAG, "The ad recorded an impression.");
}
@Override
public void onAdClicked() {
// Called when ad is clicked.
Log.d(TAG, "The ad was clicked.");
}
});
Kotlin
interstitialAd?.fullScreenContentCallback =
object : FullScreenContentCallback() {
override fun onAdDismissedFullScreenContent() {
// Called when fullscreen content is dismissed.
Log.d(TAG, "Ad was dismissed.")
// Don't forget to set the ad reference to null so you
// don't show the ad a second time.
interstitialAd = null
}
override fun onAdFailedToShowFullScreenContent(adError: AdError) {
// Called when fullscreen content failed to show.
Log.d(TAG, "Ad failed to show.")
// Don't forget to set the ad reference to null so you
// don't show the ad a second time.
interstitialAd = null
}
override fun onAdShowedFullScreenContent() {
// Called when fullscreen content is shown.
Log.d(TAG, "Ad showed fullscreen content.")
}
override fun onAdImpression() {
// Called when an impression is recorded for an ad.
Log.d(TAG, "Ad recorded an impression.")
}
override fun onAdClicked() {
// Called when ad is clicked.
Log.d(TAG, "Ad was clicked.")
}
}
نمایش آگهی
آگهیهای بینابینی باید درطول وقفههای طبیعی در جریان برنامه نمایش داده شوند. بین سطوح بازی یا پساز تکمیل یک تکلیف توسط کاربر، نمونههای خوبی هستند. برای نمایش آگهی بینابینی، از روش show استفاده کنید.
جاوا
if (interstitialAd != null) {
interstitialAd.show(this);
} else {
Log.d(TAG, "The interstitial ad is still loading.");
}
Kotlin
interstitialAd?.show(this)
همیشه با آگهیهای آزمایشی آزمایش کنید
هنگام ساختن و آزمایش کردن برنامههایتان، حتماً از آگهیهای آزمایشی استفاده کنید نه آگهیهای زنده و تولیدی. انجام ندادن این کار میتواند منجر به تعلیق حسابتان شود.
سادهترین راه برای بار کردن آگهیهای آزمایشی، استفاده از شناسه واحد آگهی آزمایشی اختصاصی ما برای آگهیهای بینابینی Android است:
/21775744923/example/interstitial
این شناسه بهطور ویژه پیکربندی شده است تا برای هر درخواست، آگهیهای آزمایشی برگرداند و شما میتوانید آزادانه از آن در برنامههای خودتان هنگام کدنویسی، آزمایش، و اشکالزدایی استفاده کنید. فقط مطمئن شوید که قبلاز انتشار برنامهتان، آن را با شناسه واحد آگهی خودتان جایگزین کنید.
برای جزئیات درباره آگهیهای آزمایشی Google Mobile Ads SDK (Legacy)، به فعال کردن آگهیهای آزمایشی مراجعه کنید.
نمونهها در GitHub
مراحل بعدی
- درباره هدفیابی آگهی بیشتر بدانید.
- درباره حریم خصوصی کاربر بیشتر بدانید.
- راهاندازی کیت توسعه نرمافزار و بار کردن آگهی بهینهشده (بتا) را کاوش کنید.