MobileAds

Kotlin |Java

public class MobileAds

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

ملخّص

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

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

الثوابت

ERROR_DOMAIN

public static final String ERROR_DOMAIN = "com.google.android.gms.ads"

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

الإجراءات العامة

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

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

getInitializationStatus

public static @Nullable InitializationStatus getInitializationStatus()

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

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

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

getVersion

public static VersionInfo getVersion()

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

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

إعداد

@RequiresPermission(value = Manifest.permission.INTERNET)
public static void initialize(Context context)

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

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

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

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

إعداد

public static void initialize(Context context, OnInitializationCompleteListener listener)

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

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

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

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

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

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

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

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

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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

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

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

registerCustomTabsSession

public static @Nullable CustomTabsSession registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

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

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

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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

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

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

setAppVolume

public static void setAppVolume(float volume)

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

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

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

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

setRequestConfiguration

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

public static void startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

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

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

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