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

اختيار النظام الأساسي: Android iOS Flutter Android (إصدار قديم)

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

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

الحجم بالوحدات المستقلة عن الجهاز (العرض × الارتفاع) الوصف مدى التوفّر ثابت AdSize
320×50 بانر الهواتف والأجهزة اللوحية BANNER
100x320 بانر كبير الهواتف والأجهزة اللوحية LARGE_BANNER
300×250 مستطيل متوسط من IAB الهواتف والأجهزة اللوحية MEDIUM_RECTANGLE
468×60 بانر كامل الحجم من IAB الأجهزة اللوحية FULL_BANNER
728×90 قائمة صدارة من IAB الأجهزة اللوحية LEADERBOARD

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

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

إضافة 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);

Kotlin

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));

Kotlin

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