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

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

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

قبل البدء

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

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

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

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

الخطوة 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 في بطاقة تطبيقاتك من 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 لإعلانات الأجهزة الجوّالة وإعدادها

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بانر

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

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

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

إعلان بيني

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

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

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

أصلية

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

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

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

تمت المكافأة

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

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

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

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