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

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

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

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

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

לפני שאתה מתחיל

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

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

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

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

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

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

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

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

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

לאחר מכן, בצע כמה שלבי תצורה:

  1. ייבא את מודול FirebaseCore ב- UIApplicationDelegate שלך, כמו גם כל מודולי Firebase אחרים שנציג האפליקציה שלך משתמש בו. לדוגמה, כדי להשתמש ב-Cloud Firestore ובאימות:

    SwiftUI

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

    מָהִיר

    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()

    מָהִיר

    // 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()
          }
        }
      }
    }
          


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

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

התחל לרשום אירועים

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

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

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

מָהִיר

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

Objective-C

הערה: מוצר Firebase זה אינו זמין ביעד macOS.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

כדי להציג אירוע זה במסוף ניפוי הבאגים של Xcode, הפעל ניפוי באגים ב-Analytics:

  1. ב-Xcode, בחר מוצר > סכימה > עריכת סכמה...
  2. בחר הפעלה מהתפריט השמאלי.
  3. בחר בכרטיסייה ארגומנטים .
  4. במקטע טיעונים שהועברו במהלך ההשקה , הוסף -FIRAnalyticsDebugEnabled .

הצעדים הבאים