الوساطة

يوضّح لك هذا الدليل كيفية دمج محوِّل التوسّط مع تطبيق Flutter.

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

قبل أن تتمكّن من دمج التوسّط لشكل إعلان معيّن، عليك دمج شكل الإعلان هذا في تطبيقك:

• إعلانات البانر
• الإعلانات البينية
• الإعلانات المدمجة مع المحتوى
• الإعلانات التي تضم مكافأة
• الإعلانات البينية التي تضمّ مكافأة

هل أنت حديث العهد بالتوسّط؟ يُرجى الاطّلاع على مقدّمة عن التوسّط.

إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة

يوضّح لك دليل البدء السريع كيفية إعداد حزمة SDK لإعلانات Google على الأجهزة الجوّالة. وخلال هذه المكالمة، يتم أيضًا إعداد محوِّلات التوسّط. من المهم الانتظار حتى تكتمل عملية الإعداد قبل loadingتحميل الإعلانات لضمان المشاركة الكاملة من كل شبكة إعلانات في طلب الإعلان الأول.

يوضّح الرمز البرمجي النموذجي التالي كيفية التحقّق من حالة بدء كل محوِّل قبل تقديم طلب إعلان.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

تعديل إعدادات Gradle (على أجهزة Android فقط)

أضِف الأسطر التالية إلى ملف settings.gradle حتى تتمكّن من استخدام واجهتَي برمجة التطبيقات Android API الخاصة بالإضافة:

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

إضافة التبعيات لشبكات الشركاء

يجب إضافة محوِّلات التوسّط وتبعياتها إلى مشاريع Android وiOS. ويمكن إضافتها من خلال تعديل ملف build.gradle على مستوى التطبيق في نظام التشغيل Android وملف Podfile على نظام التشغيل iOS. توفّر Google محوّلات مفتوحة المصدر في GitHub لنظامَي التشغيل Android وiOS.

اطّلِع على مستندات Android و iOS لكل شبكة من شبكات الشركاء للحصول على إرشادات مفصّلة حول كيفية إضافة محوِّل كل شبكة إلى تطبيقك.

التحقّق من فئة محوِّل شبكة الإعلانات التي حمّلت الإعلان

يوضّح الرمز البرمجي النموذجي التالي كيفية تسجيل اسم فئة شبكة الإعلانات ل إعلان بانر:

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

استخدام إعلانات البانر مع التوسّط

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

استخدام الإعلانات المدمجة مع المحتوى مع التوسّط

في ما يلي بعض أفضل الممارسات التي يجب أخذها في الاعتبار عند تنفيذ التوسّط المضمّن.

سياسة عرض الإعلانات المدمجة مع المحتوى

لكل شبكة إعلانات سياساتها الخاصة. عند استخدام التوسّط، من المهم remembered أنّ تطبيقك لا يزال بحاجة إلى الالتزام بسياسات الشبكة التي تم التوسّط بينها والتي قدّمت الإعلان.

قوانين الخصوصية في الولايات الأمريكية و"اللائحة العامّة لحماية البيانات"

إذا كنت بحاجة إلى الامتثال لمَثَل قوانين الخصوصية في الولايات الأمريكية أو اللائحة العامة لحماية البيانات (GDPR)، اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية في الولايات الأمريكية أو إعدادات اللائحة العامة لحماية البيانات لإضافة شركاء التوسّط في صفحة "الخصوصية والمراسلة" ضمن "مدير إعلانات Google" في الولايات الأمريكية أو قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات". وقد يؤدي عدم إجراء ذلك إلى عدم تمكّن الشركاء من عرض الإعلانات على تطبيقك.