الوساطة

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

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

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

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

هل أنت مستخدم جديد للتوسّط؟ اقرأ مقدمة عن التوسّط.

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

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

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

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 للمكوّن الإضافي:

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" يشغّل أيضًا عملية التحديث استنادًا إلى معدّل تحديث وحدة إعلانات البانر.

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

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

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

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

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

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

اطّلِع على مزيد من المعلومات عن تفعيل المعالجة المحدودة للبيانات (RDP) والحصول على موافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من خلال حزمة تطوير البرامج (SDK) لمنصّة Google User Messaging Platform (UMP).