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


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

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

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

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

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

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

    • अगर आपको नया Firebase प्रोजेक्ट बनाना है, तो प्रोजेक्ट बनाने के वर्कफ़्लो के दौरान Google Analytics को चालू करें.

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

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

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

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

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

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

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

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

  1. अपने UIApplicationDelegate में FirebaseCore मॉड्यूल के साथ-साथ, ऐप्लिकेशन डेलिगेट इस्तेमाल करने वाले अन्य Firebase मॉड्यूल इंपोर्ट करें. उदाहरण के लिए, Cloud Firestore और Authentication का इस्तेमाल करने के लिए:

    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. अपने ऐप्लिकेशन डेलिगेट के application(_:didFinishLaunchingWithOptions:) तरीके में, शेयर किए गए इंस्टेंस FirebaseApp को कॉन्फ़िगर करें:

    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 या NSApplicationDelegateAdaptor के ज़रिए अपनी App स्ट्रक्चर से जोड़ना होगा. आपको ऐप्लिकेशन के डेलिगेट स्विज़लिंग को भी बंद करना होगा. ज़्यादा जानकारी के लिए, 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 Ad Network Attribution की रजिस्ट्रेशन सुविधा बंद करना

आपकी सुविधा के लिए, 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 में, Product > Scheme > Edit scheme... को चुनें
  2. बाईं ओर मौजूद मेन्यू से, Run को चुनें.
  3. Arguments टैब चुनें.
  4. Arguments Passed On Launch सेक्शन में, -FIRAnalyticsDebugEnabled जोड़ें.

अगले चरण