لمناقشة منتجاتنا وتقديم ملاحظات بشأنها، انضمّ إلى قناة Discord الرسمية في منتدى Google للإعلان وقياس الأداء.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

AdSize

Kotlin |Java

class AdSize

حجم إعلان البانر

ملخّص

الثوابت
`const Int`	`AUTO_HEIGHT = -2` قيمة ثابتة تؤدي إلى تغيير ارتفاع الإعلان استنادًا إلى ارتفاع الجهاز في الاتجاه الحالي
`const AdSize!`	`BANNER` حجم إعلان البانر وفقًا لجمعية التسويق على الأجهزة الجوّالة (MMA) (320×50 بكسل بكثافة مستقلة)
`const AdSize!`	`FLUID` إعلان بانر بحجم ديناميكي يتطابق مع عرض العنصر الرئيسي ويتوسّع/ينكمش ارتفاعه ليتناسب مع محتوى الإعلان بعد اكتمال التحميل.
`const AdSize!`	`FULL_BANNER` حجم إعلان البانر الكامل وفقًا لمعايير Interactive Advertising Bureau‏ (IAB) (468×60 بكسل بكثافة مستقلة)
`const Int`	`FULL_WIDTH = -1` قيمة ثابتة تؤدي إلى تطابق عرض الإعلان مع عرض الجهاز في الاتجاه الحالي
`const AdSize!`	`INVALID` حجم إعلان غير صالح سيؤدي إلى تعذُّر طلب الإعلان على الفور
`const AdSize!`	`LARGE_BANNER` حجم إعلان البانر الكبير (320×100 بكسل مستقلة الكثافة)
`const AdSize!`	`LEADERBOARD` حجم إعلانات لوحة الصدارة وفقًا لمعيار Interactive Advertising Bureau‏ (IAB) (728×90 بكسل مستقلة الكثافة)
`const AdSize!`	`MEDIUM_RECTANGLE` حجم الإعلان المستطيل المتوسط الذي يحدّده مكتب Interactive Advertising Bureau‏ (IAB) (300×250 بكسل بكثافة مستقلة)
`const AdSize!`	`SMART_BANNER` تم إيقاف هذه السمة نهائيًا. استخدِم `getCurrentOrientationAnchoredAdaptiveBannerAdSize` بدلاً من ذلك.
`const AdSize!`	`WIDE_SKYSCRAPER` حجم إعلان "المبنى الشاهق العريض" وفقًا لمعيار IAB‏ (160×600 بكسل مستقلة الكثافة)

وظائف الإنشاء العامة
`AdSize(width: Int, height: Int)` لإنشاء `AdSize` جديد

الوظائف العامة
`Boolean`	`equals(other: Any?)` تقارن هذه الدالة بين `AdSize` والكائن المحدّد وتشير إلى ما إذا كانا متساويين.
`java-static AdSize!`	`getCurrentOrientationAnchoredAdaptiveBannerAdSize( context: Context!, width: Int )` تعرِض هذه السمة `AdSize` بالعرض المحدّد وارتفاع محسَّن من Google لإنشاء إعلان بانر.
`java-static AdSize!`	`getCurrentOrientationInlineAdaptiveBannerAdSize( context: Context!, width: Int )` تعرِض `AdSize` بعرض معيّن وارتفاع يساوي دائمًا 0.
`Int`	`getHeightInPixels(context: Context!)` تعرِض هذه السمة ارتفاع `AdSize` هذا بالبكسل الفعلي.
`java-static AdSize!`	`getInlineAdaptiveBannerAdSize(width: Int, maxHeight: Int)` تعرِض `AdSize` بعرض معيّن وارتفاع يساوي دائمًا 0.
`java-static AdSize!`	`getLandscapeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int)` تعرِض هذه السمة `AdSize` بالعرض المحدّد وارتفاع محسَّن من Google لإنشاء إعلان بانر.
`java-static AdSize!`	`getLandscapeInlineAdaptiveBannerAdSize(context: Context!, width: Int)` تعرِض `AdSize` بعرض معيّن وارتفاع يساوي دائمًا 0.
`java-static AdSize!`	`getPortraitAnchoredAdaptiveBannerAdSize(context: Context!, width: Int)` تعرِض هذه السمة `AdSize` بالعرض المحدّد وارتفاع محسَّن من Google لإنشاء إعلان بانر.
`java-static AdSize!`	`getPortraitInlineAdaptiveBannerAdSize(context: Context!, width: Int)` تعرِض `AdSize` بعرض معيّن وارتفاع يساوي دائمًا 0.
`Int`	`getWidthInPixels(context: Context!)` عرض هذا `AdSize` بالبكسل الفعلي
`Int`	`hashCode()`
`Boolean`	`isAutoHeight()` لعرض ما إذا كان هذا العنصر `AdSize` ذو ارتفاع تلقائي.
`Boolean`	`isFluid()` لعرض ما إذا كان هذا `AdSize` بحجم متغير أم لا.
`Boolean`	`isFullWidth()` لعرض ما إذا كان هذا الرمز `AdSize` بعرض كامل.
`String!`	`toString()`

المواقع العامة
`Int`	`height`
`Int`	`width`

الثوابت

AUTO_HEIGHT

const val AUTO_HEIGHT = -2: Int

قيمة ثابتة تؤدي إلى تغيير ارتفاع الإعلان استنادًا إلى ارتفاع الجهاز في الاتجاه الحالي يحدّد إعلان AUTO_HEIGHT ارتفاعه أثناء بدء تشغيل AdView ولا يتغيّر أبدًا بعد ذلك.

const val BANNER: AdSize!

حجم إعلان البانر وفقًا لجمعية التسويق على الأجهزة الجوّالة (MMA) (320×50 بكسل بكثافة مستقلة)

FLUID

const val FLUID: AdSize!

إعلان بانر بحجم ديناميكي يتطابق مع عرض العنصر الرئيسي ويتوسّع/ينكمش ارتفاعه ليتناسب مع محتوى الإعلان بعد اكتمال التحميل.

FULL_BANNER

const val FULL_BANNER: AdSize!

حجم إعلان البانر الكامل وفقًا لمعايير Interactive Advertising Bureau‏ (IAB) (468×60 بكسل بكثافة مستقلة)

FULL_WIDTH

const val FULL_WIDTH = -1: Int

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

غير صالحة

const val INVALID: AdSize!

حجم إعلان غير صالح سيؤدي إلى تعذُّر طلب الإعلان على الفور

LARGE_BANNER

const val LARGE_BANNER: AdSize!

حجم إعلان البانر الكبير (320×100 بكسل مستقلة الكثافة)

قائمة الصدارة

const val LEADERBOARD: AdSize!

حجم إعلانات لوحة الصدارة وفقًا لمعيار Interactive Advertising Bureau‏ (IAB) (728×90 بكسل مستقلة الكثافة)

MEDIUM_RECTANGLE

const val MEDIUM_RECTANGLE: AdSize!

حجم الإعلان المستطيل المتوسط الذي يحدّده مكتب Interactive Advertising Bureau‏ (IAB) (300×250 بكسل بكثافة مستقلة)

SMART_BANNER

const val SMART_BANNER: AdSize!

بانر بحجم ديناميكي بالعرض الكامل والارتفاع التلقائي

WIDE_SKYSCRAPER

const val WIDE_SKYSCRAPER: AdSize!

حجم إعلان "المبنى الشاهق العريض" وفقًا لمعيار IAB‏ (160×600 بكسل مستقلة الكثافة) لا تتيح شبكة "إعلانات Google على الأجهزة الجوّالة" هذا الحجم حاليًا، وهو مخصّص لشبكات المواقع الإعلانية التي تتضمّن ميزة التوسّط فقط.

وظائف الإنشاء العامة

AdSize

AdSize(width: Int, height: Int)

لإنشاء AdSize جديد

المعلمات
`width: Int`	عرض الإعلان بوحدات بكسل مستقلة الكثافة
`height: Int`	ارتفاع الإعلان بوحدات بكسل لا تعتمد على الكثافة

عمليات الرمي
`java.lang.IllegalArgumentException`	إذا كان العرض أو الارتفاع سالبًا

الوظائف العامة

يساوي

fun equals(other: Any?): Boolean

تقارن هذه الدالة بين AdSize والكائن المحدّد وتشير إلى ما إذا كانا متساويين.

getCurrentOrientationAnchoredAdaptiveBannerAdSize

java-static fun getCurrentOrientationAnchoredAdaptiveBannerAdSize(
    context: Context!,
    width: Int
): AdSize!

تعرِض هذه السمة AdSize بالعرض المحدّد وارتفاع محسَّن من Google لإنشاء إعلان بانر. سيكون للحجم الذي يتم إرجاعه نسبة عرض إلى ارتفاع مشابهة لـ AdSize، وهي مناسبة للتثبيت بالقرب من أعلى تطبيقك أو أسفله. ولن يكون الارتفاع أكبر من% 15 من ارتفاع الاتجاه الحالي للجهاز ولن يكون أصغر من 50 بكسل. تعرض هذه الدالة دائمًا الارتفاع نفسه لأيّ مجموعة من العرض / الجهاز. إذا كان السياق فارغًا أو تعذّر تحديد ارتفاع الجهاز من السياق، يتم عرض INVALID.

المرتجعات
`AdSize!`	عنصر `AdSize` تعرِض القيمة `INVALID` إذا كان السياق فارغًا أو إذا تعذّر تحديد ارتفاع الجهاز من السياق.

getCurrentOrientationInlineAdaptiveBannerAdSize

java-static fun getCurrentOrientationInlineAdaptiveBannerAdSize(
    context: Context!,
    width: Int
): AdSize!

تعرِض AdSize بعرض معيّن وارتفاع يساوي دائمًا 0. يسمح حجم الإعلان هذا لخوادم Google باختيار حجم إعلان مثالي بارتفاع أقل من ارتفاع الشاشة أو يساويه في الاتجاه المطلوب. يمكن استرداد الحجم الدقيق للإعلان الذي تم عرضه من خلال استدعاء getAdSize داخل دالة ردّ الاتصال onAdLoaded. هذا الحجم الإعلاني هو الأنسب للإعلانات التي يُراد عرضها داخل محتوى قابل للتمرير.

getHeightInPixels

fun getHeightInPixels(context: Context!): Int

تعرِض هذه السمة ارتفاع AdSize هذا بالبكسل الفعلي. بالنسبة إلى حجم السائل، يتم عرض القيمة -1.

getInlineAdaptiveBannerAdSize

java-static fun getInlineAdaptiveBannerAdSize(width: Int, maxHeight: Int): AdSize!

تعرِض AdSize بعرض معيّن وارتفاع يساوي دائمًا 0. يسمح حجم الإعلان هذا لخوادم Google باختيار حجم إعلان مثالي بارتفاع أقل من أو يساوي الحد الأقصى للارتفاع الوارد في المَعلمة maxHeight. يمكن استرداد الحجم الدقيق للإعلان الذي تم عرضه من خلال استدعاء getAdSize داخل دالة ردّ الاتصال onAdLoaded. هذا الحجم الإعلاني هو الأنسب للإعلانات التي يُراد عرضها داخل محتوى قابل للتمرير.

المعلمات
`maxHeight: Int`	الحد الأقصى للارتفاع الذي سيبلغه الإعلان المحمَّل. يجب أن يكون الحد الأدنى 32 بكسل مستقل الكثافة، ولكن يُنصح باستخدام الحد الأقصى للارتفاع 50 بكسل مستقل الكثافة أو أعلى.

getLandscapeAnchoredAdaptiveBannerAdSize

java-static fun getLandscapeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

تعرِض هذه السمة AdSize بالعرض المحدّد وارتفاع محسَّن من Google لإنشاء إعلان بانر. سيكون للحجم الذي يتم إرجاعه نسبة عرض إلى ارتفاع مشابهة لـ BANNER، وهو مناسب للتثبيت بالقرب من أعلى تطبيقك أو أسفله. ولن يكون الارتفاع أكبر من% 15 من ارتفاع الجهاز في الوضع الأفقي ولن يكون أصغر من 50 بكسل. تعرض هذه الدالة دائمًا الارتفاع نفسه لأيّ مجموعة من العرض / الجهاز. إذا كان السياق فارغًا أو تعذّر تحديد ارتفاع الجهاز من السياق، يتم عرض INVALID.

المرتجعات
`AdSize!`	عنصر `AdSize` تعرِض القيمة `INVALID` إذا كان السياق فارغًا أو إذا تعذّر تحديد ارتفاع الجهاز من السياق.

getLandscapeInlineAdaptiveBannerAdSize

java-static fun getLandscapeInlineAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

تعرِض AdSize بعرض معيّن وارتفاع يساوي دائمًا 0. يسمح حجم الإعلان هذا لخوادم Google باختيار حجم إعلان مثالي بارتفاع أقل من ارتفاع الشاشة أو يساويه في الوضع الأفقي. يمكن استرداد الحجم الدقيق للإعلان الذي تم عرضه من خلال استدعاء getAdSize داخل دالة ردّ الاتصال onAdLoaded. هذا الحجم الإعلاني هو الأنسب للإعلانات التي يُراد عرضها داخل محتوى قابل للتمرير.

getPortraitAnchoredAdaptiveBannerAdSize

java-static fun getPortraitAnchoredAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

تعرِض هذه السمة AdSize بالعرض المحدّد وارتفاع محسَّن من Google لإنشاء إعلان بانر. سيكون للحجم الذي يتم إرجاعه نسبة عرض إلى ارتفاع مشابهة لـ BANNER، وهو مناسب للتثبيت بالقرب من أعلى تطبيقك أو أسفله. ولن يكون الارتفاع أكبر من% 15 من ارتفاع الجهاز في الوضع العمودي ولن يكون أصغر من 50 بكسل. تعرض هذه الدالة دائمًا الارتفاع نفسه لأيّ مجموعة من العرض / الجهاز.

المرتجعات
`AdSize!`	عنصر `AdSize` تعرِض القيمة `INVALID` إذا كان السياق فارغًا أو إذا تعذّر تحديد ارتفاع الجهاز من السياق.

getPortraitInlineAdaptiveBannerAdSize

java-static fun getPortraitInlineAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

تعرِض AdSize بعرض معيّن وارتفاع يساوي دائمًا 0. يسمح حجم الإعلان هذا لخوادم Google باختيار حجم إعلان مثالي أصغر من أو يساوي ارتفاع الشاشة في الوضع العمودي. يمكن استرداد الحجم الدقيق للإعلان الذي تم عرضه من خلال استدعاء getAdSize داخل دالة ردّ الاتصال onAdLoaded. هذا الحجم الإعلاني هو الأنسب للإعلانات التي يُراد عرضها داخل محتوى قابل للتمرير.

getWidthInPixels

fun getWidthInPixels(context: Context!): Int

عرض هذا AdSize بالبكسل الفعلي بالنسبة إلى حجم السائل، يتم عرض القيمة -1.

hashCode

fun hashCode(): Int

isAutoHeight

fun isAutoHeight(): Boolean

لعرض ما إذا كان هذا العنصر AdSize ذو ارتفاع تلقائي.

isFluid

fun isFluid(): Boolean

لعرض ما إذا كان هذا AdSize بحجم متغير أم لا.

isFullWidth

fun isFullWidth(): Boolean

لعرض ما إذا كان هذا الرمز AdSize بعرض كامل.

toString

fun toString(): String!

المواقع العامة

الطول

val height: Int

العرض

val width: Int