Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

התחל לעבוד עם Google Analytics

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

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

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

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

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

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

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

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

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

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

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

  1. הוסף את התלות של Firebase לפודפיל שלך:
    pod 'Firebase/Analytics'
    
    # For Analytics without IDFA collection capability, use this pod instead
    # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
    
    למידע נוסף על IDFA, מזהה הפרסום ברמת המכשיר, בתיעוד פרטיות המשתמשים של אפל ושימוש בנתונים ותיעוד שקיפות מעקב אחר אפליקציות .
  2. הפעל pod install ופתח את קובץ ה- .xcworkspace שנוצר.
  3. ייבא את מודול Firebase ל- UIApplicationDelegate שלך:

    מָהִיר

    import Firebase

    מטרה-ג

    @import Firebase;
  4. הגדר תצורה משותפת של FirebaseApp , בדרך כלל ביישום האפליקציה שלך application:didFinishLaunchingWithOptions: method:

    מָהִיר

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    מטרה-ג

    // Use Firebase library to configure APIs
    [FIRApp configure];


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

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

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

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

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

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

מָהִיר

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont"
  ])

מטרה-ג

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

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

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

הצעדים הבאים