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

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

Analytics डेटा का कलेक्शन बंद करना

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

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

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

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

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

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