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

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


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

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

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

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. अपने टारगेट की बिल्ड सेटिंग के अन्य लिंकर फ़्लैग सेक्शन में, -ObjC फ़्लैग जोड़ें.
  5. Analytics का बेहतर अनुभव पाने के लिए, हमारा सुझाव है कि आप अपने Firebase प्रोजेक्ट में Google Analytics को चालू करें. साथ ही, अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल जोड़ें. आपके पास आईडीएफ़ए कलेक्शन के बिना या आईडीएफ़ए कलेक्शन वाली लाइब्रेरी चुनने का विकल्प है. Google Analytics for Firebase SDK में मॉड्यूल के नए संगठन के बारे में अक्सर पूछे जाने वाले सवाल देखें.
  6. इसके बाद, Xcode बैकग्राउंड में आपकी डिपेंडेंसी से जुड़ी समस्या को हल करना और उन्हें डाउनलोड करना शुरू कर देगा.

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

इसके बाद, कॉन्फ़िगरेशन के लिए यह तरीका अपनाएं:

  1. FirebaseCore मॉड्यूल को अपने UIApplicationDelegate में इंपोर्ट करें. साथ ही, ऐसे अन्य 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 के विज्ञापन नेटवर्क एट्रिब्यूशन रजिस्ट्रेशन को बंद करना

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

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

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

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

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

Swift

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

Objective-C

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

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

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

अगले चरण