الوساطة

يوضِّح لك هذا الدليل كيفية دمج محوّل توسّط مع تطبيق 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" يؤدي أيضًا إلى إعادة التحميل بناءً على معدل تحديث وحدة إعلانات البانر.

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

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

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

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

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

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

مزيد من المعلومات عن تفعيل المعالجة المحدودة للبيانات (RDP) والحصول على "اللائحة العامة لحماية البيانات" الموافقة مع منصة Google User Messaging Platform (UMP) حزمة SDK: