دمج Zucks مع التوسط

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

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

• تطبيق Android تم دمج حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" فيه (إذا لم يكن لديك حساب، يُرجى الاطّلاع على البدء).

• حساب على "مدير إعلانات Google" تم إعداد التوسّط للتطبيقات الجوّالة فيه

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

يجب تضمين محوِّل الشبكة وحزمة تطوير البرامج (SDK).

نزِّل حزمة تطوير البرامج (SDK) ومحوِّل Zucks من الروابط السابقة.

في "استوديو Android"، أدرِج ملفات المحوِّل وحزمة SDK في مجلد libs الخاص بمشروعك. تأكَّد من أنّ ملف Gradle على مستوى التطبيق يتضمّن ما يلي:

dependencies {
    implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar", "*.jar"))))
    // ...
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'])
    // ...
}

ضبط ملف AndroidManifest.xml

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

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

بدء عنصر إعلانك باستخدام مثيل Activity

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