Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

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

      يمكن أيضًا ترقية مشروعات Firebase التي تم إنشاؤها قبل 31 تموز (يوليو) 2019 إلى تجربة Google Analytics الكاملة من علامة التبويب "عمليات التكامل" . هذه الترقية اختيارية ولكن موصى بها.

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

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

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

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

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

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

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

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

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

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

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

    • تطبق ميزة التنبؤات التعلم الآلي على بيانات التحليلات الخاصة بك لإنشاء شرائح مستخدم ديناميكية بناءً على سلوك المستخدمين المتوقع. هذه التوقعات متاحة للاستخدام في منتجات Firebase الأخرى.

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

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

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

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

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

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

بيني

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

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

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

محلي

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

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

تنفيذ الإعلانات الأصلية المتقدمة

يكافأ

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

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

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