התחלת השימוש ב-Google Analytics


במדריך למתחילים הזה נסביר איך מוסיפים את Google Analytics לאפליקציה ומתחילים לתעד אירועים.

Google Analytics אוסף נתוני שימוש והתנהגות של האפליקציה. ביומן של ה-SDK מתועדים שני סוגים עיקריים של מידע:

  • אירועים: מה קורה באפליקציה שלכם, כמו פעולות של משתמשים, אירועי מערכת או שגיאות.
  • מאפייני משתמשים: מאפיינים שאתם מגדירים כדי לתאר פלחים של בסיס המשתמשים שלכם, כמו העדפות שפה או מיקום גיאוגרפי.

Analytics מתעד באופן אוטומטי חלק מהאירועים ומאפייני המשתמשים. אין צורך להוסיף קוד כדי להפעיל אותם.

לפני שמתחילים

  1. אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט שלכם ב-Apple ומוודאים שהאפשרות Google Analytics מופעלת בפרויקט ב-Firebase:

    • אם אתם יוצרים פרויקט חדש ב-Firebase, צריך להפעיל את Google Analytics במהלך יצירת הפרויקט.

    • אם אתם משתמשים בפרויקט קיים ב-Firebase שלא מופעל בו Google Analytics, תוכלו להפעיל אותו בכרטיסייה Integrations בקטע > Project settings.

    כשמפעילים את Google Analytics בפרויקט, האפליקציות ב-Firebase מקושרות למקורות נתונים של Google Analytics.

  2. (מומלץ). מוסיפים את מסגרת AdSupport לפרויקט כדי להפעיל תכונות נוספות, כמו קהלים ושיוך קמפיינים.

הוספת ה-SDK של Analytics לאפליקציה

אפשר להשתמש ב-Swift Package Manager כדי להתקין ולנהל יחסי תלות של Firebase.

  1. ב-Xcode, כשפרויקט האפליקציה פתוח, עוברים אל File > Add Packages (קובץ > הוספת חבילות).
  2. כשמופיעה בקשה, מוסיפים את המאגר של Firebase SDK לפלטפורמות של Apple:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. בוחרים את הספרייה Analytics.
  4. מוסיפים את הדגל -ObjC לקטע Other Linker Flags (דגלים אחרים של קישור) בהגדרות ה-build של היעד.
  5. כדי ליהנות מחוויית שימוש אופטימלית ב-Analytics, מומלץ להפעיל את Google Analytics בפרויקט Firebase ולהוסיף את Firebase SDK for Google Analytics לאפליקציה. אפשר לבחור בספרייה ללא איסוף של מזהי IDFA או עם איסוף של מזהי IDFA.
  6. בסיום, Xcode יתחיל לפתור את יחסי התלות ולהוריד אותם באופן אוטומטי ברקע.

מידע נוסף על IDFA, המזהה הפרסומי ברמת המכשיר, זמין במסמכים של Apple בנושא פרטיות המשתמשים ושימוש בנתונים ובנושא שקיפות בנושא מעקב אחר אפליקציות.

לאחר מכן מבצעים כמה פעולות הגדרה:

  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, עליכם ליצור נציג אפליקציה ולצרף אותו למבנה App דרך UIApplicationDelegateAdaptor או NSApplicationDelegateAdaptor. צריך גם להשבית את החלפת הקוד של נציג האפליקציה. מידע נוסף זמין בהוראות ל-SwiftUI.

    SwiftUI

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

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


(אופציונלי) השבתת הרישום של שיוך (Attribution) לרשת המודעות של Apple

לנוחותכם, ה-SDK רושם באופן אוטומטי את האפליקציה שלכם ב-Apple לצורך שיוך לרשתות של מודעות באמצעות SKAdNetwork. כדי להשבית את התכונה הזו, צריך להגדיר את הערך של GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED ל-NO (בוליאני) בקובץ info.plist של האפליקציה.

התחלת הרישום של אירועים ביומן

אחרי שמגדירים את המכונה FirebaseApp, אפשר להתחיל לתעד אירועים באמצעות השיטה logEvent().

יש אירועים שמומלצים לכל האפליקציות, ויש אירועים שמומלצים לקטגוריות עסקיות או לסוגים ספציפיים של עסקים. כדי שבדוחות יוצגו כמה שיותר פרטים וכדי ולהפיק תועלת מהתכונות ומהשילובים שיהיו זמינים בעתיד, כדאי לשלוח את האירועים המוצעים עם הפרמטרים שלהם שהוגדרו מראש. בקטע הזה נדגים רישום של אירוע מוגדר מראש ביומן. מידע נוסף על רישום אירועים ביומן זמין במאמר רישום אירועים.

הדוגמה הבאה מראה איך לתעד אירוע מומלץ כדי לציין שמשתמש לחץ על רכיב ספציפי באפליקציה:

Swift

הערה: מוצר Firebase הזה לא זמין ביעד של macOS. 
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Objective-C

הערה: מוצר 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. בתפריט הימני, בוחרים באפשרות הפעלה.
  3. בוחרים בכרטיסייה Arguments.
  4. בקטע Arguments Passed On Launch, מוסיפים את הערך -FIRAnalyticsDebugEnabled.

השלבים הבאים