للاستفادة من تحسينات وقت الاستجابة والثبات في 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
ضبط إعدادات Gradle لنظام Android
لاستخدام 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
إذا كنت تشغّل تطبيقك باستخدام بيئة تطوير متكاملة (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 النموذجي.