بدء استخدام 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 من علامة التبويب عمليات الدمج ضمن settings > إعدادات المشروع.

الخطوة 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 في بطاقة تطبيقاتك ضمن settings > إعدادات المشروع.

الخطوة 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) لـ 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، تبدأ تلقائيًا في تسجيل أحداث وخصائص المستخدِمين من تطبيقك. ويمكنك الاطّلاع على هذه البيانات بدون إضافة أي رمز إضافي إلى تطبيقك أو تنفيذ أي إعلانات. يمكنك الاطّلاع في ما يلي على بيانات الإحصاءات هذه:

• في بطاقة مقاييس سلوك المستخدِمين ضمن حسابك على "AdMob" (الصفحة الرئيسية أو التطبيقات) لوحة التحكم)، يمكنك عرض المستخدمين مقاييس مشتقة من البيانات التحليلية التي تم جمعها، مثل متوسط مدة الجلسة متوسط الأرباح لكل مستخدم يدفع رسومًا والاحتفاظ بالبيانات.

• في الإحصاءات لوحة بيانات وحدة التحكم Firebase، يمكنك عرض إحصائيات وملخصات مجمعة المقاييس الرئيسية. إذا كنت إضافة حزمة تطوير البرامج (SDK) لمنصة Firebase للموقع الإلكتروني Google Analytics يمكنك أيضًا وضع علامات على الإحالات الناجحة للحملات الإعلانية أو إنشاء جماهير مخصّصة في وحدة تحكّم Firebase.

لاحظ أنه من أجل تمثيل متوسط الأرباح لكل مستخدم يدفع رسومًا عند قياس متوسط الأرباح لكل مستخدم يدفع رسومًا قد ترغب في تضمين بيانات من حدث مخصص في Analytics يسمى ecommerce_purchase في احتساب الأرباح لهذه المقاييس (تعرَّف على كيفية إجراء ذلك).

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

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

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

  • تنفيذ تسجيل الأحداث المخصّص في تطبيقك.

  • تحديد الإحالات الناجحة للإعلان المخصّص الحملات.

  • تضمين حدث واحد (ecommerce_purchase) بيانات الأرباح عملية حسابية متوسط الأرباح من كل مستخدم (ARPU) مقاييس ARPPU

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

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

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

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

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

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

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

  • اختبار استخدام أشكال الإعلانات الجديدة (نظرة عامة | طريقة التنفيذ).

  • تحسين معدّل تكرار الإعلانات (نظرة عامة | طريقة التنفيذ).

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

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

بانر

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

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

إعلان بيني

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

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

أصلية

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

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

تمت المكافأة

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

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