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