Analytics में डेटा इकट्ठा करने और उसके इस्तेमाल को कॉन्फ़िगर करना

इस पेज पर, Google Analytics की उन सुविधाओं के बारे में बताया गया है जिनकी मदद से, Analytics डेटा के कलेक्शन और इस्तेमाल को कंट्रोल किया जा सकता है.

Analytics डेटा कलेक्शन की प्रोसेस बंद करना

कुछ मामलों में, आपको Analytics डेटा कलेक्शन की प्रोसेस को अस्थायी या स्थायी तौर पर बंद करना पड़ सकता है. जैसे, असली उपयोगकर्ता की सहमति लेना या कानूनी दायित्वों को पूरा करना. Google Analytics में, डेटा कलेक्शन की प्रोसेस को बंद करने और डीऐक्टिवेट करने Analytics के कई विकल्प मौजूद हैं. इन विकल्पों का एक साथ इस्तेमाल करके, कई सामान्य इस्तेमाल के उदाहरणों को पूरा किया जा सकता है.

अस्थायी तौर पर डेटा कलेक्शन की प्रोसेस बंद करना

अगर आपको Analytics डेटा कलेक्शन की प्रोसेस को अस्थायी तौर पर बंद करना है, तो अपने ऐप्लिकेशन की Info.plist फ़ाइल में, FIREBASE_ANALYTICS_COLLECTION_ENABLED की वैल्यू को NO (बूलियन) पर सेट करें. ऐसा तब किया जा सकता है, जब आपको डेटा इकट्ठा करने से पहले असली उपयोगकर्ता की सहमति लेनी हो. उदाहरण के लिए, सोर्स एक्सएमएल में इस तरह से देखा जा सकता है:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>

डेटा कलेक्शन की प्रोसेस को फिर से चालू करने के लिए, setAnalyticsCollectionEnabled इंस्टेंस वाले तरीके को कॉल करें. ऐसा तब किया जा सकता है, जब असली उपयोगकर्ता सहमति दे दे.Analytics उदाहरण के लिए:

Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

अगर आपको किसी भी वजह से डेटा कलेक्शन की प्रोसेस को फिर से बंद करना है, तो यहां दिया गया तरीका अपनाएं. इसके बाद, डेटा कलेक्शन की प्रोसेस तब तक बंद रहेगी, जब तक इसे फिर से चालू नहीं किया जाता.

Analytics.setAnalyticsCollectionEnabled(false)

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

setAnalyticsCollectionEnabled तरीके से सेट की गई वैल्यू, ऐप्लिकेशन के सभी वर्शन में बनी रहती है. साथ ही, यह आपके ऐप्लिकेशन की Info.plist फ़ाइल में मौजूद FIREBASE_ANALYTICS_COLLECTION_ENABLED की वैल्यू को बदल देती है. setAnalyticsCollectionEnabled के लिए वैल्यू सेट करने के बाद, Analytics की डेटा कलेक्शन की प्रोसेस तब तक उसी स्थिति में बनी रहती है, जब तक setAnalyticsCollectionEnabled को फिर से कॉल नहीं किया जाता. ऐसा तब भी होता है, जब कोई उपयोगकर्ता आपके ऐप्लिकेशन को बंद करके फिर से खोलता है.

स्थायी तौर पर डेटा कलेक्शन की प्रोसेस बंद करना

अगर आपको अपने ऐप्लिकेशन के किसी वर्शन में, Analytics की डेटा कलेक्शन की प्रोसेस को स्थायी तौर पर बंद करना है, तो अपने ऐप्लिकेशन की Info.plist फ़ाइल में, FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED की वैल्यू को YES (बूलियन) पर सेट करें. FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED की वैल्यू को YES (बूलियन) पर सेट करने से, आपके ऐप्लिकेशन की Info.plist फ़ाइल में मौजूद FIREBASE_ANALYTICS_COLLECTION_ENABLED की सभी वैल्यू के साथ-साथ, setAnalyticsCollectionEnabled से सेट की गई सभी वैल्यू पर प्राथमिकता मिलती है.

डेटा कलेक्शन की प्रोसेस को फिर से चालू करने के लिए, अपनी Info.plist फ़ाइल से FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED को हटाएं. FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED की वैल्यू को NO (बूलियन) पर सेट करने से कोई असर नहीं पड़ता. साथ ही, इससे वही नतीजा मिलता है जो आपकी Info.plist फ़ाइल में FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED को सेट न करने पर मिलता है.

IDFA कलेक्शन की प्रोसेस बंद करना

अगर आपने SPM या CocoaPods की मदद से, अपने ऐप्लिकेशन में FirebaseAnalytics मॉड्यूल इंस्टॉल किया है और Apple के अपने ऐप्लिकेशन में IDFA (किसी डिवाइस का विज्ञापन आईडी) के कलेक्शन की प्रोसेस बंद करनी है, तो पक्का करें कि आपके ऐप्लिकेशन में AdSupport फ़्रेमवर्क शामिल न हो.

IDFA कलेक्शन की सुविधा के बिना Firebase इंस्टॉल करने के लिए, FirebaseAnalytics डिपेंडेंसी के बजाय इसका इस्तेमाल करें:

  .target(
    name: "MyTargetName",
    dependencies: [
      .product(name: "FirebaseAnalyticsCore", package: "Firebase"),
      // ...
    ]
  ),

pod 'FirebaseAnalytics/Core'

Apple के दस्तावेज़ में IDFA के बारे में ज़्यादा जानें:

• उपयोगकर्ता की निजता और डेटा का इस्तेमाल
• App Tracking Transparency

IDFV कलेक्शन की प्रोसेस बंद करना

अगर आपको Apple के अपने ऐप्लिकेशन में IDFV (वेंडर के लिए आईडी) के कलेक्शन की प्रोसेस बंद करनी है, तो अपने ऐप्लिकेशन की Info.plist फ़ाइल में, GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED की वैल्यू को NO (बूलियन) पर सेट करें.

लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने के लिए, डेटा कलेक्शन की सुविधा को कंट्रोल करना

अगर आपने अपने Google Analytics प्रोजेक्ट को किसी विज्ञापन खाते से लिंक किया है या विज्ञापन इंटिग्रेशन की सुविधा चालू की है या डेटा शेयर करने की सुविधा चुनी है, तो आपके Analytics डेटा का इस्तेमाल, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने के लिए किया जा सकता है. इसका मतलब है कि रीमार्केटिंग के लिए ऑडियंस की सूचियां बनाने और उन्हें डिप्लॉय करने के लिए, इकट्ठा किए गए इवेंट का इस्तेमाल किया जा सकता है. जैसे, first_open. हालांकि, ऐसा तब तक किया जा सकता है, जब तक यह न बताया जाए कि लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने के लिए, इस तरह का डेटा उपलब्ध नहीं है.

प्रोग्राम के ज़रिए यह कंट्रोल किया जा सकता है कि लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने के लिए, उपयोगकर्ता के Analytics डेटा का इस्तेमाल किया जाना चाहिए या नहीं. इसके लिए, इनमें से कोई भी विकल्प इस्तेमाल किया जा सकता है:

• सुझाया गया तरीका: उपयोगकर्ता की सहमति के विकल्प के हिसाब से, विज्ञापन को लोगों की दिलचस्पी के हिसाब से दिखाने की सुविधा को डाइनैमिक तौर पर चालू या बंद करना. Google के सहमति मोड वाले एपीआई को लागू करना.

• उपयोगकर्ता के लेवल पर, विज्ञापन को लोगों की दिलचस्पी के हिसाब से दिखाने की सुविधा को चालू या बंद करना: विज्ञापन को लोगों की दिलचस्पी के हिसाब से दिखाने की सुविधा को, उपयोगकर्ता प्रॉपर्टी के तौर पर कंट्रोल करना.

• Analytics प्रॉपर्टी के लेवल पर, विज्ञापन को लोगों की दिलचस्पी के हिसाब से दिखाने की सुविधा को चालू या बंद करना: अपनी Analytics प्रॉपर्टी में, भौगोलिक इलाके के हिसाब से विज्ञापन को लोगों की दिलचस्पी के हिसाब से दिखाने की सुविधा को बंद करना.

उपयोगकर्ता प्रॉपर्टी की मदद से, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा बंद करना

लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा को चालू और बंद करने के लिए, Google के सहमति मोड वाले एपीआई का इस्तेमाल करने का सुझाव दिया जाता है.

हालांकि, अगर आपके ऐप्लिकेशन में अब तक सहमति मोड का इस्तेमाल नहीं किया जा रहा है, तो लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा को कंट्रोल करने के लिए, यहां दिया गया विकल्प इस्तेमाल किया जा सकता है.

डिफ़ॉल्ट रूप से, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा को बंद करने के लिए, अपने ऐप्लिकेशन की Info.plist फ़ाइल में, GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS की वैल्यू को NO (बूलियन) पर सेट करें.

उपयोगकर्ता प्रॉपर्टी की मदद से, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा को फिर से चालू करना

अगर विज्ञापन को लोगों की दिलचस्पी के हिसाब से दिखाने की सुविधा को कंट्रोल करने के लिए, AnalyticsUserPropertyAllowAdPersonalizationSignals पैरामीटर का इस्तेमाल किया जाता है, तो setUserProperty तरीके से, विज्ञापन को लोगों की दिलचस्पी के हिसाब से दिखाने की सुविधा को फिर से चालू किया जा सकता है. इसका तरीका यहां दिया गया है:

Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

अगर आपने Analytics की डेटा कलेक्शन की प्रोसेस को अस्थायी तौर पर बंद किया है (उदाहरण के लिए, असली उपयोगकर्ता की सहमति मिलने तक) और किसी उपयोगकर्ता के लिए Analytics की डेटा कलेक्शन की प्रोसेस को फिर से चालू करने पर, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा को कंट्रोल करना है, तो पक्का करें कि इस सेटिंग की जानकारी देने के लिए किया गया कॉल, Analytics की डेटा कलेक्शन की प्रोसेस को फिर से चालू करने के लिए किए गए कॉल से पहले हो. उदाहरण के लिए:

Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

अपनी सेटिंग की पुष्टि करें

जब ऊपर बताए गए किसी तरीके से, किसी उपयोगकर्ता के लिए विज्ञापन को लोगों की दिलचस्पी के हिसाब से दिखाने के सिग्नल बंद कर दिए जाते हैं, तो उस उपयोगकर्ता के डिवाइस से लॉग किए गए इवेंट के बंडल में, non_personalized_ads नाम की उपयोगकर्ता प्रॉपर्टी शामिल होती है. इसकी वैल्यू 1 होती है. इससे पता चलता है कि उस बंडल में मौजूद इवेंट, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने के लिए उपलब्ध नहीं हैं. लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा बंद करने से, मेज़रमेंट के लिए डेटा के इस्तेमाल पर कोई असर नहीं पड़ता. इसमें रिपोर्टिंग और एट्रिब्यूशन भी शामिल है.

कॉन्फ़िगरेशन में किए गए बदलाव देखना

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