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

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)` يتحكّم هذا الخيار في ما إذا كان معرّف الطرف الأول للناشر في حزمة تطوير البرامج (SDK) لإعلانات 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

يتحكّم هذا الخيار في ما إذا كان معرّف الطرف الأول للناشر في حزمة تطوير البرامج (SDK) لإعلانات 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`	السلسلة المستخدَمة كمصدر في رابط مادة العرض الرقمية لإثبات الملكية
`callback: CustomTabsCallback?`	رقم هاتف اختياري `CustomTabsCallback` لتلقّي مكالمات من

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

registerWebView

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

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

setAppMuted

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

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

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

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

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`	دالة ردّ اتصال يتمّ استدعاؤها عند تغيير مدى توفّر الإعلان لكلّ إعداد مُسبَق للتحميل.