Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

تجزیه و تحلیل ترافیک به طور خودکار سیاهههای مربوط به برخی حوادث و خواص کاربران ؛ برای فعال کردن آنها نیازی به افزودن کدی ندارید.

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

  1. اگر شما در حال حاضر نیست، اضافه فایربیس به پروژه اپل خود را و مطمئن شوید که گوگل آنالیز در پروژه Firebase خود را فعال کنید:

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

    • اگر شما با استفاده از پروژه های موجود فایربیس که لازم نیست گوگل آنالیز را فعال کنید، رفتن به یکپارچگی تب از خود > تنظیمات پروژه به آن را فعال کنید.

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

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

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

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

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

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

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

  1. واردات ماژول فایربیس خود را UIApplicationDelegate :

    سریع

    import Firebase

    هدف-C

    @import Firebase;
  2. پیکربندی FirebaseApp عنوان مثال مشترک، به طور معمول در برنامه شما application:didFinishLaunchingWithOptions: روش:

    سریع

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

    هدف-C

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


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

برای راحتی شما، SDK به طور خودکار ثبت برنامه خود را با اپل برای انتساب شبکه آگهی با SKAdNetwork . اگر شما می خواهید برای غیر فعال کردن این ویژگی، مجموعه ای از ارزش GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED به NO (بولی) در فایل Info.plist برنامه شما هستند.

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

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

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

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

سریع

نکته: این محصول فایربیس در دسترس بر روی هدف از MacOS است.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

هدف-C

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

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

  1. در Xcode متعلق به، را انتخاب کنید طرح محصولات> طرح> ویرایش ...
  2. انتخاب کنید Run را از منوی سمت چپ.
  3. تب استدلال را انتخاب کنید.
  4. در آرگومان در بخش راه اندازی، افزودنی -FIRAnalyticsDebugEnabled .

مراحل بعدی