دمج 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
في دالة إنشاء عنصر إعلان جديد (على سبيل المثال،
AdView
)،
يجب تمرير عنصر من النوع
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\u003eThe Mediation Test Suite allows you to test whether your mediation setup is configured correctly before going live to ensure ad requests and revenue are flowing as expected.\u003c/p\u003e\n"],["\u003cp\u003eBy integrating the Mediation Test Suite into your app, you gain access to detailed, real-time insights into the ad mediation waterfall to troubleshoot setup problems quickly.\u003c/p\u003e\n"],["\u003cp\u003eThe suite offers comprehensive functionalities such as manual ad requests for testing specific scenarios, a visual ad request waterfall, and adapter status reports to monitor adapter configuration.\u003c/p\u003e\n"],["\u003cp\u003eIt enables you to manage and organize multiple ad units and ad sources within the test suite, including line item details and other properties for each ad source.\u003c/p\u003e\n"],["\u003cp\u003eThis ensures a seamless and optimized ad mediation experience, leading to higher fill rates, increased ad revenue, and improved app performance.\u003c/p\u003e\n"]]],["Publishers using Google Mobile Ads mediation with Zucks should integrate the Zucks SDK and adapter into their Android app via Android Studio's `libs` folder and update their app-level Gradle file. They must also configure the `AndroidManifest.xml` according to Zucks' documentation. An `Activity` instance should be passed when initializing ad objects for mediated ad networks. The Google Mobile Ads SDK handles fetching ads via the Zucks adapter, without direct calls from the app.\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](/admob/android/quick-start).)\n\n- An AdMob account and [an ad unit configured with mediation line\n items](//support.google.com/admob/answer/3124703).\n\nHelpful primers\n\nThe following Help Center articles provide background information on mediation:\n\n- [About AdMob Mediation](//support.google.com/admob/answer/3063564)\n- [Set up AdMob Mediation](//support.google.com/admob/answer/3124703)\n- [Optimize AdMob Network](//support.google.com/admob/answer/3534471)\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[`AdView`](/admob/android/reference/com/google/android/gms/ads/AdView)),\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."]]