شروع به کار با Google Analytics برای iOS+‎

انتخاب پلاتفرم: iOS+ Android Web Flutter Unity C++‎


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

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

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

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

قبل از شروع

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

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

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

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

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

‫Analytics SDK را به برنامه‌تان اضافه کنید

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

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

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

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

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

    SwiftUI

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

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

    SwiftUI

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

    Swift

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

    Objective-C

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

    SwiftUI

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

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


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

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

شروع گزارش‌گیری رویدادها

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

  1. در Xcode، محصول > طرح > ویرایش طرح... را انتخاب کنید.
  2. اجرا را از منوِ سمت راست انتخاب کنید.
  3. برگه استدلال‌ها را انتخاب کنید.
  4. در بخش استدلال‌های منتقل‌شده در زمان راه‌اندازی، -FIRAnalyticsDebugEnabled را اضافه کنید.

مراحل بعدی