התחלת השימוש ב-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 framework לפרויקט כדי להפעיל תכונות נוספות כמו קהלים ושיוך (Attribution) לקמפיינים.

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

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

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

מידע נוסף על המזהה למפרסמים (IDFA), המזהה הפרסומי ברמת המכשיר, זמין במסמכי הפרטיות של המשתמשים והשימוש בנתונים והשקיפות בנושא מעקב (ATT) של 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()
      }
    }
  }
}


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

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

השלבים הבאים