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

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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

استخدام "إعلانات البانر"

إعلان بيني

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

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

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

أصلية

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

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

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

تمت المكافأة

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

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

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