البدء

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

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

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