البدء

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

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

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

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

لتقديم عروض الأسعار: الإصدار 7.53.1 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

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

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

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    MobileAds.shared.start { status in
      // Optional: Log each adapter's initialization latency.
      let adapterStatuses = status.adapterStatusesByClassName
      for adapter in adapterStatuses {
        let adapterStatus = adapter.value
        NSLog("Adapter Name: %@, Description: %@, Latency: %f", adapter.key,
        adapterStatus.description, adapterStatus.latency)
      }

      // Start loading ads here...
    }

    return true
  }

}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

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

    // Start loading ads here...
  }];
  return YES;
}

@end

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

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

Swift

func adViewDidReceiveAd(_ bannerView: AdManagerBannerView) {
  print("Banner adapter class name: \(bannerView.responseInfo.adNetworkClassName)")
}

Objective-C

- (void)adViewDidReceiveAd:(GAMBannerView *)bannerView {
  NSLog(@"Banner adapter class name: %@", bannerView.responseInfo.adNetworkClassName);
}

راجِع استرداد معلومات عن استجابة الإعلان للحصول على التفاصيل.

استخدام إعلانات البانر مع التوسّط

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

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

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

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

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

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

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

التالي
اختيار الشبكات