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

تتيح 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.

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

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

إذا كانت لديك بنود إعلانية محجوزة في &quot;إدارة الإعلانات&quot; تستهدف حجمًا مخصّصًا، يمكنك إنشاء 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