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

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

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

    1. سجِّل الدخول أو أنشئ حسابًا على AdMob حساب.

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

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

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

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

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

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

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

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

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

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

عرض "إعلانات بانر"

إعلان بيني

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

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

عرض "إعلانات بينية"

أصلية

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

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

عرض "الإعلانات المدمجة مع المحتوى المتقدّمة"

تمت المكافأة

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

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

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