البدء

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

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

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

• إعلانات البانر
• الإعلانات البينية
• الإعلانات المدمجة مع المحتوى
• الإعلانات التي تضم مكافأة
• الإعلانات البينية بمكافأة

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

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

إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة

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

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

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

    let ads = GADMobileAds.sharedInstance()
    ads.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
  }

}

@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 سوى عند تحميل الإعلان بنجاح. يوضح الرمز التالي كيفية الحصول على هذه المعلومات لإعلانات البانر.

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

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

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

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

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

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

في ما يلي بعض أفضل الممارسات التي يجب مراعاتها عند تنفيذ التوسط الأصلي.

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

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

تجنُّب استخدام فئة GADMultipleAdsAdLoaderOptions عند تقديم الطلبات

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

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

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