ضبط حجم ثابت للبانر

تتيح Google Mobile Ads SDK (Legacy) عرض أحجام إعلانات ثابتة للحالات التي لا تلبّي فيها إعلانات البانر التكيُّفية احتياجاتك.

يعرض الجدول التالي الأحجام العادية لإعلانات البانر.

يجب أن يكون حجم الحاوية التي تضع فيها إعلانك مساويًا على الأقل لحجم إعلان البانر. أي مساحة متروكة تقلل بشكل فعال من حجم الحاوية. إذا لم تتسع الحاوية لـ "إعلان البانر"، لن يظهر الإعلان وسيتم تسجيل التحذير التالي:

W/Ads: Not enough space to show ad. Needs 320x50 dp, but only has 288x495 dp.

اضبط حجم الإعلان على قيمة أصغر من حجم شاشة الجهاز أو مساوية له. لتحديد الحد الأقصى لحجم الشاشة، استخدِم الطريقة Resources.getDisplayMetrics. تستخدم أبعاد العنصر AdSize وحدات بكسل مستقلة الكثافة (dp). عند المقارنة، قم بتحويل حجم الشاشة من بكسل إلى dp. لمعرفة التفاصيل حول قيود الحجم، يُرجى الاطّلاع على مقالة تحديد المشاكل وحلّها في ما يتعلّق بمرّات الظهور غير المعروضة في "إدارة إعلانات Google".

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

بدلاً من إنشاء AdManagerAdView برمجيًا، يمكنك إضافة AdManagerAdView إلى تنسيق XML لـ Activity أو Fragment الذي تريد عرضه فيه. وفي ما يلي مثال لذلك:

<com.google.android.gms.ads.admanager.AdManagerAdView
    xmlns:ads="http://schemas.android.com/apk/res-auto"
    android:id="@+id/banner_ad_view"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_centerHorizontal="true"
    android:layout_alignParentBottom="true"
    ads:adSize="BANNER"
    ads:adUnitId="/21775744923/example/fixed-size-banner" />

يُرجى ملاحظة السمات المطلوبة التالية:

• ‫ads:adSize: اضبط هذه السمة على حجم الإعلان الذي تريد استخدامه. إذا كنت لا تريد استخدام الحجم العادي الذي يحدّده الثابت، يمكنك ضبط حجم مخصّص بدلاً من ذلك. مثال: ads:adSize="320x50"

• ads:adUnitId: اضبط هذه القيمة على الوحدة الإعلانية في تطبيقك التي سيتم عرض الإعلانات فيها. إذا كنت تعرض إعلانات البانر في أنشطة مختلفة، سيتطلّب كل نشاط وحدة إعلانية.

حجم الإعلان المخصّص

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

AdSize customAdSize = new AdSize(250, 250);
AdManagerAdView adView = new AdManagerAdView(this);
adView.setAdSizes(customAdSize);

val customAdSize = AdSize(250, 250)
val adView = AdManagerAdView(this)
adView.setAdSizes(customAdSize)

أحجام إعلانات متعددة

إذا أردت استهداف بنود إعلانية بأحجام إعلانات متعددة في طلب عرض الإعلان نفسه، يتيح لك AdManagerAdView ضبط أحجام إعلانات متعددة في آنٍ واحد.

AdManagerAdView adView = new AdManagerAdView(this);
adView.setAdSizes(AdSize.BANNER, new AdSize(120, 20), new AdSize(250, 250));

val adView = AdManagerAdView(this)
adView.setAdSizes(AdSize.BANNER, AdSize(120, 20), AdSize(250, 250))

يتم ضبط AdManagerAdView تلقائيًا على حجم الإعلان الأول. بعد تحميل الإعلان، يتغيّر حجم AdManagerAdView إلى حجم الإعلان الذي تم تحميله. يجب أن يكون التخطيط قادرًا على التكيف تلقائيًا مع الحجم الجديد.

يمكنك أيضًا تحديد أحجام إعلانات متعددة باستخدام السمة ads:adSizes في ملف تنسيق XML:

<com.google.android.gms.ads.admanager.AdManagerAdView
   android:id="@+id/multiple_ad_sizes_view"
   android:layout_width="wrap_parent"
   android:layout_height="wrap_content"
   android:layout_alignParentBottom="true"
   android:layout_centerHorizontal="true"
   ads:adSizes="BANNER,120x20,250x250"
   ads:adUnitId="AD_UNIT_ID" />

مثال على أحجام إعلانات متعددة

Java Kotlin