للاستفادة من التحسينات على وقت الاستجابة والثبات في Android، استخدِم GMA Next-Gen SDK. يتناول هذا الدليل كيفية إعداد Google Mobile Ads Flutter Plugin لاستخدام GMA Next-Gen SDK على Android.
المتطلبات الأساسية
قبل المتابعة، يُرجى اتّباع الخطوات التالية:
- ثبِّت الإصدار 9.0.0 أو إصدارًا أحدث من Google Mobile Ads Flutter Plugin.
- إعداد Google Mobile Ads Flutter Plugin
- أن يكون لديك مشروع Flutter
ضبط إعدادات Android Gradle
لاستخدام GMA Next-Gen SDK على Android، عليك تعديل إعدادات Gradle باتّباع الخطوات التالية:
- ضبط الحد الأدنى لمستويات واجهة برمجة تطبيقات Android ومستوى تجميعها
- إذا كنت تستخدم التوسّط، اتّبِع خطوات نقل البيانات لاستبعاد وحدات
com.google.android.gmsلتجنُّب أخطاء الفئات المكرّرة.
التشغيل مع بيان البيئة
لاستخدام GMA Next-Gen SDK عند إنشاء تطبيق Android وتشغيله، يجب تقديم مجموعة تعريف بيئة USE_NEXT_GEN_SDK مضبوطة على القيمة true.
في كل مرة تنشئ فيها تطبيقك أو تشغّله، نفِّذ ما يلي:
flutter run --dart-define USE_NEXT_GEN_SDK=true
التشغيل باستخدام إعدادات بيئة التطوير المتكاملة
إذا كنت تشغّل تطبيقك باستخدام بيئة تطوير متكاملة (IDE)، يمكنك ضبط إعدادات بيئة التطوير في إعدادات التشغيل بدلاً من تمرير العلامة باستخدام سطر الأوامر.
على سبيل المثال، يمكنك تحديد هذه المتغيرات في ملف JSON وإضافتها إلى إعدادات بيئة التطوير المتكاملة (IDE). لمعرفة التفاصيل، يُرجى الاطّلاع على تحديد تعريفات البيئة.
تعديل نماذج الإعلانات الأصلية
في حال استخدام نماذج الإعلانات المدمجة مع المحتوى، عليك إجراء التعديلات التالية لتفعيل GMA Next-Gen SDK:
تعديل عملية استيراد حزمة NativeAdFactory
في Android، عدِّل عبارة الاستيراد للفئة NativeAdFactory:
جافا
// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory;
// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory;
Kotlin
// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory
// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory
تعديل طرق العرض XML لتصميم عرض الإعلانات المدمجة مع المحتوى
في ملفات XML الخاصة بتصميم "الإعلانات المدمجة مع المحتوى"، عدِّل فئة عرض "الإعلانات المدمجة مع المحتوى" على النحو التالي:
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
ضبط التبعيات لكلا عمليتَي الإعداد
إذا كان مشروعك يجب أن يتوافق مع كل من Google Mobile Ads SDK (Legacy) وGMA Next-Gen SDK، يمكنك ضبط ملف android/app/build.gradle لتحديد التبعيات بشكل مشروط استنادًا إلى تعريف البيئة.
تقدّم Google Mobile Ads Flutter Plugin نموذجًا للإعدادات في ملف التطبيق النموذجي build.gradle.