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

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

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

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

• تطبيق Android مدمَج معه GMA Next-Gen SDK (إذا لم يكن لديك تطبيق، يمكنك الاطّلاع على مقالة إعداد GMA Next-Gen SDK.)

• حساب على Google Ad Manager تم ضبط ميزة "التوسّط للتطبيقات على الأجهزة الجوّالة" فيه

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

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

نزِّل حزمة Zucks SDK والمحوّل من الـ روابط السابقة.

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

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

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