دمج AdFalcon مع التوسّط
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
هذا الدليل مخصّص للناشرين المهتمين باستخدام التوسّط في "إعلانات Google على الأجهزة الجوّالة" مع AdFalcon. ويشرح هذا الدليل كيفية إعداد محوّل توسّط ليعمل مع تطبيق Android الحالي وكيفية ضبط الإعدادات الإضافية.
المتطلبات الأساسية
مقدمات مفيدة
تقدّم مقالات "مركز المساعدة" التالية معلومات أساسية عن التوسّط:
إضافة AdFalcon إلى مشروعك
تضمين محوّل الشبكة وحزمة تطوير البرامج (SDK)
نزِّل حزمة تطوير البرامج (SDK) ومحوّل AdFalcon من
الروابط السابقة.
في "استوديو 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
وفقًا للتعليمات الواردة في مستندات AdFalcon.
لا يحتاج تطبيقك إلى طلب الإعلانات من AdFalcon مباشرةً، بل تطلب حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة محوّل AdFalcon لجلب الإعلانات نيابةً عنك. يمكنك تحديد أي مَعلمات طلب إضافية، إذا لزم الأمر.
توضّح بقية هذه الصفحة كيفية تقديم المزيد من المعلومات إلى AdFalcon.
تهيئة عنصر الإعلان باستخدام مثيل 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\u003eThis guide helps publishers integrate AdFalcon with Google Mobile Ads mediation in their Android apps.\u003c/p\u003e\n"],["\u003cp\u003eYou need an existing Android app with the Google Mobile Ads SDK and an AdMob account with configured ad units.\u003c/p\u003e\n"],["\u003cp\u003eIntegration involves adding the AdFalcon SDK and adapter to your project and configuring your AndroidManifest.xml file.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Mobile Ads SDK handles communication with the AdFalcon adapter to fetch ads, but you can customize request parameters if needed.\u003c/p\u003e\n"],["\u003cp\u003eInitializing your ad objects with an Activity instance is recommended for optimal performance with mediated ad networks.\u003c/p\u003e\n"]]],["Publishers integrate Google Mobile Ads mediation with AdFalcon by downloading the AdFalcon SDK and adapter. Include these files in the Android project's `libs` folder and modify the `AndroidManifest.xml` file as per AdFalcon documentation. Ensure the app-level Gradle file includes the implementation for these files. Initialize ad objects with an `Activity` instance for consistent network experience. The Google Mobile Ads SDK then handles fetching ads via the AdFalcon adapter.\n"],null,["This guide is intended for publishers who are interested in using Google\nMobile Ads mediation with **AdFalcon**. It walks\nthrough the setup of a mediation adapter to work with your current Android app\nand the configuration of additional settings.\n\n| AdFalcon Resources |\n|-----------------------------------------------------|\n| [Documentation](http://adfalcon.com) |\n| [SDK](http://www.adfalcon.com/en/download-sdk.html) |\n| [Adapter](http://www.adfalcon.com/en/adapters.html) |\n| [Customer support](mailto:support@adfalcon.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 AdFalcon to your project\n\nInclude network adapter and SDK\n\nDownload the AdFalcon 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\nAdFalcon documentation.\n\nYour app doesn't need to call AdFalcon\ndirectly---Google Mobile Ads SDK calls the\nAdFalcon 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\nAdFalcon.\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."]]