بدء استخدام 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 في بطاقة تطبيقاتك ضمن 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: عرض مقاييس سلوك المستخدمين وبيانات الإحصاءات

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

• في بطاقة مقاييس سلوك المستخدمين في حسابك على AdMob (لوحة بيانات الصفحة الرئيسية أو التطبيقات)، يمكنك الاطّلاع على مقاييس سلوك المستخدمين المنظَّمة والمستمدة من بيانات الإحصاءات التي تم جمعها، مثل متوسط مدة الجلسة ومتوسط الأرباح من كل مستخدم ومعدّل الحفاظ على المستخدمين.

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

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

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

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

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

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

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

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

  لمزيد من المعلومات، يُرجى الاطّلاع على دليل استخدام Google Analytics وFirebase مع تطبيقات AdMob.

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

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

  • تتيح لك ميزة Remote Config تغيير طريقة عمل تطبيقك ومظهره بدون الحاجة إلى نشر تحديث للتطبيق.

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

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

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

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

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

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

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

بانر

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

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

إعلان بيني

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

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

أصلية

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

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

تمت المكافأة

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

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