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

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

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

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

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

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

لتقديم عروض الأسعار: Google Mobile Ads SDK الإصدار 7.53.1 أو إصدار أحدث

إعداد Google Mobile Ads SDK

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

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

Swift

MobileAds.shared.start { initializationStatus in
  // Check each adapter's initialization status.
  for (adapterName, status) in initializationStatus.adapterStatusesByClassName {
    print(
      "Adapter: \(adapterName), Description: \(status.description), Latency: \(status.latency)")
  }
}

Objective-C

[[GADMobileAds sharedInstance]
    startWithCompletionHandler:^(GADInitializationStatus *_Nonnull status) {
      // Check each adapter's initialization status.
      NSDictionary<NSString *, GADAdapterStatus *> *adapterStatuses =
          status.adapterStatusesByClassName;
      for (NSString *adapterName in adapterStatuses) {
        GADAdapterStatus *adapterStatus = adapterStatuses[adapterName];
        NSLog(@"Adapter: %@, Description: %@, Latency: %f", adapterName,
              adapterStatus.description, adapterStatus.latency);
      }
    }];

معرفة شبكة الإعلانات الفائزة

تحتوي كل فئة من فئات أشكال الإعلانات على سمة GADResponseInfo تتضمّن adNetworkClassName التي تعرض اسم فئة شبكة الإعلانات للإعلان الحالي. لا تظهر قيمة adNetworkClassName إلا بعد تحميل الإعلان بنجاح. يوضّح لك الرمز التالي كيفية الحصول على هذه المعلومات لإعلانات البانر.

Swift

print(
  "Adapter class name: \(ad.responseInfo?.loadedAdNetworkResponseInfo?.adNetworkClassName ?? "Unknown")"
)

Objective-C

NSLog(@"Adapter class name: %@",
      ad.responseInfo.loadedAdNetworkResponseInfo.adNetworkClassName ?: @"Unknown");

يُرجى الرجوع إلى مقالة استرداد معلومات عن استجابة الإعلان لمزيد من التفاصيل.

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

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

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

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

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

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

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

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