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

الثوابت

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 على الأجهزة الجوّالة"

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

في حال عدم استدعاء هذه الطريقة، سيؤدّي أول طلب إعلان إلى إعداد حزمة "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)

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

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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

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

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

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