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

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

مراجع Zucks
الوثائق
حزمة تطوير البرامج (SDK)
المحوّل
دعم العملاء

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

مقدمات مفيدة

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

إضافة 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

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

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

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

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