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

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

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

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

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

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

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

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

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

When you enable Google Analytics in your project, your Firebase apps
are linked to Google Analytics data streams.
  1. (מומלץ). מוסיפים את המסגרת AdSupport לפרויקט שלך כדי לאפשר תכונות נוספות כגון קהלים וייחוס הקמפיין.

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

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

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

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

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

  1. ייבא את מודול Firebase ב שלך UIApplicationDelegate :

    מָהִיר

    import Firebase

    Objective-C

    @import Firebase;
  2. & Nbsp הגדר FirebaseApp משותף למשל, בדרך כלל של האפליקציה שלך application:didFinishLaunchingWithOptions: השיטה:

    מָהִיר

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

    Objective-C

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


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

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

הצעדים הבאים