"الإعلانات على شاشة فتح التطبيق" هي شكل إعلان مخصّص للناشرين الذين يريدون تحقيق الربح من شاشات تحميل تطبيقاتهم. يمكن للمستخدمين إغلاق "الإعلانات على شاشة فتح التطبيق" في أي وقت. عندما يفتح المستخدمون تطبيقك في المقدّمة، اعرض "الإعلانات على شاشة فتح التطبيق".
لمزيد من المعلومات، يُرجى الاطّلاع على إرشادات "الإعلانات على شاشة فتح التطبيق".يشرح هذا الدليل كيفية دمج "الإعلانات على شاشة فتح التطبيق" في تطبيق Android.
قبل البدء
قبل المتابعة، عليك تنفيذ ما يلي:
- إعداد GMA Next-Gen SDK
- استخدِم معرّف الوحدة الإعلانية الاختبارية على شاشة فتح التطبيق
ca-app-pub-3940256099942544/9257395921.- عند إنشاء تطبيقك واختباره، تأكَّد من استخدام الإعلانات الاختبارية بدلاً من الإعلانات المباشرة والنهائية. إذا لم تستخدم معرّف الوحدة الإعلانية الاختبارية، يمكن أن تعلّق Google حسابك.
- قبل نشر تطبيقك، استبدِل هذا المعرّف بمعرّف الوحدة الإعلانية.
- لمعرفة تفاصيل عن الإعلانات الاختبارية في GMA Next-Gen SDK، يُرجى الاطّلاع على مقالة تفعيل الإعلانات الاختبارية.
تحميل إعلان
يحمّل المثال التالي إعلانًا واحدًا:
Kotlin
// Load ads after you initialize MobileAds. AppOpenAd.load( AdRequest.Builder(adUnitId).build(), object : AdLoadCallback<AppOpenAd> { override fun onAdLoaded(ad: AppOpenAd) { // App open ad loaded. appOpenAd = ad } override fun onAdFailedToLoad(adError: LoadAdError) { // App open ad failed to load. Log.e(TAG, "App open ad failed to load: ${adError.message}") appOpenAd = null } }, )
جافا
// Load ads after you initialize MobileAds. AppOpenAd.load( new AdRequest.Builder(adUnitId).build(), new AdLoadCallback<AppOpenAd>() { @Override public void onAdLoaded(AppOpenAd ad) { // App open ad loaded. appOpenAd = ad; } @Override public void onAdFailedToLoad(LoadAdError adError) { // App open ad failed to load. Log.e(TAG, "App open ad failed to load: " + adError.getMessage()); appOpenAd = null; } });
عند الاختبار، استخدِم معرّف الوحدة الإعلانية الاختبارية:
ca-app-pub-3940256099942544/9257395921.
عرض الإعلان
لعرض "إعلان على شاشة فتح التطبيق"، استخدِم طريقةshow. تنتهي صلاحية "الإعلانات على شاشة فتح التطبيق" بعد أربع ساعات من تحميلها. لا تعرِض "إعلان على شاشة فتح التطبيق" يستغرق تحميله أكثر من
أربع ساعات.
يعرض المثال التالي الإعلان:
Kotlin
private fun showAd(appOpenAd: AppOpenAd, activity: Activity) { // Show the ad. appOpenAd.show(activity) }
جافا
private void showAd(AppOpenAd appOpenAd, Activity activity) { // Show the ad. appOpenAd.show(activity); }
التعامل مع عمليات التشغيل على البارد وشاشات التحميل
يحدث التشغيل على البارد عندما يتم تشغيل تطبيقك من القرص، ويحدث التشغيل الدافئ عندما تعيد فتح التطبيق من الذاكرة. أثناء التشغيل على البارد، لا يتوفّر لديك إعلان تم تحميله مسبقًا لعرضه. أثناء التشغيل الدافئ، قد يظل لديك إعلان محمَّل متاح للعرض.
أثناء التشغيل على البارد، قد يتفاعل المستخدمون مع تطبيقك قبل تحميله وعرض إعلان. لتجنُّب تقديم تجربة سيئة للمستخدمين، اعرض "الإعلانات على شاشة فتح التطبيق" عند التشغيل على البارد من شاشة التحميل فقط أثناء تحميل مواد عرض التطبيق. يمكنك عرض "الإعلانات على شاشة فتح التطبيق" أثناء انتظار المستخدمين لتحميل تطبيقك. لا تعرض "إعلان على شاشة فتح التطبيق" عند بدء تشغيل التطبيق لأول مرة. إذا اكتمل تحميل مواد العرض ووصل المستخدمون إلى المحتوى الرئيسي قبل تحميل الإعلان، لا تعرض الإعلان.
حمِّل مواد عرض التطبيق في سلسلة محادثات في الخلفية لمواصلة التحميل أثناء عرض الإعلان. إذا انتهى تحميل شاشة التحميل أثناء عرض الإعلان، يمكنك إغلاق شاشة التحميل في طريقة ردّ الاتصال الخاصة بإغلاق الإعلان.
الاستماع إلى أحداث الإعلانات
قبل عرض الإعلان، استمِع إلى أحداث مراحل نشاط الإعلان. يسجّل المثال التالي عمليات الاستدعاء لأحداث الإعلانات:
Kotlin
private fun listenToAdEvents() { // Listen for ad events. val ad = appOpenAd if (ad == null) { Log.e(TAG, "App open ad is not ready yet.") return } ad.adEventCallback = object : AppOpenAdEventCallback { override fun onAdShowedFullScreenContent() { // App open ad did show. } override fun onAdDismissedFullScreenContent() { // App open ad did dismiss. appOpenAd = null } override fun onAdFailedToShowFullScreenContent( fullScreenContentError: FullScreenContentError ) { // App open ad failed to show. Log.e(TAG, "App open ad failed to show: ${fullScreenContentError.message}") } override fun onAdImpression() { // App open ad did record an impression. } override fun onAdClicked() { // App open ad did record a click. } } }
جافا
private void listenToAdEvents() { // Listen for ad events. if (appOpenAd == null) { Log.e(TAG, "App open ad is not ready yet."); return; } appOpenAd.setAdEventCallback( new AppOpenAdEventCallback() { @Override public void onAdShowedFullScreenContent() { // App open ad did show. } @Override public void onAdDismissedFullScreenContent() { // App open ad did dismiss. appOpenAd = null; } @Override public void onAdFailedToShowFullScreenContent( @NonNull FullScreenContentError fullScreenContentError) { // App open ad failed to show. Log.e(TAG, "App open ad failed to show: " + fullScreenContentError.getMessage()); } @Override public void onAdImpression() { // App open ad did record an impression. } @Override public void onAdClicked() { // App open ad did record a click. } }); }