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. (सुझाया गया). ऑडियंस और कैंपेन एट्रिब्यूशन जैसी अतिरिक्त सुविधाओं को चालू करने के लिए, अपने प्रोजेक्ट में AdSupport फ़्रेमवर्क जोड़ें.

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

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

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

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

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

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

    स्विफ़्टयूआई

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. अपने ऐप्लिकेशन का ऐक्सेस देने वाले व्यक्ति के application(_:didFinishLaunchingWithOptions:) तरीके में, FirebaseApp शेयर किए गए इंस्टेंस को कॉन्फ़िगर करें:

    स्विफ़्टयूआई

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

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

FirebaseApp इंस्टेंस कॉन्फ़िगर करने के बाद, logEvent() तरीके का इस्तेमाल करके इवेंट लॉग किए जा सकते हैं.

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

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

Swift

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

Objective-C

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

Xcode डीबग कंसोल में इस इवेंट को देखने के लिए, Analytics डीबग करने की सुविधा चालू करें:

  1. Xcode में, प्रॉडक्ट > स्कीम > स्कीम में बदलाव करें... चुनें
  2. बाईं ओर दिए गए मेन्यू में जाकर, Run चुनें.
  3. आर्ग्युमेंट टैब चुनें.
  4. लॉन्च किए जाने पर पास किए गए आर्ग्युमेंट सेक्शन में, -FIRAnalyticsDebugEnabled जोड़ें.

अगले चरण