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

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

لعرض الإعلانات وتحقيق الأرباح، عليك دمج Google Mobile Ads SDK في تطبيق iOS. ولتجهيز مشروعك، عليك استيراد Google Mobile Ads SDK وتهيئة إعداداته قبل طلب الإعلانات.

إذا كنت تستخدم Firebase في تطبيقك على iOS، اطّلِع على بدء استخدام AdMob في مشروعك على iOS.

يتناول هذا الدليل عملية استيراد Google Mobile Ads SDK وتهيئته واختيار شكل إعلان.

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

قبل المتابعة، تأكَّد من توفّر ما يلي:

  • استخدِم الإصدار 16.0 من Xcode أو إصدارًا أحدث.
  • استهداف الإصدار 13.0 من نظام التشغيل iOS أو الإصدارات الأحدث

استيراد Google Mobile Ads SDK

لاستيراد Google Mobile Ads SDK، أكمِل أحد الأقسام التالية:

‫Swift Package Manager (يُنصح بها)

لإضافة تبعية حزمة إلى مشروعك، اتّبِع الخطوات التالية:

  1. افتح Xcode.
  2. انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة... (File > Add Package Dependencies...).
  3. ثبِّت حزمة Google Mobile Ads SDK Swift.

  4. في الطلب الذي يظهر، ابحث عن مستودع Google Mobile Ads Swift Package GitHub:

    https://github.com/googleads/swift-package-manager-google-mobile-ads.git
    
  5. اختَر إصدار Google Mobile Ads SDK Swift Package الذي تريد استخدامه. بالنسبة إلى المشاريع الجديدة، ننصحك باستخدام حتى الإصدار الرئيسي التالي.

CocoaPods

لاستخدام CocoaPods، اتّبِع الخطوات التالية:

  1. افتح Podfile الخاص بمشروعك وأضِف هذا السطر إلى target إصدار تطبيقك:

    pod 'Google-Mobile-Ads-SDK'
    
  2. في الوحدة الطرفية، شغِّل الأمر التالي:

    pod install --repo-update

ضبط هدف النشر في Xcode 27

يتطلّب Xcode 27 حدًا أدنى من هدف النشر وهو iOS 15.0 لجميع الأهداف. بما أنّ Google Mobile Ads SDK يتوافق مع الإصدار 13.0 من نظام التشغيل iOS، يتعذّر إنشاء الإصدار 27 من Xcode عند استخدام CocoaPods.

لحلّ هذه المشكلة، يُرجى اتّباع الخطوات التالية:

  1. افتح ملف Podfile الخاص بمشروعك وأضِف خطاف post_install يضبط الإصدار المستهدف على 15.0. إذا كان لديك حلقة post_install، أضِف الحلقة الداخلية إلى الحلقة الحالية.

    يضبط المثال التالي المفتاح IPHONEOS_DEPLOYMENT_TARGET على 15.0 لجميع استهدافات الحزمة:

    post_install do |installer|
      installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config