دمج Tencent GDT مع التوسّط
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
هذا الدليل مخصّص للناشرين المهتمّين باستخدام التوسّط في "إعلانات Google على الأجهزة الجوّالة" مع Tencent GDT. ويشرح هذا الدليل كيفية إعداد محوّل توسّط ليعمل مع تطبيق Android الحالي وكيفية ضبط الإعدادات الإضافية.
المتطلبات الأساسية
مقدمات مفيدة
تقدّم مقالات "مركز المساعدة" التالية معلومات أساسية عن التوسّط:
إضافة Tencent GDT إلى مشروعك
تضمين محوّل الشبكة وحزمة تطوير البرامج (SDK)
نزِّل حزمة Tencent GDT SDK والمحوّل من
الروابط السابقة.
في "استوديو 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
وفقًا للتعليمات الواردة في مستندات Tencent GDT.
لا يحتاج تطبيقك إلى طلب Tencent GDT مباشرةً، بل تطلب حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة محوّل Tencent GDT لجلب الإعلانات نيابةً عنك. يمكنك تحديد أي مَعلمات طلب إضافية، إذا لزم الأمر.
توضّح بقية هذه الصفحة كيفية تقديم المزيد من المعلومات إلى Tencent GDT.
تهيئة عنصر الإعلان باستخدام مثيل 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 explains how to integrate Tencent GDT ads into your Android app using Google Mobile Ads mediation.\u003c/p\u003e\n"],["\u003cp\u003ePublishers need an existing Android app with the Google Mobile Ads SDK and an AdMob account with configured mediation line items to begin.\u003c/p\u003e\n"],["\u003cp\u003eIntegration involves adding the Tencent GDT SDK and adapter to your project, configuring the AndroidManifest.xml, and initializing ad objects with an Activity instance.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Mobile Ads SDK handles communication with the Tencent GDT adapter; publishers don't need to directly interact with Tencent GDT.\u003c/p\u003e\n"]]],["This guide details how publishers can integrate Tencent GDT with Google Mobile Ads mediation in Android apps. Key actions include downloading the Tencent GDT SDK and adapter, adding them to the project's `libs` folder, and updating the `AndroidManifest.xml` file as per Tencent GDT's instructions. Additionally, it recommends initializing ad objects with an `Activity` instance for broader ad network compatibility. The Google Mobile Ads SDK manages ad requests via the Tencent GDT adapter.\n"],null,["This guide is intended for publishers who are interested in using Google\nMobile Ads mediation with **Tencent GDT**. It walks\nthrough the setup of a mediation adapter to work with your current Android app\nand the configuration of additional settings.\n\n| Tencent GDT Resources |\n|------------------------------------------------------------------------------------------------------|\n| [Documentation](http://e.qq.com/dev/#index) |\n| [SDK](http://imgcache.qq.com/qzone/biz/gdt/dev/sdk/android/release/GDT_Android_SDK.zip) |\n| [Adapter](http://imgcache.qq.com/qzone/biz/gdt/dev/sdk/android/release/GDT_Android_ADMobAdapter.zip) |\n| [Customer support](mailto:GDTLM@tencent.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 Tencent GDT to your project\n\nInclude network adapter and SDK\n\nDownload the Tencent GDT 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\nTencent GDT documentation.\n\nYour app doesn't need to call Tencent GDT\ndirectly---Google Mobile Ads SDK calls the\nTencent GDT 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\nTencent GDT.\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."]]