هذا الدليل مخصّص للناشرين المهتمّين باستخدام التوسّط في "إعلانات Google على الأجهزة الجوّالة" مع AdFalcon. ويشرح كيفية إعداد محوّل التوسّط للعمل مع تطبيق Android الحالي وضبط الإعدادات الإضافية.
| مراجع AdFalcon |
|---|
| الوثائق |
| SDK |
| المحوّل |
| دعم العملاء |
المتطلبات الأساسية
تطبيق Android تم دمج GMA Next-Gen SDK فيه (إذا لم يكن لديك تطبيق، يمكنك الاطّلاع على مقالة إعداد GMA Next-Gen SDK.)
حساب على Google Ad Manager تم ضبط ميزة "التوسّط للتطبيقات على الأجهزة الجوّالة" فيه
إضافة AdFalcon إلى مشروعك
تضمين محوّل الشبكة وحزمة SDK
نزِّل حزمة AdFalcon 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 وفقًا للتعليمات الواردة في مستندات AdFalcon.
ليس على تطبيقك طلب بيانات من AdFalcon مباشرةً، بل تطلب GMA Next-Gen SDK بيانات من محوّل AdFalcon لجلب الإعلانات نيابةً عنك. يمكنك تحديد أيّ مَعلمات طلب إضافية إذا لزم الأمر. توضّح بقية هذه الصفحة كيفية تقديم مزيد من المعلومات إلى AdFalcon.
تهيئة عنصر إعلان باستخدام مثيل `Activity`
في الدالة الإنشائية لعنصر إعلان جديد (مثل
AdManagerAdView)،
عليك تمرير عنصر من النوع
Context.
يتم تمرير هذا Context إلى شبكات الإعلانات الأخرى عند استخدام التوسّط. تتطلّب بعض
شبكات الإعلانات Context أكثر تقييدًا من النوع
Activity
وقد لا تتمكّن من عرض الإعلانات بدون مثيل Activity. لذلك، ننصحك بتمرير مثيل Activity عند تهيئة عناصر الإعلانات لضمان تجربة متّسقة مع شبكات الإعلانات التي تتوسّط فيها.