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

प्लैटफ़ॉर्म चुनें: iOS+ Android Web Flutter Unity C++

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

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

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

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

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

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

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

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

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

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
ObjCMigratedSnippets.m

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

  1. Xcode में, Product > Scheme > Edit scheme... को चुनें
  2. बाईं ओर मौजूद मेन्यू से, Run को चुनें.
  3. Arguments टैब को चुनें.
  4. Arguments Passed On Launch सेक्शन में, -FIRAnalyticsDebugEnabled जोड़ें.

अगले चरण