دمج Zucks باستخدام التوسّط

اختيار النظام الأساسي: Android iOS Unity Flutter Android (الإصدار القديم)

هذا الدليل مخصّص للناشرين المهتمّين باستخدام ميزة "توسّط إعلانات Google على الأجهزة الجوّالة" مع Zucks. ويشرح كيفية إعداد محوّل توسّط للعمل مع تطبيق Android الحالي وضبط الإعدادات الإضافية.

مراجع Zucks
الوثائق
SDK
المحوّل
الدعم الفني

المتطلبات الأساسية

معلومات أساسية مفيدة

تقدّم مقالات "مركز المساعدة" التالية معلومات أساسية عن التوسّط:

إضافة Zucks إلى مشروعك

تضمين محوّل الشبكة وحزمة SDK

نزِّل حزمة Zucks 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

عدِّل ملف AndroidManifest.xml وفقًا للتعليمات الواردة في مستندات Zucks.

لا يحتاج تطبيقك إلى طلب Zucks مباشرةً، إذ تطلب Google Mobile Ads SDK (Legacy)محوّل Zucks لجلب الإعلانات نيابةً عنك. يمكنك تحديد أي مَعلمات طلب إضافية إذا لزم الأمر. توضّح بقية هذه الصفحة كيفية تقديم مزيد من المعلومات إلى Zucks.

تهيئة عنصر الإعلان باستخدام مثيل `Activity`

في الدالة الإنشائية لعنصر إعلان جديد (مثل AdView)، يجب تمرير عنصر من النوع Context. يتم تمرير هذا Context إلى شبكات إعلانية أخرى عند استخدام التوسّط. تتطلب بعض الشبكات الإعلانية Context أكثر تقييدًا من النوع Activity وقد لا تتمكّن من عرض الإعلانات بدون مثيل Activity. لذلك، ننصحك بتمرير مثيل Activity عند تهيئة عناصر الإعلانات لضمان تجربة متّسقة مع شبكات الإعلانات التي تستخدم التوسّط.