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

يوضّح لك هذا الدليل كيفية دمج محوّل توسّط مع تطبيق 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(),
    );

استخدام "إعلانات البانر" مع ميزة التوسّط

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

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

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

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

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

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

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

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