شروع کار با 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 SDK

  1. وابستگی Google Mobile Ads SDK را به 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 را ببینید:

توجه داشته باشید که برای نمایش بهتر سنجه‌های ARPU و ARPPU، ممکن است بخواهید داده‌های رویداد سفارشی 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، روی دکمه قالب آگهی کلیک کنید.

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

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

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

بینابینی

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

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

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

بومی

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

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

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

پاداش‌داده‌شده

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

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

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