إعداد التوسّط

اختيار النظام الأساسي: Android iOS Unity Flutter Android (الإصدار القديم)

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

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

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

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

إعداد Google Mobile Ads Flutter Plugin

يوضّح لك دليل البدء السريع كيفية تهيئة Google Mobile Ads Flutter Plugin. أثناء مكالمة الإعداد هذه، يتم أيضًا إعداد وسيطاء التوسّط. من المهم الانتظار إلى أن يكتمل الإعداد قبل تحميل الإعلانات، وذلك للتأكّد من مشاركة جميع شبكات الإعلانات بشكل كامل في طلب عرض الإعلان الأول.

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

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 flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

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

يجب إضافة محوّلات التوسّط والتبعيات إلى مشاريع 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(),
    );

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

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

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

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

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

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

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

التالي
اختيار مصادر الإعلانات