Catch up on highlights from Firebase at Google I/O 2023. Learn more

Google Analytics का इस्तेमाल शुरू करें

यह क्विकस्टार्ट आपको दिखाता है कि Google Analytics को अपने ऐप में कैसे जोड़ा जाए और ईवेंट लॉगिंग कैसे शुरू करें।

Google Analytics आपके ऐप के लिए उपयोग और व्यवहार डेटा एकत्र करता है। SDK दो प्राथमिक प्रकार की जानकारी लॉग करता है:

  • घटनाएँ: आपके ऐप में क्या हो रहा है, जैसे कि उपयोगकर्ता क्रियाएँ, सिस्टम घटनाएँ या त्रुटियाँ।
  • उपयोगकर्ता गुण: वे विशेषताएँ जिन्हें आप अपने उपयोगकर्ता आधार के खंडों का वर्णन करने के लिए परिभाषित करते हैं, जैसे कि भाषा वरीयता या भौगोलिक स्थान।

Analytics स्वचालित रूप से कुछ ईवेंट और उपयोगकर्ता प्रॉपर्टी लॉग करता है; उन्हें सक्षम करने के लिए आपको कोई कोड जोड़ने की आवश्यकता नहीं है।

शुरू करने से पहले

  1. यदि आपने पहले से नहीं किया है, तो अपने Apple प्रोजेक्ट में Firebase जोड़ें और सुनिश्चित करें कि आपके Firebase प्रोजेक्ट में Google Analytics सक्षम है:

    • यदि आप एक नया फायरबेस प्रोजेक्ट बना रहे हैं, तो प्रोजेक्ट निर्माण कार्यप्रवाह के दौरान Google Analytics को सक्षम करें।

    • यदि आप किसी ऐसे मौजूदा Firebase प्रोजेक्ट का उपयोग कर रहे हैं जिसमें Google Analytics सक्षम नहीं है, तो उसे सक्षम करने के लिए अपनी > प्रोजेक्ट सेटिंग के एकीकरण टैब पर जाएं.

    जब आप अपने प्रोजेक्ट में Google Analytics को सक्षम करते हैं, तो आपके Firebase ऐप्स Google Analytics डेटा स्ट्रीम से लिंक हो जाते हैं।

  2. (अनुशंसित) । ऑडियंस और अभियान एट्रिब्यूशन जैसी अतिरिक्त सुविधाओं को सक्षम करने के लिए अपने प्रोजेक्ट में AdSupport फ़्रेमवर्क जोड़ें

अपने ऐप में एनालिटिक्स एसडीके जोड़ें

फायरबेस निर्भरताओं को स्थापित और प्रबंधित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।

  1. Xcode में, अपने ऐप प्रोजेक्ट को खोलने के साथ, File > Add Packages पर नेविगेट करें।
  2. संकेत दिए जाने पर, Firebase Apple प्लेटफ़ॉर्म SDK रिपॉजिटरी जोड़ें:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. एनालिटिक्स लाइब्रेरी चुनें।
  5. एनालिटिक्स के साथ एक इष्टतम अनुभव के लिए, हम आपके फायरबेस प्रोजेक्ट में Google एनालिटिक्स को सक्षम करने और Google एनालिटिक्स के लिए फायरबेस एसडीके को अपने ऐप में जोड़ने की सलाह देते हैं। आप या तो आईडीएफए संग्रह के बिना या आईडीएफए संग्रह के साथ पुस्तकालय का चयन कर सकते हैं।
  6. समाप्त होने पर, Xcode स्वचालित रूप से पृष्ठभूमि में आपकी निर्भरताओं को हल करना और डाउनलोड करना शुरू कर देगा।

Apple के उपयोगकर्ता गोपनीयता और डेटा उपयोग और ऐप ट्रैकिंग पारदर्शिता दस्तावेज़ीकरण में डिवाइस-स्तरीय विज्ञापन पहचानकर्ता IDFA के बारे में अधिक जानें।

अगला, कुछ कॉन्फ़िगरेशन चरण करें:

  1. अपने UIApplicationDelegate में FirebaseCore मॉड्यूल आयात करें, साथ ही आपके ऐप प्रतिनिधि द्वारा उपयोग किए जाने वाले किसी भी अन्य Firebase मॉड्यूल को आयात करें। उदाहरण के लिए, क्लाउड फायरस्टार और प्रमाणीकरण का उपयोग करने के लिए:

    स्विफ्टयूआई

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

    तीव्र

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    उद्देश्य सी

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. अपने ऐप प्रतिनिधि के application(_:didFinishLaunchingWithOptions:) विधि में FirebaseApp साझा उदाहरण कॉन्फ़िगर करें:

    स्विफ्टयूआई

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

    तीव्र

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

    उद्देश्य सी

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. यदि आप SwiftUI का उपयोग कर रहे हैं, तो आपको एक एप्लिकेशन प्रतिनिधि बनाना होगा और इसे UIApplicationDelegateAdaptor या NSApplicationDelegateAdaptor के माध्यम से अपने App स्ट्रक्चर में संलग्न करना होगा। आपको ऐप डेलिगेट स्विज़लिंग को भी अक्षम करना होगा। अधिक जानकारी के लिए, 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 स्वचालित रूप से SKAdNetwork के साथ विज्ञापन नेटवर्क एट्रिब्यूशन के लिए Apple के साथ आपके ऐप को पंजीकृत करता है । यदि आप इस सुविधा को अक्षम करना चाहते हैं, तो अपने ऐप की info.plist फ़ाइल में GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED के मान को NO (बूलियन) पर सेट करें।

ईवेंट लॉगिंग प्रारंभ करें

आपके द्वारा FirebaseApp उदाहरण को कॉन्फ़िगर करने के बाद, आप logEvent() विधि से ईवेंट लॉग करना शुरू कर सकते हैं।

सभी ऐप्स के लिए कुछ खास इवेंट की सिफारिश की जाती है; दूसरों को विशिष्ट व्यवसाय प्रकारों या कार्यक्षेत्रों के लिए अनुशंसित किया जाता है। आपको अपनी रिपोर्ट में अधिकतम उपलब्ध विवरण सुनिश्चित करने और भविष्य की सुविधाओं और एकीकरणों के उपलब्ध होने पर लाभ उठाने के लिए, उनके निर्धारित मापदंडों के साथ सुझाए गए ईवेंट भेजने चाहिए। यह अनुभाग एक पूर्व-निर्धारित ईवेंट लॉगिंग प्रदर्शित करता है, लॉगिंग इवेंट्स के बारे में अधिक जानकारी के लिए, लॉग इवेंट्स देखें।

निम्न उदाहरण दर्शाता है कि उपयोगकर्ता द्वारा आपके ऐप में किसी विशिष्ट तत्व पर क्लिक करने के लिए अनुशंसित ईवेंट को कैसे लॉग किया जाए:

तीव्र

ध्यान दें: यह Firebase उत्पाद macOS लक्ष्य पर उपलब्ध नहीं है।
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

उद्देश्य सी

ध्यान दें: यह Firebase उत्पाद macOS लक्ष्य पर उपलब्ध नहीं है।
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

इस घटना को एक्सकोड डीबग कंसोल में देखने के लिए, एनालिटिक्स डीबगिंग सक्षम करें:

  1. Xcode में, उत्पाद > योजना > संपादित योजना चुनें...
  2. बाएं मेनू से चलाएँ चुनें।
  3. तर्क टैब का चयन करें।
  4. लॉन्च सेक्शन में दिए गए तर्कों में -FIRAnalyticsDebugEnabled जोड़ें।

अगले कदम