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

اختيار النظام الأساسي: 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.

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

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

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