ابدأ استخدام AdMob في مشروعك الذي يعمل بنظام التشغيل iOS

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

إذا لم تكن قد فعلت ذلك بعد، فتعرف على جميع فوائد استخدام AdMob وFirebase وGoogle Analytics معًا.

قبل ان تبدأ

• إذا لم يكن لديك بالفعل مشروع Firebase وتطبيق 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 لإعلانات الجوال إلى تطبيقك. يمكنك العثور على تعليمات مفصلة لهذه المهمة لاحقًا في هذا الدليل.

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. أضف تبعية Google Mobile Ads SDK إلى ملف Podfile الخاص بمشروعك:

   pod 'Google-Mobile-Ads-SDK'
   

2. قبل تحميل الإعلانات، قم باستدعاء الأسلوب startWithCompletionHandler: على GADMobileAds.sharedInstance .

   يقوم هذا الاستدعاء بتهيئة SDK واستدعاء معالج الإكمال بمجرد اكتمال التهيئة (أو بعد مهلة 30 ثانية). قم باستدعاء هذه الطريقة مرة واحدة فقط وفي أقرب وقت ممكن، ويفضل أن يكون ذلك عند تشغيل التطبيق ولكن بعد تهيئة Firebase.

   فيما يلي مثال لكيفية استدعاء الأسلوب startWithCompletionHandler: في AppDelegate الخاص بك:

   سويفت

   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
     }
   
   }
   

   ج موضوعية

   @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 ، والاحتفاظ.

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

لاحظ أنه لتمثيل مقاييس ARPU و ARPPU بشكل أفضل، قد ترغب في تضمين بيانات من حدث تحليلي مخصص يسمى ecommerce_purchase في حساب الإيرادات لهذه المقاييس ( تعرف على كيفية القيام بذلك ).

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

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

• قم بإضافة واستخدام Firebase SDK لبرنامج Google Analytics

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

  • وضع علامة على التحويلات للحملات الإعلانية المخصصة .

  • قم بتضمين بيانات حدث ecommerce_purchase في حساب الإيرادات لمقاييس ARPU و ARPPU .

  لمعرفة المزيد، تفضل بزيارة دليل استخدام Google Analytics وFirebase مع تطبيقات AdMob .

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

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

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

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

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

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

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

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

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

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

راية

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

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