با Google Analytics شروع کنید


این آموزش سریع به شما نشان می‌دهد که چگونه Google Analytics به برنامه خود اضافه کنید و شروع به ثبت رویدادها کنید.

Google Analytics داده‌های مربوط به استفاده و رفتار برنامه شما را جمع‌آوری می‌کند. SDK دو نوع اطلاعات اصلی را ثبت می‌کند:

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

Analytics به طور خودکار برخی رویدادها و ویژگی‌های کاربر را ثبت می‌کند؛ برای فعال کردن آنها نیازی به اضافه کردن هیچ کدی ندارید.

قبل از اینکه شروع کنی

  1. اگر قبلاً این کار را نکرده‌اید، Firebase را به پروژه اپل خود اضافه کنید و مطمئن شوید که Google Analytics در پروژه Firebase شما فعال است:

    • اگر در حال ایجاد یک پروژه جدید Firebase هستید، در طول فرآیند ایجاد پروژه، Google Analytics فعال کنید.

    • اگر از یک پروژه Firebase موجود استفاده می‌کنید که Google Analytics در آن فعال نیست، به برگه Integrations در پروژه خود بروید. برای فعال کردن آن، > تنظیمات پروژه بروید.

    وقتی Google Analytics در پروژه خود فعال می‌کنید، برنامه‌های Firebase شما به جریان‌های داده Google Analytics متصل می‌شوند.

  2. (توصیه می‌شود) . چارچوب AdSupport را به پروژه خود اضافه کنید تا ویژگی‌های اضافی مانند مخاطبان و انتساب کمپین را فعال کنید.

کیت توسعه نرم‌افزار (SDK) Analytics را به برنامه خود اضافه کنید.

برای نصب و مدیریت وابستگی‌های Firebase از Swift Package Manager استفاده کنید.

  1. در Xcode، با باز کردن پروژه برنامه خود، به File > Add Packages بروید.
  2. وقتی از شما خواسته شد، مخزن SDK پلتفرم‌های اپل فایربیس را اضافه کنید: 
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. کتابخانه Analytics را انتخاب کنید.
  4. پرچم -ObjC را به بخش Other Linker Flags در تنظیمات ساخت هدف خود اضافه کنید.
  5. برای یک تجربه بهینه با Analytics ، توصیه می‌کنیم Google Analytics در پروژه Firebase خود فعال کنید و Firebase SDK را برای Google Analytics به برنامه خود اضافه کنید. می‌توانید کتابخانه را بدون مجموعه IDFA یا با مجموعه IDFA انتخاب کنید. به سوالات متداول ما در مورد آخرین سازماندهی ماژول‌ها در Google Analytics برای Firebase SDK مراجعه کنید.
  6. پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی‌های شما در پس‌زمینه می‌کند.

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

در مرحله بعد، برخی از مراحل پیکربندی را انجام دهید:

  1. ماژول FirebaseCore را در UIApplicationDelegate خود وارد کنید، و همچنین هر ماژول Firebase دیگری که app delegate شما از آن استفاده می‌کند. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :

    سویفت‌یو‌آی 

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    سویفت 

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    هدف-سی 

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. یک نمونه اشتراکی FirebaseApp در متد application application(_:didFinishLaunchingWithOptions:) از نماینده برنامه خود پیکربندی کنید:

    سویفت‌یو‌آی 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    سویفت 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    هدف-سی 

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. اگر از SwiftUI استفاده می‌کنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق UIApplicationDelegateAdaptor یا NSApplicationDelegateAdaptor به ساختار App خود پیوست کنید. همچنین باید swizzling نماینده برنامه را غیرفعال کنید. برای اطلاعات بیشتر، به دستورالعمل‌های SwiftUI مراجعه کنید.

    سویفت‌یو‌آی 

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}


(اختیاری) غیرفعال کردن ثبت انتساب شبکه تبلیغاتی اپل

برای راحتی شما، SDK به طور خودکار برنامه شما را برای انتساب شبکه تبلیغاتی با SKAdNetwork در اپل ثبت می‌کند . اگر می‌خواهید این ویژگی را غیرفعال کنید، مقدار GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED را در فایل info.plist برنامه خود روی NO (Boolean) تنظیم کنید.

شروع ثبت وقایع

پس از پیکربندی نمونه FirebaseApp ، می‌توانید با استفاده از متد logEvent() شروع به ثبت رویدادها کنید.

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

مثال زیر نحوه ثبت یک رویداد توصیه‌شده برای نشان دادن کلیک کاربر روی یک عنصر خاص در برنامه شما را نشان می‌دهد:

سویفت

توجه: این محصول Firebase برای سیستم عامل macOS در دسترس نیست. 
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

هدف-سی

توجه: این محصول Firebase برای سیستم عامل macOS در دسترس نیست. 
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

برای مشاهده این رویداد در کنسول اشکال‌زدایی Xcode، اشکال‌زدایی Analytics را فعال کنید:

  1. در Xcode، مسیر Product > Scheme > Edit scheme... را انتخاب کنید.
  2. از منوی سمت چپ، گزینه اجرا (Run) را انتخاب کنید.
  3. برگه آرگومان‌ها را انتخاب کنید.
  4. در بخش Arguments Passed On Launch ، -FIRAnalyticsDebugEnabled را اضافه کنید.

مراحل بعدی