תחילת העבודה עם Google Analytics ל-iOS+

בחירת פלטפורמה: iOS+‎ Android אינטרנט Flutter Unity C++‎


במדריך למתחילים הזה מוסבר איך להוסיף את 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 framework לפרויקט כדי להפעיל תכונות נוספות, כמו קהלים וייבוא נתוני הקמפיין.

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

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

  1. ב-Xcode, כשהפרויקט של האפליקציה פתוח, עוברים אל File > Add Packages (קובץ > הוספת חבילות).
  2. כשמוצגת בקשה, מוסיפים את מאגר ה-SDK של Firebase לפלטפורמות של אפל:
    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. שאלות נפוצות על הארגון העדכני של המודולים ב-Google Analytics for Firebase SDK
  6. אחרי שתסיימו, פלטפורמת Xcode תתחיל לטפל ביחסי התלות ולהוריד אותם באופן אוטומטי ברקע.

מידע נוסף על IDFA, מזהה הפרסום ברמת המכשיר, זמין במסמכי התיעוד של אפל בנושא פרטיות המשתמשים והשימוש בנתונים וApp Tracking Transparency.

עכשיו מבצעים כמה שלבי הגדרה:

  1. מייבאים את המודול FirebaseCore אל UIApplicationDelegate, וגם כל מודול Firebase אחר שבו משתמש ה-app delegate. לדוגמה, כדי להשתמש ב-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 ב-method‏ 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, אתם צריכים ליצור נציג של האפליקציה ולצרף אותו ל-struct של App באמצעות UIApplicationDelegateAdaptor או NSApplicationDelegateAdaptor. צריך גם להשבית את ה-swizzling של נציג האפליקציה. מידע נוסף זמין בהוראות של 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) של רשת המודעות של אפל

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

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

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

השלבים הבאים