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

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

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

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

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

قبل از شروع

اگر قبلاً این کار را نکرده اید، Firebase را به پروژه Apple خود اضافه کنید و مطمئن شوید که Google Analytics در پروژه Firebase شما فعال است:
- اگر در حال ایجاد یک پروژه Firebase هستید، Google Analytics در جریان کار ایجاد پروژه فعال کنید.
- اگر از یک پروژه Firebase موجود استفاده می کنید که Google Analytics فعال نکرده است، به برگه ادغام ها بروید. > تنظیمات پروژه را فعال کنید.
اخطار: هر پروژه Firebase که قبل از 31 ژوئیه 2019 ایجاد شده باشد، باید به تجربه کامل Google Analytics 4 ارتقا داده شود، اگر قبلاً انجام نشده است. (در صورت نیاز به ارتقا، بنرها در داشبورد Analytics نمایش داده می‌شوند.) برای اطمینان از تداوم جمع‌آوری داده‌ها، شرایط خدمات مرتبط باید تا 15 فوریه 2022 پذیرفته شود . برای کمک به یافتن مالکان پروژه، سؤالات متداول پشتیبانی در مورد ارتقا را ببینید.
هنگامی که Google Analytics در پروژه خود فعال می کنید، برنامه های Firebase شما به جریان داده های Google Analytics مرتبط می شوند.
(توصیه می شود) . چارچوب AdSupport را به پروژه خود اضافه کنید تا ویژگی‌های اضافی مانند مخاطبان و تخصیص کمپین را فعال کنید.

Analytics SDK را به برنامه خود اضافه کنید

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

در Xcode، با باز بودن پروژه برنامه، به File > Add Packages بروید.
هنگامی که از شما خواسته شد، مخزن SDK پلتفرم های Apple Firebase را اضافه کنید:

  https://github.com/firebase/firebase-ios-sdk.git

کتابخانه Analytics را انتخاب کنید.

پرچم -ObjC را به بخش Other Linker Flags تنظیمات ساخت هدف خود اضافه کنید.

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

پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی های شما در پس زمینه می کند.

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

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

ماژول FirebaseCore را در UIApplicationDelegate خود و همچنین هر ماژول Firebase دیگری که نماینده برنامه شما استفاده می‌کند، وارد کنید. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :
SwiftUI
```
import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
سویفت
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
هدف-C
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```

یک نمونه اشتراک‌گذاری شده FirebaseApp در روش application(_:didFinishLaunchingWithOptions:) پیکربندی کنید:

SwiftUI

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

سویفت

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

هدف-C

// Use Firebase library to configure APIs
[FIRApp configure];

اگر از SwiftUI استفاده می‌کنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق UIApplicationDelegateAdaptor یا NSApplicationDelegateAdaptor به ساختار App خود متصل کنید. همچنین باید swizzling نمایندگی برنامه را غیرفعال کنید. برای اطلاعات بیشتر، دستورالعمل های SwiftUI را ببینید.
SwiftUI
```
@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

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

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

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

ثبت رویدادها را شروع کنید

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

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

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

سویفت

توجه: این محصول Firebase در هدف macOS در دسترس نیست.

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])ViewController.swift

هدف-C

توجه: این محصول Firebase در هدف macOS در دسترس نیست.

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];ViewController.m

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

در Xcode، Product > Scheme > Edit scheme را انتخاب کنید...
از منوی سمت چپ Run را انتخاب کنید.
تب Arguments را انتخاب کنید.
در بخش Arguments Passed On Launch ، -FIRAnalyticsDebugEnabled را اضافه کنید.

مراحل بعدی

هر گزارش Analytics را درک کنید.
از DebugView برای تأیید رویدادهای خود استفاده کنید.
داده های خود را در کنسول Firebase کاوش کنید.
راهنماهای رویدادها و ویژگی های کاربر را کاوش کنید.
بیاموزید که چگونه داده های خود را به BigQuery صادر کنید.