بدء استخدام AdMob في مشروع iOS

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

تعرَّف على جميع مزايا استخدام AdMob وFirebase و"إحصاءات Google" معًا إذا لم تكن قد فعلت ذلك بعد.

قبل البدء

  • إذا لم يكن لديك مشروع وتطبيق على Firebase، اتّبِع دليل البدء من Firebase: إضافة Firebase إلى مشروع iOS

  • تأكّد من تفعيل "إحصاءات Google" في مشروع Firebase:

    • إذا كنت بصدد إنشاء مشروع جديد على Firebase، فعِّل "إحصاءات Google" أثناء سير عمل إنشاء المشروع.

    • إذا كان لديك مشروع حالي على Firebase لم يتم تفعيل "إحصاءات Google" عليه، يمكنك تفعيل "إحصاءات Google" من علامة تبويب عمليات الدمج ضمن > إعدادات المشروع.

الخطوة 1: إعداد تطبيقك في حسابك على AdMob

  1. سجِّل تطبيقك كتطبيق AdMob.

    1. سجّل الدخول أو اشترِك للحصول على حساب AdMob.

    2. سجِّل تطبيقك في AdMob. تؤدي هذه الخطوة إلى إنشاء تطبيق AdMob باستخدام رقم تعريف تطبيق AdMob فريد ستحتاج إليه لاحقًا في هذا الدليل.

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

  2. اربط تطبيقك على AdMob بتطبيقك على Firebase.

    هذه الخطوة اختيارية، ولكننا ننصح بذلك بشدة. اطّلِع على مزيد من المعلومات عن فوائد تفعيل مقاييس سلوك المستخدِمين وربط تطبيق AdMob بمنصّة Firebase.

    أكمِل الخطوتَين التاليتَين في لوحة بيانات التطبيقات لحسابك على AdMob:

    1. فعِّل مقاييس سلوك المستخدمين للسماح لـ AdMob بمعالجة بيانات الإحصاءات المنظّمة وعرضها في حسابك على AdMob. وهو أيضًا إعداد مطلوب لربط تطبيق AdMob بـ Firebase.

    2. اربط تطبيق AdMob بمشروعك الحالي في Firebase وتطبيق Firebase.

      تأكَّد من إدخال معرّف الحزمة نفسه الذي أدخلته لتطبيق Firebase. ابحث عن معرّف حزمة تطبيق Firebase في بطاقة تطبيقاتك في > إعدادات المشروع.

الخطوة 2: إضافة رقم تعريف تطبيق AdMob إلى ملف Info.plist

في ملف Info.plist لتطبيقك، أضِف مفتاح GADApplicationIdentifier مع سلسلة قيمة من رقم تعريف تطبيق AdMob.

يمكنك إجراء هذا التغيير آليًا:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

أو عدِّله في محرِّر قائمة المواقع:

محرر قائمة المواقع

الخطوة 3: إضافة حزمة SDK لإعلانات الأجهزة الجوّالة وإعدادها

  1. أضِف التبعية لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة إلى ملف Podfile الخاص بمشروعك:

    pod 'Google-Mobile-Ads-SDK'

  2. قبل تحميل الإعلانات، عليك استدعاء طريقة startWithCompletionHandler: على GADMobileAds.sharedInstance.

    يؤدي هذا الاستدعاء إلى إعداد حزمة SDK واستدعاء معالج الإكمال عند اكتمال عملية الإعداد (أو بعد انتهاء مهلة 30 ثانية). وعليك باستدعاء هذه الطريقة مرة واحدة وفي أقرب وقت ممكن: عند إطلاق التطبيق ولكن بعد إعداد Firebase.

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

    Swift

    import Firebase
import GoogleMobileAds
...

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

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

    // Use Firebase library to configure APIs.
    FirebaseApp.configure()

    // Initialize the Google Mobile Ads SDK.
    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }

}

    Objective-C

    @import Firebase;
@import GoogleMobileAds;
...

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Use Firebase library to configure APIs.
  [FIRApp configure];
  // Initialize the Google Mobile Ads SDK.
  [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
  return YES;
}

@end

الخطوة 4: عرض مقاييس سلوك المستخدمين وبيانات الإحصاءات

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

تجدر الإشارة إلى أنّه لتمثيل مقياسَي ARPU وARPPU بشكل أفضل، ننصحك بتضمين بيانات من حدث مخصّص في "إحصاءات Google" يُعرف باسم ecommerce_purchase في احتساب الأرباح لهذه المقاييس (التعرّف على كيفية إجراء ذلك).

الخطوة 5: (اختياري) استخدام المزيد من ميزات "إحصاءات Google" وFirebase

استفد من المزيد من الفرص والميزات لتحسين تحقيق الربح من التطبيق وتفاعل المستخدمين:

  • إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase واستخدامها لخدمة "إحصاءات Google"

    لمعرفة المزيد من المعلومات، انتقِل إلى دليل استخدام "إحصاءات Google" وFirebase مع تطبيقات AdMob.

  • استخدام منتجات Firebase الأخرى في تطبيقك

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

    • تمكِّنك ميزة الإعداد عن بُعد من تغيير سلوك تطبيقك ومظهره بدون نشر تحديث للتطبيق، وذلك بدون أي تكلفة، وذلك لعدد غير محدود من المستخدمين النشطين يوميًا.

    • من خلال اختبار A/B، يمكنك اختبار التغييرات في واجهة المستخدم أو الميزات أو حملات التفاعل مع تطبيقك لمعرفة ما إذا كانت تؤثر في المقاييس الرئيسية (مثل الأرباح والاحتفاظ بالمستخدمين) قبل طرحها على نطاق واسع.

  • تحسين تحقيق الربح من الإعلانات لتطبيقك

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

الخطوة 6: اختيار شكل إعلان لتنفيذه في تطبيقك

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

إعلانات مستطيلة تظهر في أعلى شاشة الجهاز أو أسفلها

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

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

إعلان بيني

إعلانات ملء الشاشة التي تغطي واجهة التطبيق إلى أن يغلقها المستخدم

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

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

أصلية

إعلانات قابلة للتخصيص تتطابق مع شكل تطبيقك ومضمونه

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

تنفيذ الإعلانات المدمجة مع المحتوى (المتقدّمة)

تمت المكافأة

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

يمكن أن تساعد الإعلانات التي تضم مكافأة (أو "قائمة على المكافآت") في تحقيق ربح من مستخدمي الألعاب المجانية.

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