دمج Zucks مع التوسط
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
هذا الدليل مخصّص للناشرين المهتمين باستخدام التوسّط في "إعلانات Google على الأجهزة الجوّالة" مع Zucks. ويشرح هذا الدليل كيفية إعداد محوّل توسّط ليعمل مع تطبيق Android الحالي وكيفية ضبط الإعدادات الإضافية.
المتطلبات الأساسية
إضافة Zucks إلى مشروعك
تضمين محوّل الشبكة وحزمة تطوير البرامج (SDK)
نزِّل حزمة تطوير البرامج (SDK) والمحوّل الخاصَّين بمنصة Zucks من
الروابط السابقة.
في "استوديو Android"، أدرِج ملفات المحوّل وحزمة تطوير البرامج (SDK) في مجلد libs
الخاص بمشروعك. تأكَّد من أنّ ملف Gradle على مستوى التطبيق يتضمّن ما يلي:
Kotlin
dependencies {
implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar", "*.jar"))))
// ...
}
Groovy
dependencies {
implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'])
// ...
}
عدِّل ملف AndroidManifest.xml
وفقًا للتعليمات الواردة في مستندات Zucks.
لا يحتاج تطبيقك إلى طلب الإعلانات من Zucks مباشرةً، بل تطلب حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة المحوّل البرمجي الخاص بـ Zucks لجلب الإعلانات نيابةً عنك. يمكنك تحديد أي مَعلمات طلب إضافية، إذا لزم الأمر.
توضّح بقية هذه الصفحة بالتفصيل كيفية تقديم المزيد من المعلومات إلى Zucks.
تهيئة عنصر الإعلان باستخدام مثيل Activity
في دالة إنشاء عنصر إعلان جديد (على سبيل المثال،
AdManagerAdView
)،
يجب تمرير عنصر من النوع
Context
.
يتم تمرير Context
هذا إلى شبكات إعلانية أخرى عند استخدام التوسّط. تتطلّب بعض شبكات الإعلانات Context
أكثر صرامة من النوع Activity
، وقد لا تتمكّن من عرض الإعلانات بدون مثيل Activity
. لذلك، ننصحك بتمرير مثيل Activity
عند تهيئة عناصر الإعلانات
لضمان تجربة متّسقة مع شبكات الإعلانات التي تستخدم التوسّط.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide helps publishers integrate Zucks ads into their Android apps using Google Mobile Ads mediation.\u003c/p\u003e\n"],["\u003cp\u003eIt involves adding the Zucks SDK and adapter to your project and configuring your app's manifest file.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Mobile Ads SDK handles communication with Zucks, fetching ads on your behalf.\u003c/p\u003e\n"],["\u003cp\u003eInitialization of ad objects with an Activity instance is recommended for optimal compatibility with mediated ad networks.\u003c/p\u003e\n"]]],[],null,["This guide is intended for publishers who are interested in using Google\nMobile Ads mediation with **Zucks**. It walks\nthrough the setup of a mediation adapter to work with your current Android app\nand the configuration of additional settings.\n\n| Zucks Resources |\n|---------------------------------------------------------------------------------|\n| [Documentation](http://ms.zucksadnetwork.com/media/sdk/manual/admob-mediation/) |\n| [SDK](http://ms.zucksadnetwork.com/media/sdk/manual/android/) |\n| [Adapter](http://ms.zucksadnetwork.com/media/sdk/manual/admob-mediation/) |\n| [Customer support](mailto:support@zucksadnetwork.com) |\n\nPrerequisites\n\n- An Android app with Google Mobile Ads SDK integrated. (If you don't\n have one, see [Get Started](/ad-manager/mobile-ads-sdk/android/quick-start).)\n\n- A Google Ad Manager account with [Mediation for mobile\n apps](//support.google.com/admanager/answer/6272813) configured.\n\nAdd Zucks to your project\n\nInclude network adapter and SDK\n\nDownload the Zucks SDK and adapter from the\n[previous links](#resources).\n\nIn Android Studio, include the adapter and SDK files in your project's `libs`\nfolder. Make sure that your app-level Gradle file includes the following: \n\nKotlin \n\n dependencies {\n implementation(fileTree(mapOf(\"dir\" to \"libs\", \"include\" to listOf(\"\\*.aar\", \"\\*.jar\"))))\n // ...\n }\n\nGroovy \n\n dependencies {\n implementation fileTree(dir: 'libs', include: \\['\\*.aar', '\\*.jar'\\])\n // ...\n }\n\nConfigure the AndroidManifest.xml file\n\nModify your `AndroidManifest.xml` file as instructed in the\nZucks documentation.\n\nYour app doesn't need to call Zucks\ndirectly---Google Mobile Ads SDK calls the\nZucks adapter to fetch ads on your behalf. If necessary, you can\nspecify any additional request parameters.\nThe rest of this page details how to provide more information to\nZucks.\n\nInitialize your ad object with an Activity instance\n\nIn the constructor for a new ad object (for example,\n\n[`AdManagerAdView`](/ad-manager/mobile-ads-sdk/android/reference/com/google/android/gms/ads/admanager/AdManagerAdView)),\n\nyou must pass in an object of type\n[`Context`](//developer.android.com/reference/android/content/Context).\nThis `Context` is passed on to other ad networks when using mediation. Some\nad networks require a more restrictive `Context` that is of type\n[`Activity`](//developer.android.com/reference/android/app/Activity)\nand may not be able to serve ads without an `Activity` instance. Therefore,\nwe recommend passing in an `Activity` instance when initializing ad objects\nto ensure a consistent experience with your mediated ad networks."]]