تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

البدء

هذا الدليل مخصّص للناشرين الذين يريدون تحقيق الربح من تطبيق iOS باستخدام AdMob ولا يستخدمون Firebase. إذا كنت تخطط لتضمين Firebase في تطبيقك (أو تدرس ذلك)، اطّلِع على إصدار AdMob مع Firebase من هذا الدليل.

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

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

استخدام Xcode 14.1 أو إصدار أحدث
الإصدار 11.0 أو الإصدارات الأحدث من iOS

إجراء مقترَح: إنشاء حساب على AdMob وتسجيل تطبيق

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

حلقات CocoaPods (الخيار المفضّل)

إنّ أبسط طريقة لاستيراد حزمة تطوير البرامج (SDK) إلى مشروع على نظام التشغيل iOS هي استخدام CocoaPods. افتح ملف Podfile الخاص بمشروعك وأضِف هذا السطر إلى الهدف الخاص بالتطبيق:

pod 'Google-Mobile-Ads-SDK'

بعد ذلك، شغِّل الأمر من خلال سطر الأوامر:

pod install --repo-update

إذا كنت مستخدمًا جديدًا في CocoaPods، يمكنك الاطّلاع على المستندات الرسمية للحصول على معلومات حول كيفية إنشاء ملفات Podfiles واستخدامها.

مدير حزمة Swift

تتوافق حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة مع مدير حزمة Swift بدءًا من الإصدار 9.0.0. اتّبِع الخطوات أدناه لاستيراد حزمة Swift.

في Xcode، يجب تثبيت حزمة Swift لإعلانات Google على الأجهزة الجوّالة من خلال الانتقال إلى ملف > إضافة حِزم....
في الإشعار الذي يظهر، ابحث عن مستودع حزمة Mobile Swift من GitHub
```
https://github.com/googleads/swift-package-manager-google-mobile-ads.git
```
اختَر إصدار حزمة إعلانات Google للأجهزة الجوّالة التي تريد استخدامها. بالنسبة إلى المشاريع الجديدة، ننصح باستخدام ما يصل إلى الإصدار الرئيسي التالي.

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

التنزيل يدويًا

يمكنك تنزيل إطار عمل حزمة تطوير البرامج (SDK) وفك ضغطه مباشرةً، واستيراد أُطر العمل التالية إلى مشروع Xcode:
- GoogleAppMeasurement.xcframework
- GoogleAppMeasurementIdentitySupport.xcframework
- GoogleMobileAds.xcframework
- GoogleUtilities.xcframework
- nanopb.xcframework
- PromisesObjC.xcframework
- UserMessagingPlatform.xcframework
أضف علامة رابط -ObjC إلى علامات رابط أخرى في إعدادات إنشاء مشروعك:

تعديل Info.plist

يجب تعديل ملف Info.plist لتطبيقك لإضافة مفتاحَين:

مفتاح GADApplicationIdentifier مع قيمة سلسلة AdMob app ID found in the AdMob UI.
مفتاح SKAdNetworkItems يتضمّن قيمًا تبلغ SKAdNetworkIdentifier لشركة Google (cstr6suwn9.skadnetwork) واختيار مشترين من جهات خارجية قدّموا هذه القيم إلى Google

إكمال المقتطف

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4pfyvq9l8r.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>5a6flpkh64.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n6fk4nfna4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>eh6m2bh4zr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ecpz2srf59.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>pwa73g5rt2.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>zq492l623r.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

في حال عدم إنشاء حساب على AdMob وتسجيل تطبيق بعد، هذا هو الوقت المناسب لإجراء ذلك.

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

قبل تحميل الإعلانات، يجب طلب الطريقة startWithCompletionHandler: على GADMobileAds.sharedInstance، والتي تعمل على إعداد حزمة تطوير البرامج (SDK) واستدعاء معالج الاكتمال بعد اكتمال الإعداد (أو بعد انتهاء المهلة التي تبلغ 30 ثانية). يجب تنفيذ هذا الإجراء مرة واحدة فقط، ويُفضَّل عند إطلاق التطبيق. يجب الاتصال بالرقم startWithCompletionHandler: في أقرب وقت ممكن.

تحذير: قد يتم تحميل الإعلانات مُسبقًا بواسطة حزمة تطوير البرامج (SDK) للإعلانات على الأجهزة الجوّالة أو حِزم تطوير البرامج (SDK) لشركاء التوسّط عند طلب startWithCompletionHandler:. وإذا كنت بحاجة إلى الحصول على موافقة من المستخدمين في المنطقة الاقتصادية الأوروبية، عليك ضبط أي علامات متعلّقة بالطلب (مثل tagForChildDirectedTreatment أو tag_for_under_age_of_consent) أو اتخاذ إجراء آخر قبل تحميل الإعلانات، تأكّد من إجراء ذلك قبل إعداد حزمة تطوير البرامج (SDK) للإعلانات على الأجهزة الجوّالة.

إليك مثال على كيفية استدعاء طريقة startWithCompletionHandler: في AppDelegate:

مثال على AppApp.m (مقتطف)

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }

}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

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

  [GADMobileAds.sharedInstance startWithCompletionHandler:nil];
  return YES;
}

@end

وإذا كنت تستخدم ميزة التوسّط، قد تحتاج إلى الانتظار حتى يتم استدعاء معالج الإكمال قبل تحميل الإعلانات، لأن ذلك سيضمن إعداد جميع محوّلات التوسط.

اختيار شكل الإعلان

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

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

تنفيذ إعلان بانر

إعلان بيني

الإعلانات بملء الشاشة التي تغطي واجهة تطبيق إلى أن يغلقها المستخدم وتُستخدم هذه التطبيقات على أفضل نحو في فترات الإيقاف المؤقت أثناء تنفيذ التطبيق، مثل الانتقال بين مستويات اللعبة أو بعد اكتمال المهمة.

تنفيذ إعلان بيني

مدمجة مع المحتوى

إعلانات قابلة للتخصيص تناسب مظهر تطبيقك ومضمونه، وعليك اختيار كيفية وضعها ومكانها، بحيث يصبح التنسيق أكثر اتساقًا مع تصميم تطبيقك.

التنفيذ Native Ads

تم منح المكافأة

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

تنفيذ الإعلانات بمكافأة

تنفيذ الإعلانات بمكافأة (واجهات برمجة التطبيقات الجديدة)