欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    سریع

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    هدف-C

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

    سریع

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

    هدف-C

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


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

برای راحتی شما، 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",
])

هدف-C

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

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

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

مراحل بعدی