إعلانات البانر

إعلانات البانر هي إعلانات مستطيلة تشغل جزءًا من تصميم التطبيق. وتظل معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، سواء في الجزء العلوي أو السفلي من الشاشة أو مضمَّنة مع المحتوى أثناء تمرير الشاشة. يمكن إعادة تحميل إعلانات البنر تلقائيًا بعد فترة زمنية محدّدة. اطّلِع على نظرة عامة على إعلانات البانر لمزيد من المعلومات.

يوضّح لك هذا الدليل كيفية بدء استخدام إعلانات البانر التكيُّفية الثابتة، التي تحقّق أفضل أداء من خلال تحسين حجم الإعلان لكل جهاز باستخدام عرض إعلان تحدّده.

إعلانات البانر التكيّفية الثابتة هي إعلانات بنِسب عرض إلى ارتفاع ثابتة بدلاً من إعلانات الحجم الثابت العادية. تكون نسبة العرض إلى الارتفاع مشابهة للمعيار المتّبع في المجال والذي يبلغ 320×50. بعد تحديد العرض الكامل المتاح، سيعرض لك إعلانًا بالارتفاع الأمثل لذلك العرض. لا يتغيّر الارتفاع الأمثل للإعلان في الطلبات الواردة من الجهاز نفسه، ولا يلزم نقل طرق العرض المحيطة عند تتمة تحديث الإعلان.

المتطلبات الأساسية

• أكمِل دليل البدء.

إجراء الاختبار دائمًا باستخدام الإعلانات الاختبارية

عند إنشاء تطبيقاتك واختبارها، احرص على استخدام إعلانات اختبارية بدلاً من الإعلانات المنشورة. وقد يؤدي عدم إجراء ذلك إلى تعليق حسابك.

إنّ أسهل طريقة لتحميل الإعلانات الاختبارية هي استخدام رقم تعريف الوحدة الإعلانية الاختبارية المخصّص لإعلانات بانر Android:

ca-app-pub-3940256099942544/9214589741

تم إعداده خصيصًا لعرض إعلانات اختبارية لكل طلب، ويمكنك استخدامه في تطبيقاتك أثناء الترميز والاختبار وتصحيح الأخطاء. ما عليك سوى الحرص على استبداله بمعرّف وحدتك الإعلانية قبل نشر تطبيقك.

لمزيد من المعلومات عن آلية عمل الإعلانات الاختبارية في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، اطّلِع على الإعلانات الاختبارية.

إضافة AdView إلى التنسيق

يمكنك إنشاء بانر من خلال تحديد حجم الإعلان. أكمِل الخطوات التالية:

1. أنشئ حجم إعلان تكيُّفيًا ثابتًا بالعرض الكامل:

   Java

   // Get the ad size with screen width.
   public AdSize getAdSize() {
     DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
     int adWidthPixels = displayMetrics.widthPixels;
   
     if (VERSION.SDK_INT >= VERSION_CODES.R) {
       WindowMetrics windowMetrics = this.getWindowManager().getCurrentWindowMetrics();
       adWidthPixels = windowMetrics.getBounds().width();
     }
   
     float density = displayMetrics.density;
     int adWidth = (int) (adWidthPixels / density);
     return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
   }
   MyActivity.java
   

   Kotlin

   // Get the ad size with screen width.
   private val adSize: AdSize
     get() {
       val displayMetrics = resources.displayMetrics
       val adWidthPixels =
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
           val windowMetrics: WindowMetrics = this.windowManager.currentWindowMetrics
           windowMetrics.bounds.width()
         } else {
           displayMetrics.widthPixels
         }
       val density = displayMetrics.density
       val adWidth = (adWidthPixels / density).toInt()
       return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
     }
   MainActivity.kt
   

2. أنشئ AdView باستخدام حجم الإعلان و أضِفه إلى تنسيق تطبيقك:

   Java

   // Create a new ad view.
   adView = new AdView(this);
   adView.setAdUnitId(AD_UNIT_ID);
   adView.setAdSize(getAdSize());
   
   // Replace ad container with new ad view.
   adContainerView.removeAllViews();
   adContainerView.addView(adView);
   MyActivity.java
   

   Kotlin

   // Create a new ad view.
   val adView = AdView(this)
   adView.adUnitId = AD_UNIT_ID
   adView.setAdSize(adSize)
   this.adView = adView
   
   // Replace ad container with new ad view.
   binding.adViewContainer.removeAllViews()
   binding.adViewContainer.addView(adView)
   MainActivity.kt
   

تحميل إعلان

بعد وضع AdView، تكون الخطوة التالية هي تحميل إعلان. يتم ذلك باستخدام طريقة loadAd() في فئة AdView. ويأخذ مَعلمة AdRequest تحتوي على معلومات وقت التشغيل، مثل معلومات الاستهداف، عن طلب إعلان واحد.

ملاحظة مهمة: عليك إجراء جميع طلبات البيانات إلى حزمة SDK لعرض الإعلانات للأجهزة الجوّالة في سلسلة المهام الرئيسية.

في ما يلي مثال يوضّح كيفية تحميل إعلان:

Java

// Start loading the ad in the background.
AdRequest adRequest = new AdRequest.Builder().build();
adView.loadAd(adRequest);
MyActivity.java

Kotlin

// Start loading the ad in the background.
val adRequest = AdRequest.Builder().build()
adView.loadAd(adRequest)
MainActivity.kt

إذا نجحت عملية الإعداد، يعني ذلك أنّ تطبيقك جاهز لعرض إعلانات البانر.

ملاحظة: يمكنك استخدام طلبات تحميل الإعلانات لإنشاء ذاكرة تخزين مؤقت للإعلانات المحمَّلة مسبقًا قبل أن تنوي عرضها، حتى يمكن عرض الإعلانات بدون أي وقت استجابة عند الحاجة. بما أنّ صلاحية الإعلانات تنتهي بعد ساعة، عليك محو ذاكرة التخزين المؤقت هذه وإعادة تحميل إعلانات جديدة كل ساعة.

إعادة تحميل إعلان

إذا أعددت وحدتك الإعلانية لإعادة التحميل، لن تحتاج إلى طلب إعلان آخر عند تعذُّر تحميل الإعلان. تلتزم حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" بأيّ معدّل تحديث حدّدته في واجهة مستخدم AdMob. إذا لم تكن قد فعّلت ميزة الصعق الكهربي، قدِّم طلبًا جديدًا. لمزيد من التفاصيل حول إعادة تحميل الوحدات الإعلانية، مثل ضبط معدّل إعادة التحميل، اطّلِع على ضبط خيار إعادة التحميل التلقائية لإعلانات البانر.

ملاحظة: عند ضبط معدّل إعادة تحميل في واجهة مستخدم AdMob، لا تتم عملية إعادة التحميل التلقائية إلا إذا كان إعلان البانر مرئيًا على الشاشة.

أحداث الإعلانات

يمكنك الاستماع إلى عدد من الأحداث في رحلة الإعلان، بما في ذلك التحميل، ومرّات ظهور الإعلان والنقر عليه، بالإضافة إلى أحداث فتح الإعلان وإغلاقه. ننصح بضبط طلب معاودة الاتصال قبل تحميل البانر.

Java

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(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() عندما يعود المستخدِم إلى التطبيق بعد مشاهدة عنوان URL المقصود للإعلان. يمكن لتطبيقك استخدامها لاستئناف الأنشطة المعلّقة أو تنفيذ أي عمل آخر ضروري ليصبح جاهزًا للتفاعل. يُرجى الرجوع إلى مثال AdMob AdListener لتنفيذ طرق مستمع الإعلانات في تطبيق Android API Demo.
onAdFailedToLoad()	إنّ طريقة onAdFailedToLoad() هي الطريقة الوحيدة التي تتضمّن مَعلمة. توضِّح مَعلمة الخطأ من النوع LoadAdError الخطأ الذي حدث. لمزيد من المعلومات، يُرجى الرجوع إلى مستندات تصحيح أخطاء تحميل الإعلانات.
onAdImpression()	يتمّ استدعاء الطريقة onAdImpression() عند تسجيل مرّة ظهور لإعلان.
onAdLoaded()	يتم تنفيذ الطريقة onAdLoaded() عند انتهاء تحميل إعلان. إذا أردت تأخير إضافة AdView إلى نشاطك أو المقتطف إلى أن تتأكّد من أنّه سيتم تحميل إعلان، على سبيل المثال، يمكنك إجراء ذلك هنا.
onAdOpened()	يتمّ استدعاء الطريقة onAdOpened() عندما يفتح إعلان شاشة مثبّتة تغطي الشاشة.

تسريع الأجهزة لإعلانات الفيديو

لكي تظهر إعلانات الفيديو بنجاح في مشاهدات إعلانات البانر، يجب تفعيل تسريع الأجهزة.

يتم تفعيل ميزة "تسريع الأجهزة" تلقائيًا، ولكن قد تختار بعض التطبيقات إيقافها. إذا كان ذلك ينطبق على تطبيقك، ننصحك بتفعيل ميزة تسريع الأجهزة لklassen 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>

يمكنك الاطّلاع على دليل تسريع الأجهزة للحصول على مزيد من المعلومات حول خيارات التحكّم في تسريع الأجهزة. يُرجى العِلم أنّه لا يمكن تفعيل ميزة "تسريع الأجهزة" لمشاهدات الإعلانات الفردية إذا كان النشاط متوقفًا، لذا يجب تفعيل ميزة "تسريع الأجهزة" للنشاط نفسه.

مراجع إضافية

أمثلة على GitHub

• مثال على إعلانات البانر التكيّفية الثابتة: Java | Kotlin

• عرض الميزات المتقدّمة: Java | Kotlin

الخطوات التالية

إعلانات البانر القابلة للتصغير

إعلانات البانر القابلة للتصغير هي إعلانات بانر يتم عرضها في البداية كتراكب أكبر، مع زر لتصغير الإعلان إلى حجم أصغر. ننصحك باستخدامه لتحسين أدائك بشكلٍ أكبر. يمكنك الاطّلاع على إعلانات البانر القابلة للتصغير لمزيد من التفاصيل.

إعلانات البانر التكيّفية المضمّنة

إعلانات البانر التكيّفية المضمّنة هي إعلانات بانر أكبر وأطول مقارنةً بإعلانات البانر التكيّفية الثابتة. ويكون ارتفاعها متغيرًا، ويمكن أن يكون بطول شاشة الجهاز. ننصحك باستخدام إعلانات البانر التكيّفية المضمّنة بدلاً من إعلانات البانر التكيّفية الثابتة في التطبيقات التي تضع إعلانات البانر في محتوى قابل للتصفّح. اطّلِع على الإعلانات البانرات المُكيَّفة المضمّنة للحصول على مزيد من التفاصيل.

استكشاف مواضيع أخرى

• خصوصية المستخدم
• تحسين عملية إعداد حزمة تطوير البرامج (SDK) وتحميل الإعلانات (إصدار تجريبي)