الإعلانات البينية هي إعلانات بملء الشاشة تغطّي واجهة التطبيق المضيف. ويتم عرض هذه الإعلانات عادةً عند نقاط انتقال طبيعية في مسار تشغيل التطبيق، مثلاً بين الأنشطة أو أثناء الإيقاف المؤقت بين المستويات في لعبة. عندما يعرض التطبيق إعلانًا بينيًا، يتوفّر للمستخدم خيار النقر على الإعلان والمتابعة إلى وجهته أو إغلاقه والعودة إلى التطبيق.
يشرح هذا الدليل كيفية دمج الإعلانات البينية في أي تطبيق على Android.
المتطلّبات الأساسية
- الإصدار 19.7.0 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- أكمِل دليل البدء.
الاختبار دائمًا باستخدام الإعلانات الاختبارية
عند إنشاء تطبيقاتك واختبارها، احرص على استخدام إعلانات تجريبية بدلاً من الإعلانات النهائية المباشرة. وقد يؤدي عدم الالتزام بذلك إلى تعليق حسابك.
أسهل طريقة لتحميل الإعلانات الاختبارية هي استخدام رقم التعريف المخصّص للوحدة الإعلانية الاختبارية للإعلانات البينية بنظام Android:
/6499/example/interstitial
لقد تم تكوينه خصيصًا لعرض إعلانات اختبارية لكل طلب، ويمكنك استخدامه في تطبيقاتك الخاصة أثناء الترميز والاختبار وتصحيح الأخطاء. ما عليك سوى استبداله بمعرّف الوحدة الإعلانية قبل نشر تطبيقك.
لمزيد من المعلومات عن آلية عمل الإعلانات الاختبارية لحزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة، اطّلِع على اختبار الإعلانات.
تحميل إعلان
لتحميل إعلان بيني، يمكنك استدعاء طريقة AdManagerInterstitialAd
الثابتة
load()
وتمرير
AdManagerInterstitialAdLoadCallback
لتلقّي الإعلان الذي تم تحميله أو أي أخطاء محتملة. لاحِظ أنّه كما هو الحال مع استدعاءات استدعاء تحميل التنسيق الأخرى،
يستفيد AdManagerInterstitialAdLoadCallback
من
LoadAdError
لتقديم تفاصيل أعلى دقة عن الأخطاء.
Java
import com.google.android.gms.ads.admanager.AdManagerInterstitialAd;
import com.google.android.gms.ads.admanager.AdManagerInterstitialAdLoadCallback;
public class MainActivity extends Activity {
private AdManagerInterstitialAd mAdManagerInterstitialAd;
private static final String TAG = "MainActivity";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
AdManagerInterstitialAd.load(this,"/6499/example/interstitial", adRequest,
new AdManagerInterstitialAdLoadCallback() {
@Override
public void onAdLoaded(@NonNull AdManagerInterstitialAd interstitialAd) {
// The mAdManagerInterstitialAd reference will be null until
// an ad is loaded.
mAdManagerInterstitialAd = interstitialAd;
Log.i(TAG, "onAdLoaded");
}
@Override
public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
// Handle the error
Log.d(TAG, loadAdError.toString());
mAdManagerInterstitialAd = null;
}
});
}
}
Kotlin
import com.google.android.gms.ads.admanager.AdManagerInterstitialAd;
import com.google.android.gms.ads.admanager.AdManagerInterstitialAdLoadCallback;
class MainActivity : AppCompatActivity() {
private var mAdManagerInterstitialAd: AdManagerInterstitialAd? = null
private final val TAG = "MainActivity"
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
var adRequest = AdManagerAdRequest.Builder().build()
AdManagerInterstitialAd.load(this,"/6499/example/interstitial", adRequest, object : AdManagerInterstitialAdLoadCallback() {
override fun onAdFailedToLoad(adError: LoadAdError) {
Log.d(TAG, adError?.toString())
mAdManagerInterstitialAd = null
}
override fun onAdLoaded(interstitialAd: AdManagerInterstitialAd) {
Log.d(TAG, 'Ad was loaded.')
mAdManagerInterstitialAd = interstitialAd
}
})
}
}
إعداد ميزة FullscreenContentCallback
تعالج السمة FullScreenContentCallback
الأحداث ذات الصلة بعرض
InterstitialAd
الخاصة بك. قبل عرض InterstitialAd
، تأكَّد من ضبط
رمز معاودة الاتصال:
Java
mAdManagerInterstitialAd.setFullScreenContentCallback(new FullScreenContentCallback(){
@Override
public void onAdClicked() {
// Called when a click is recorded for an ad.
Log.d(TAG, "Ad was clicked.");
}
@Override
public void onAdDismissedFullScreenContent() {
// Called when ad is dismissed.
// Set the ad reference to null so you don't show the ad a second time.
Log.d(TAG, "Ad dismissed fullscreen content.");
mAdManagerInterstitialAd = null;
}
@Override
public void onAdFailedToShowFullScreenContent(AdError adError) {
// Called when ad fails to show.
Log.e(TAG, "Ad failed to show fullscreen content.");
mAdManagerInterstitialAd = null;
}
@Override
public void onAdImpression() {
// Called when an impression is recorded for an ad.
Log.d(TAG, "Ad recorded an impression.");
}
@Override
public void onAdShowedFullScreenContent() {
// Called when ad is shown.
Log.d(TAG, "Ad showed fullscreen content.");
}
});
Kotlin
mAdManagerInterstitialAd?.fullScreenContentCallback = object: FullScreenContentCallback() {
override fun onAdClicked() {
// Called when a click is recorded for an ad.
Log.d(TAG, "Ad was clicked.")
}
override fun onAdDismissedFullScreenContent() {
// Called when ad is dismissed.
Log.d(TAG, "Ad dismissed fullscreen content.")
mAdManagerInterstitialAd = null
}
override fun onAdFailedToShowFullScreenContent(adError: AdError?) {
// Called when ad fails to show.
Log.e(TAG, "Ad failed to show fullscreen content.")
mAdManagerInterstitialAd = null
}
override fun onAdImpression() {
// Called when an impression is recorded for an ad.
Log.d(TAG, "Ad recorded an impression.")
}
override fun onAdShowedFullScreenContent() {
// Called when ad is shown.
Log.d(TAG, "Ad showed fullscreen content.")
}
}
عرض الإعلان
يجب عرض الإعلانات البينية أثناء فترات التوقف المؤقت الطبيعية أثناء تشغيل التطبيق.
ويُعتبر الانتقال بين مستويات اللعبة مثالاً جيدًا أو بعد إكمال المستخدم لإحدى المهام.
لعرض إعلان بيني، استخدِم طريقة
show()
.
Java
if (mAdManagerInterstitialAd != null) {
mAdManagerInterstitialAd.show(MyActivity.this);
} else {
Log.d("TAG", "The interstitial ad wasn't ready yet.");
}
Kotlin
if (mAdManagerInterstitialAd != null) {
mAdManagerInterstitialAd?.show(this)
} else {
Log.d("TAG", "The interstitial ad wasn't ready yet.")
}
بعض أفضل الممارسات
- فكِّر في ما إذا كانت الإعلانات البينية هي نوع الإعلانات المناسب لتطبيقك.
- تعمل الإعلانات البينية بشكل أفضل في التطبيقات التي تتضمّن نقاط انتقال طبيعية. تؤدي خاتمة مهمة داخل تطبيق ما، مثل مشاركة صورة أو إكمال مستوى لعبة، إلى إنشاء هذه النقطة. احرص على مراعاة النقاط التي ستعرض عندها الإعلانات البينية في سير عمل تطبيقك، ومدى احتمال استجابة المستخدم.
- احرص على إيقاف الإجراء مؤقتًا عند عرض إعلان بيني.
- هناك عدد من الأنواع المختلفة من الإعلانات البينية: النصية والمصوّرة والفيديو وغيرها. من المهم التأكّد من أنّ تطبيقك عندما يعرض إعلانًا بينيًا، يعلّق أيضًا استخدامه لبعض الموارد للسماح للإعلان بالاستفادة منها. على سبيل المثال، عند إجراء مكالمة لعرض إعلان بيني، احرص على إيقاف أي إخراج صوتي ينشئه تطبيقك مؤقتًا.
- يجب السماح بمرور الوقت الكافي للتحميل.
- من المهم أيضًا التأكّد من عرض الإعلانات البينية في الوقت المناسب، ومن المهم أيضًا التأكّد من أنّ المستخدم لن يحتاج إلى الانتظار حتى يتم تحميلها. إنّ تحميل الإعلان مسبقًا عن طريق طلب البيانات من
load()
قبل طلب الإعلان "show()
" يمكن أن يضمن أنّ تطبيقك يحتوي على إعلان بيني يتم تحميله بالكامل في الوقت الحالي عندما يحين وقت عرض أحد الإعلانات. - لا تملأ المستخدم بالإعلانات.
- على الرغم من أنّ زيادة عدد مرّات ظهور الإعلانات البينية في تطبيقك قد يبدو طريقة رائعة لزيادة الأرباح، قد يؤدي ذلك أيضًا إلى انخفاض مستوى تجربة المستخدم وانخفاض نِسب النقر إلى الظهور. احرص على عدم مقاطعة المستخدمين كثيرًا لدرجة أنهم لن يعودوا قادرين على الاستمتاع باستخدام تطبيقك.
أمثلة على GitHub
الخطوات التالية
- تعرَّف على مزيد من المعلومات عن استهداف الإعلانات.
- مزيد من المعلومات حول خصوصية المستخدم.
- استكشف الإعداد المحسّن لحزمة تطوير البرامج (SDK) وتحميل الإعلانات (إصدار تجريبي).