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

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

تعرَّف على كل مزايا استخدام AdMob وFirebase وGoogle Analytics معًا إذا لم يسبق لك ذلك.

قبل البدء

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

  • تأكَّد من تفعيل Google Analytics في مشروعك على Firebase:

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

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

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

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

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

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

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

  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: إضافة حزمة تطوير البرامج Mobile Ads وإعدادها

  1. أضِف التبعية لحزمة تطوير البرامج (SDK) لنظام التشغيل Google Mobile Ads إلىملف 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: عرض مقاييس سلوك المستخدمين وبيانات الإحصاءات

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

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

الخطوة 5: (اختياري) استخدام المزيد من ميزات Google Analytics وFirebase

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

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

    لمزيد من المعلومات، انتقِل إلى دليل استخدام Google Analytics وFirebase مع تطبيقات AdMob.

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

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

    • يتيح لك Remote Config تغيير سلوك تطبيقك وشكله بدون نشر تحديث له، وذلك بدون أي تكلفة للمستخدمين النشطين يوميًا غير المحدودين.

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

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

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

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

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

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

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

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

إعلان بيني

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

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

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

أصلية

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

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

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

تمت المكافأة

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

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

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