دمج 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 عند تهيئة عناصر الإعلانات لضمان تجربة متّسقة مع شبكات الإعلانات التي تتوسّط فيها.