إعداد ميزة "توسّط AdMob"

اختيار المنصة: Android

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

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

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

هل أنت مستخدم جديد لميزة التوسّط؟ يمكنك قراءة مقالة نظرة عامة حول "توسّط AdMob".

تهيئة Google Mobile Ads Flutter Plugin

يوضّح لك دليل البدء السريع كيفية تهيئة 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 = BannerAd(
      size: AdSize.banner,
      adUnitId: '<your-ad-unit>',
      listener: BannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdRequest(),
    );

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

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

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

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

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

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

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

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