شروع کار با 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 را از برگه ادغام‌ها در > تنظیمات پروژه فعال کنید.

مرحله ۱: راه‌اندازی برنامه در حساب AdMob

  1. برنامه‌تان را به‌عنوان برنامه AdMob ثبت کنید.

    1. به سیستم حساب AdMob وارد شوید یا برای آن ثبت‌نام کنید.

    2. برنامه‌تان را در AdMob ثبت کنید. این مرحله یک برنامه AdMob با AdMob شناسه برنامه یکتا ایجاد می‌کند که بعداً در این راهنما به آن نیاز خواهید داشت.

    از شما خواسته می‌شود کیت توسعه نرم‌افزار Mobile Ads را به برنامه‌تان اضافه کنید. دستورالعمل‌های دقیق برای این کار را در ادامه این راهنما پیدا کنید.

  2. برنامه AdMob را به برنامه Firebase پیوند دهید.

    این مرحله اختیاری است ولی قویاً توصیه می‌شود. درباره مزایای فعال کردن سنجه‌های کاربر و پیوند دادن برنامه AdMob به Firebase بیشتر بدانید.

    دو مرحله زیر را در داشبورد برنامه‌ها در حساب AdMob خود تکمیل کنید:

    1. فعال کردن سنجه‌های کاربر برای اینکه AdMob بتواند داده‌های تحلیلی گلچین‌شده را در حساب AdMob شما پردازش و نمایش دهد. همچنین این تنظیم برای پیوند دادن برنامه AdMob به Firebase الزامی است.

    2. برنامه AdMob خود را به پروژه Firebase و برنامه Firebase موجودتان پیوند دهید.

      مطمئن شوید همان شناسه دسته نرم‌افزاری را وارد می‌کنید که برای برنامه Firebase وارد کرده‌اید. شناسه دسته نرم‌افزاری برنامه Firebase را در کارت برنامه‌های شما در > تنظیمات پروژه پیدا کنید.

مرحله ۲: AdMob شناسه برنامه را به فایل Info.plist اضافه کنید

در فایل Info.plist برنامه‌تان، کلید GADApplicationIdentifier را با مقدار رشته‌ای AdMob شناسه برنامه خودتان اضافه کنید.

می‌توانید این تغییر را به‌صورت برنامه‌نویسی‌شده انجام دهید:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

یا آن را در ویرایشگر فهرست خصوصیت ویرایش کنید:

ویرایشگر فهرست خصوصیت

مرحله ۳: افزودن و مقداردهی اولیه کیت توسعه نرم‌افزار Mobile Ads

  1. وابستگی کیت توسعه نرم‌افزار Google Mobile Ads را به Podfile پروژه‌تان اضافه کنید:

    pod 'Google-Mobile-Ads-SDK'
    
  2. قبل‌از بار کردن آگهی‌ها، روش startWithCompletionHandler: را در GADMobileAds.sharedInstance فراخوانی کنید.

    این فراخوانی کیت توسعه نرم‌افزار را مقداردهی اولیه می‌کند و پس‌از تکمیل مقداردهی اولیه (یا پس‌از وقفه ۳۰ ثانیه‌ای)، یک گرداننده تکمیل را فراخوانی می‌کند. این روش را فقط یک‌بار و در اولین فرصت ممکن، ترجیحاً هنگام راه‌اندازی برنامه اما پس‌از مقداردهی اولیه 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
    

مرحله ۴: مشاهده سنجه‌های کاربر و داده‌های تجزیه‌وتحلیل

پس‌از مقداردهی اولیه، کیت توسعه نرم‌افزار Mobile Ads به‌طور خودکار شروع به ثبت رویدادهای تحلیلی و ویژگی‌های کاربر از برنامه شما می‌کند. می‌توانید این داده‌ها را بدون افزودن کد اضافی به برنامه خود یا پیاده‌سازی هیچ آگهی‌ای مشاهده کنید. در اینجا می‌توانید این داده‌های تجزیه‌وتحلیل را ببینید:

توجه داشته باشید که برای نمایش بهتر سنجه‌های میانگین درآمد به‌ازای هر کاربر و میانگین درآمد به‌ازای هر کاربر پرداخت‌کننده، شاید بخواهید داده‌های رویداد سفارشی Analytics به‌نام ecommerce_purchase را در محاسبه درآمد برای این سنجه‌ها لحاظ کنید (با نحوه انجام این کار آشنا شوید).

مرحله ۵: (اختیاری) استفاده از ویژگی‌های بیشتر Google Analytics و Firebase

از فرصت‌ها و ویژگی‌های بیشتری برای بهبود درآمدزایی برنامه و تعامل کاربر بهره ببرید:

  • افزودن و استفاده از کیت توسعه نرم‌افزار Firebase برای Google Analytics

    برای کسب اطلاعات بیشتر، به راهنمای استفاده از Google Analytics و Firebase با برنامه‌های AdMob مراجعه کنید.

  • استفاده از دیگر محصولات Firebase در برنامه

    پس‌از افزودن کیت توسعه نرم‌افزار Firebase برای Google Analytics، از دیگر محصولات Firebase برای بهینه‌سازی آگهی‌ها در برنامه‌تان استفاده کنید.

    • Remote Config به شما امکان می‌دهد رفتار و ظاهر برنامه‌تان را بدون انتشار به‌روزرسانی برنامه تغییر دهید.

    • A/B Testing به شما امکان می‌دهد تغییرات واسط کاربر، ویژگی‌ها، یا پویش‌های تعامل برنامه‌تان را آزمایش کنید تا قبل‌از عرضه گسترده تغییرات، متوجه شوید که آیا بر سنجه‌های کلیدی شما (مانند درآمد و حفظ کاربر) تأثیر می‌گذارند یا نه.

  • بهینه‌سازی درآمدزایی از آگهی برای برنامه‌تان

    قالب‌ها یا پیکربندی‌های مختلف آگهی را با زیرمجموعه کوچکی از کاربران امتحان کنید، و سپس براساس داده‌ها درباره پیاده‌سازی آگهی برای همه کاربرانتان تصمیم بگیرید. برای کسب اطلاعات بیشتر، آموزش‌های زیر را بررسی کنید:

مرحله ۶: قالب آگهی را برای پیاده‌سازی در برنامه‌تان انتخاب کنید

AdMob چندین قالب آگهی مختلف ارائه می‌دهد تا بتوانید قالبی را انتخاب کنید که بهترین تناسب را با تجربه کاربری برنامه‌تان دارد. برای مشاهده دستورالعمل‌های دقیق پیاده‌سازی در اسناد AdMob، روی دکمه قالب آگهی کلیک کنید.

آگهی‌های مستطیلی که در بالا یا پایین صفحه‌نمایش دستگاه ظاهر می‌شوند

آگهی‌های برنمایی درحالی‌که کاربران با برنامه تعامل دارند روی صفحه می‌مانند و می‌توانند پس‌از مدت زمان مشخصی به‌طور خودکار بازآوری شوند. اگر در تبلیغات تلفن همراه تازه‌کار هستید، این مکان برای شروع عالی است.

پیاده‌سازی آگهی‌های برنمایی

بینابینی

آگهی‌های تمام‌صفحه که واسط برنامه را می‌پوشانند تا زمانی‌که کاربر آن‌ها را ببندد

بهترین زمان استفاده از آگهی‌های بینابینی در وقفه‌های طبیعی در جریان اجرای برنامه است، مثلاً بین مراحل بازی یا درست پس‌از تکمیل یک تکلیف.

پیاده‌سازی آگهی‌های بینابینی

بومی

آگهی‌های سفارشی‌سازی‌شدنی که با ظاهر و باطن برنامه‌تان مطابقت دارد

آگهی‌های بومی قالب آگهی مؤلفه‌محور هستند. شما تصمیم می‌گیرید که آگهی‌های بومی چگونه و کجا قرار داده شوند تا چیدمان با طراحی برنامه‌تان سازگارتر باشد. با انتخاب قلم‌ها، رنگ‌ها، و جزئیات دیگر برای خودتان، می‌توانید ارائه‌های آگهی طبیعی و غیرمزاحمی ایجاد کنید که می‌تواند به تجربه کاربری غنی اضافه کند.

پیاده‌سازی آگهی‌های پیشرفته بومی

پاداش‌دار

آگهی‌هایی که به کاربران برای تماشای ویدیوهای کوتاه و تعامل با آگهی‌ها و نظرسنجی‌های قابل‌بازی پاداش می‌دهند

آگهی‌های پاداش‌دار (یا «مبتنی بر پاداش») می‌توانند به درآمدزایی از کاربران بازی‌های رایگان کمک کنند.

پیاده‌سازی آگهی‌های پاداش‌دار پیاده‌سازی آگهی‌های پاداش‌دار (میاناهای برنامه‌سازی کاربردی جدید)