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

इस क्विकस्टार्ट में, अपने ऐप्लिकेशन में Google Analytics जोड़ने का तरीका और इवेंट लॉग करना शुरू कर दें.

Google Analytics, आपके ऐप्लिकेशन के इस्तेमाल और व्यवहार से जुड़ा डेटा इकट्ठा करता है. SDK टूल मुख्य तौर पर दो तरह की जानकारी लॉग करता है:

  • इवेंट: आपके ऐप्लिकेशन में क्या हो रहा है, जैसे कि उपयोगकर्ता की कार्रवाइयां, सिस्टम इवेंट, या गड़बड़ियों की जानकारी देते हैं.
  • उपयोगकर्ता प्रॉपर्टी: ऐसे एट्रिब्यूट जिन्हें आप अपने सेगमेंट की जानकारी देने के लिए तय करते हैं उपयोगकर्ता आधार, जैसे भाषा प्राथमिकता या भौगोलिक स्थान.

Analytics कुछ डेटा को अपने-आप लॉग करता है इवेंट और उपयोगकर्ता प्रॉपर्टी; आपको उन्हें चालू करने के लिए कोई कोड जोड़ने की ज़रूरत नहीं है.

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

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

    • अगर कोई नया Firebase प्रोजेक्ट बनाया जा रहा है, तो Google Analytics चालू करें का इस्तेमाल किया जाता है.

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

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

  2. (सुझाया गया). अपने प्रोजेक्ट बनाएं, ताकि अन्य सुविधाएं चालू की जा सकें जैसे कि ऑडियंस और कैंपेन एट्रिब्यूशन.

अपने ऐप्लिकेशन में Analytics SDK टूल जोड़ना

Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift पैकेज मैनेजर का इस्तेमाल करें.

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

Apple के स्टोर में जाकर, डिवाइस लेवल पर विज्ञापन के लिए आइडेंटिफ़ायर, IDFA के बारे में ज़्यादा जानें उपयोगकर्ता की निजता और डेटा का इस्तेमाल और ऐप्लिकेशन ट्रैकिंग से जुड़ी पारदर्शिता दस्तावेज़.

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

  1. अपने इसमें FirebaseCore मॉड्यूल को इंपोर्ट करें UIApplicationDelegate और अन्य वे Firebase मॉड्यूल जिनका इस्तेमाल आपका ऐप्लिकेशन मैनेज करने का ऐक्सेस देने वाला व्यक्ति करता है. उदाहरण के लिए, Cloud Firestore और पुष्टि करने की सुविधा का इस्तेमाल करने के लिए:

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

    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 टूल अपने-आप रजिस्टर करता है विज्ञापन नेटवर्क एट्रिब्यूशन के लिए, Apple के साथ आपका ऐप्लिकेशन SKAdNetwork. यदि आप इस सुविधा को अक्षम करना चाहते हैं, तो GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED से NO (बूलियन) इंच आपके ऐप्लिकेशन की जानकारी.plist फ़ाइल पर.

इवेंट लॉग करना शुरू करें

FirebaseApp इंस्टेंस कॉन्फ़िगर करने के बाद, लॉग करना शुरू करें इवेंट logEvent() तरीका.

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

नीचे दिए गए उदाहरण में, सुझाए गए इवेंट को लॉग करने का तरीका बताया गया है. उपयोगकर्ता ने आपके ऐप्लिकेशन में किसी खास एलिमेंट पर क्लिक किया है:

Swift

ध्यान दें: 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. बाईं ओर दिए गए मेन्यू में जाकर, Run चुनें.
  3. आर्ग्युमेंट टैब चुनें.
  4. लॉन्च पर पास किए गए तर्क सेक्शन में, -FIRAnalyticsDebugEnabled.

अगले चरण