MobileAds

Kotlin |Java

class MobileAds

يحتوي هذا الصف على منطق ينطبق على حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" بأكملها. في الوقت الحالي، تُستخدم الطرق المضمّنة فيه فقط لعملية التهيئة.

ملخّص

الثوابت
`const String!`	`ERROR_DOMAIN = "com.google.android.gms.ads"` اسم نطاق الخطأ التلقائي لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

الوظائف العامة
`java-static Unit`	`disableMediationAdapterInitialization(context: Context!)` يجب إجراء المكالمة قبل `initialize` أو طلب الإعلان الأول لإيقاف عملية تهيئة وسيط التوسّط.
`java-static InitializationStatus?`	`getInitializationStatus()` تعرض هذه الطريقة حالة إعداد حزمة تطوير البرامج (SDK).
`java-static RequestConfiguration`	`getRequestConfiguration()` تعرض هذه السمة `RequestConfiguration` العامة.
`java-static VersionInfo!`	`getVersion()` تعرض هذه السمة الإصدار الخارجي (على سبيل المثال، 20.6.0) من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.
`java-static Unit`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(context: Context!)` تُستخدَم لضبط حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
`java-static Unit`	`initialize(context: Context!, listener: OnInitializationCompleteListener!)` تُستخدَم لضبط حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
`java-static Unit`	`openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!)` يفتح واجهة مستخدم "فاحص الإعلانات".
`java-static Unit`	`openDebugMenu(context: Context!, adUnitId: String!)` يفتح قائمة تصحيح الأخطاء.
`java-static Boolean`	`putPublisherFirstPartyIdEnabled(enabled: Boolean)` تتحكّم هذه السمة في ما إذا كان معرّف الطرف الأول للناشر في "حزمة تطوير البرامج لإعلانات Google على الأجهزة الجوّالة" مفعَّلاً، وهو المعروف سابقًا باسم مفتاح التطبيق نفسه.
`java-static CustomTabsSession?`	`registerCustomTabsSession( context: Context, client: CustomTabsClient, origin: String, callback: CustomTabsCallback? )` تسجِّل هذه السمة `CustomTabsClient` في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحسين تحقيق الربح من الإعلانات داخل التطبيق ضمن هذا `CustomTabsSession`.
`java-static Unit`	`registerWebView(webview: WebView)` تسجِّل هذه السمة `WebView` في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحسين تحقيق الربح من الإعلانات داخل التطبيق ضمن هذا `WebView`.
`java-static Unit`	`setAppMuted(muted: Boolean)` يشير إلى ما إذا كان صوت التطبيق مكتومًا.
`java-static Unit`	`setAppVolume(volume: Float)` تضبط هذه السمة مستوى صوت التطبيق.
`java-static Unit`	`setRequestConfiguration(requestConfiguration: RequestConfiguration)` تضبط هذه السمة `RequestConfiguration` العام الذي سيتم استخدامه لكل `AdRequest` خلال جلسة التطبيق.
`java-static Unit`	`startPreload( context: Context, preloadConfigurations: (Mutable)List<PreloadConfiguration!>, preloadCallback: PreloadCallback )` تم إيقاف هذه الوظيفة نهائيًا. يُرجى استخدام `start` أو `start` بدلاً من ذلك.

الثوابت

ERROR_DOMAIN

const val ERROR_DOMAIN = "com.google.android.gms.ads": String!

اسم نطاق الخطأ التلقائي لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

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

disableMediationAdapterInitialization

java-static fun disableMediationAdapterInitialization(context: Context!): Unit

يجب إجراء المكالمة قبل initialize أو طلب الإعلان الأول لإيقاف عملية تهيئة وسيط التوسّط. تصبح هذه الطريقة بلا تأثير بعد تنفيذ initialize أو إرسال طلب الإعلان الأول.

تحذير: قد يؤثّر استدعاء هذا الإجراء سلبًا في أداء التوسّط. يجب عدم استدعاء هذه الطريقة إلا إذا كنت تضمِّن برامج التكيّف مع التوسّط في تطبيقك، ولكنّك لا تخطّط لاستخدام التوسّط من Google خلال جلسة التطبيق هذه (على سبيل المثال، إذا كنت تجري اختبار أ/ب).

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

تعرض هذه الطريقة حالة إعداد حزمة تطوير البرامج (SDK).

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

تعرض هذه السمة RequestConfiguration العامة.

getVersion

java-static fun getVersion(): VersionInfo!

تعرض هذه السمة الإصدار الخارجي (على سبيل المثال، 20.6.0) من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.

ليس من الضروري استدعاء initialize قبل هذه الدالة.

إعداد

@RequiresPermission(value = Manifest.permission.INTERNET)
java-static fun initialize(context: Context!): Unit

تُستخدَم لضبط حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

استدعِ هذه الطريقة في أقرب وقت ممكن بعد تشغيل التطبيق لتقليل وقت الاستجابة لطلب الإعلان الأول في الجلسة.

إذا لم يتم استدعاء هذه الطريقة، سيؤدي طلب الإعلان الأول إلى إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" تلقائيًا.

المعلمات
`context: Context!`	`Context` الذي يتم تشغيل حزمة تطوير البرامج (SDK) فيه

إعداد

java-static fun initialize(context: Context!, listener: OnInitializationCompleteListener!): Unit

تُستخدَم لضبط حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

استدعِ هذه الطريقة في أقرب وقت ممكن بعد تشغيل التطبيق لتقليل وقت الاستجابة لطلب الإعلان الأول في الجلسة.

المعلمات
`context: Context!`	النشاط `Context` الذي يتم تشغيل حزمة SDK فيه
`listener: OnInitializationCompleteListener!`	دالة ردّ نداء يتم استدعاؤها عند اكتمال عملية الإعداد.

openAdInspector

java-static fun openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!): Unit

يفتح واجهة مستخدم "فاحص الإعلانات".

openDebugMenu

java-static fun openDebugMenu(context: Context!, adUnitId: String!): Unit

يفتح قائمة تصحيح الأخطاء. يجب استدعاء initialize قبل هذه الدالة.

المعلمات
`context: Context!`	النشاط `Context` الذي يتم تشغيل حزمة SDK فيه
`adUnitId: String!`	أيّ رقم تعريف لوحدة إعلانية في "مدير إعلانات Google" مرتبط بتطبيقك

putPublisherFirstPartyIdEnabled

java-static fun putPublisherFirstPartyIdEnabled(enabled: Boolean): Boolean

تتحكّم هذه السمة في ما إذا كان معرّف الطرف الأول للناشر في "حزمة تطوير البرامج لإعلانات Google على الأجهزة الجوّالة" مفعَّلاً، وهو المعروف سابقًا باسم مفتاح التطبيق نفسه.

ويتم تفعيل المعرّف تلقائيًا. عند إيقاف هذا الخيار، يتم الاحتفاظ بالإعداد في جميع جلسات التطبيق ويتم محو المعرّف.

يجب استدعاء initialize قبل هذه الدالة.

المعلمات
`enabled: Boolean`	قيمة منطقية صحيحة إذا كان معرّف الطرف الأول للناشر مفعّلاً، وقيمة منطقية خاطئة في ما عدا ذلك.

المرتجعات
`Boolean`	تعرض القيمة "صحيح" إذا تم حفظ القرار بنجاح. يتم عرض القيمة "خطأ" إذا تعذّر حفظها.

registerCustomTabsSession

java-static fun registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
): CustomTabsSession?

تسجِّل هذه السمة CustomTabsClient في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحسين تحقيق الربح من الإعلانات داخل التطبيق ضمن هذا CustomTabsSession. سيؤدي هذا إلى إنشاء مثيل واحد فقط من CustomTabsSession، وستؤدي إعادة تشغيله إلى إلغاء الجلسة الحالية.

المعلمات
`context: Context`	`Context` الذي يتم تشغيل حزمة تطوير البرامج (SDK) فيه
`client: CustomTabsClient`	`CustomTabsClient` المستخدَمة لإنشاء مثيل `CustomTabsSession`
`origin: String`	السلسلة المستخدَمة كمصدر في Digital Asset Link لإجراء عملية التحقّق
`callback: CustomTabsCallback?`	اختياري `CustomTabsCallback` لتلقّي معاودة الاتصال من `CustomTabsSession`

المرتجعات
`CustomTabsSession?`	يجب استخدام مثيل `CustomTabsSession` لغرض علامات التبويب المخصّصة عند فتح صفحة علامات تبويب مخصّصة.

registerWebView

java-static fun registerWebView(webview: WebView): Unit

تسجِّل هذه السمة WebView في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحسين تحقيق الربح من الإعلانات داخل التطبيق ضمن هذا WebView.

setAppMuted

java-static fun setAppMuted(muted: Boolean): Unit

يشير إلى ما إذا كان صوت التطبيق مكتومًا. تؤثر في حالة كتم الصوت الأولية لجميع الإعلانات.

تحذير: يؤدي كتم صوت تطبيقك إلى تقليل أهلية عرض إعلانات الفيديو وقد يؤدي إلى خفض أرباح تطبيقك من الإعلانات. يجب استخدام واجهة برمجة التطبيقات هذه فقط إذا كان تطبيقك يوفّر للمستخدم عنصر تحكّم مخصّصًا لكتم الصوت، ويجب أن يعكس قرار المستخدم بكتم الصوت في واجهة برمجة التطبيقات هذه.

المعلمات
`muted: Boolean`	صحيح إذا كان التطبيق مكتومًا، وخطأ في الحالات الأخرى. القيمة التلقائية هي "خطأ".

setAppVolume

java-static fun setAppVolume(volume: Float): Unit

تضبط هذه السمة مستوى صوت التطبيق. تؤثّر في مستويات صوت جميع الإعلانات مقارنةً بمصادر إخراج الصوت الأخرى.

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

المعلمات
`volume: Float`	مستوى الصوت كعدد عشري من 0 (كتم الصوت) إلى 1.0 (مستوى صوت الوسائط الكامل) القيمة التلقائية هي 1.0

عمليات الطرح
`java.lang.IllegalArgumentException`	إذا كان مستوى الصوت خارج النطاق الصالح

setRequestConfiguration

java-static fun setRequestConfiguration(requestConfiguration: RequestConfiguration): Unit

تضبط هذه السمة RequestConfiguration العام الذي سيتم استخدامه لكل AdRequest خلال جلسة التطبيق.

startPreload

java-static fun startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
): Unit

يبدأ التحميل المُسبَق للإعلانات وفقًا لعمليات الإعداد المحدّدة.

تتوفّر واجهات برمجة التطبيقات الخاصة بالتحميل المُسبَق للإعلانات في إصدار أوّلي محدود. يُرجى التواصل مع مدير حسابك للحصول على مزيد من المعلومات.

المعلمات
`context: Context`	`Context` الذي يتم تشغيل حزمة تطوير البرامج (SDK) فيه
`preloadConfigurations: (Mutable)List<PreloadConfiguration!>`	عمليات الإعداد التي يتم تحميل الإعلانات مسبقًا بها
`preloadCallback: PreloadCallback`	سيتم استدعاء دالة ردّ الاتصال عند تغيُّر مدى توفّر الإعلان لكل إعداد من إعدادات التحميل المُسبَق.