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

اختيار النظام الأساسي: Android New-selected Android iOS Unity Flutter

هذا الدليل مخصّص للناشرين المهتمّين باستخدام ميزة "توسّط إعلانات 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 مباشرةً، إذ تتصل GMA Next-Gen SDKبـ Zucks adapter لجلب الإعلانات نيابةً عنك. يمكنك تحديد أي مَعلمات طلب إضافية إذا لزم الأمر. ويوضّح الجزء المتبقي من هذه الصفحة كيفية تقديم المزيد من المعلومات إلى Zucks.

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

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