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

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

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

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

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

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

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

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

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

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

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

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

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

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

ऐप्पल के उपयोगकर्ता गोपनीयता और डेटा उपयोग और ऐप ट्रैकिंग पारदर्शिता दस्तावेज़ में डिवाइस-स्तरीय विज्ञापन पहचानकर्ता आईडीएफए के बारे में और जानें।

इसके बाद, कुछ कॉन्फ़िगरेशन चरण निष्पादित करें:

  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. यदि आप स्विफ्टयूआई का उपयोग कर रहे हैं, तो आपको एक एप्लिकेशन प्रतिनिधि बनाना होगा और इसे UIApplicationDelegateAdaptor या NSApplicationDelegateAdaptor के माध्यम से अपने App स्ट्रक्चर में संलग्न करना होगा। आपको ऐप डेलीगेट स्विज़लिंग को भी अक्षम करना होगा। अधिक जानकारी के लिए स्विफ्टयूआई निर्देश देखें।

    स्विफ्टयूआई

    @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() विधि से ईवेंट लॉग करना शुरू कर सकते हैं।

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

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

तीव्र

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

उद्देश्य सी

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

इस इवेंट को Xcode डिबग कंसोल में देखने के लिए, Analytics डिबगिंग सक्षम करें:

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

अगले कदम