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

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

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

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

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

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

אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט שלכם ב-Apple ומוודאים שהאפשרות Google Analytics מופעלת בפרויקט ב-Firebase:
- אם אתם יוצרים פרויקט חדש ב-Firebase, צריך להפעיל את Google Analytics במהלך תהליך יצירת הפרויקט.
- אם אתם משתמשים בפרויקט קיים ב-Firebase שלא מופעל בו Google Analytics, תוכלו להפעיל אותו בכרטיסייה Integrations בקטע > Project settings.
אזהרה: אם עדיין לא עשיתם זאת, עליכם לשדרג כל פרויקט Firebase שנוצר לפני 31 ביולי 2019 לחוויית השימוש המלאה ב-Google Analytics 4. (באנרים מוצגים במרכז הבקרה Analytics אם נדרש שדרוג). כדי להבטיח שהאיסוף של הנתונים ימשיך, צריך לאשר את התנאים וההגבלות המשויכים עד 15 בפברואר 2022. במאמרי השאלות הנפוצות של התמיכה בנושא השדרוג מוסבר איך למצוא את בעלי הפרויקט.

כשמפעילים את Google Analytics בפרויקט, האפליקציות ב-Firebase מקושרות למקורות הנתונים של Google Analytics.
(מומלץ). מוסיפים את מסגרת AdSupport לפרויקט כדי להפעיל תכונות נוספות, כמו קהלים ושיוך קמפיינים.

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

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

ב-Xcode, כשפרויקט האפליקציה פתוח, עוברים אל קובץ > הוספת חבילות.
כשמופיעה בקשה, מוסיפים את המאגר של Firebase SDK לפלטפורמות של Apple:

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

בוחרים את הספרייה Analytics.
מוסיפים את הדגל -ObjC לקטע Other Linker Flags (דגלים אחרים של קישור) בהגדרות ה-build של היעד.
כדי ליהנות מחוויית שימוש אופטימלית ב-Analytics, מומלץ להפעיל את Google Analytics בפרויקט Firebase ולהוסיף את Firebase SDK for Google Analytics לאפליקציה. אפשר לבחור בספרייה ללא איסוף של מזהי IDFA או עם איסוף של מזהי IDFA.
בסיום, Xcode יתחיל לפתור את יחסי התלות ולהוריד אותם באופן אוטומטי ברקע.

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

לאחר מכן, מבצעים כמה שלבים להגדרה:

מייבאים את המודול 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;
// ...
      
```

מגדירים מכונה משותפת של 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];

אם אתם משתמשים ב-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:

ב-Xcode, בוחרים באפשרות Product (מוצר) > Scheme (תוכנית) > Edit scheme… (עריכת התוכנית).
בתפריט הימני, בוחרים באפשרות הפעלה.
בוחרים בכרטיסייה Arguments.
בקטע Arguments Passed On Launch, מוסיפים את הערך -FIRAnalyticsDebugEnabled.

השלבים הבאים

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