ऐप्लिकेशन के लिए सहमति मोड सेट अप करना

यह पेज उन डेवलपर के लिए है जो अपने ऐप्लिकेशन में, 'Firebase के लिए Google Analytics SDK' टूल का इस्तेमाल करते हैं और सहमति मोड को इंटिग्रेट करना चाहते हैं. सहमति मोड के बारे में जानने के लिए, सहमति मोड के बारे में खास जानकारी लेख पढ़ें.

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

सहमति मोड का ऐडवांस वर्शन सहमति मोड का बेसिक वर्शन

iOS Android

अहम जानकारी: ऐप्लिकेशन के लिए सहमति मोड को 30 अक्टूबर, 2023 को अपडेट किया गया था और अब इसमें दो अन्य पैरामीटर शामिल हैं. अगर सहमति मोड का इस्तेमाल पहले से किया जा रहा है, तो सहमति मोड v2 पर अपग्रेड करें. Google के यूरोपियन इकनॉमिक एरिया (ईईए) में ट्रैफ़िक के लिए, सहमति मोड से जुड़े अपडेट के बारे में ज़्यादा जानें.

वेब कंटेनर इंस्टॉल करने से पहले

उपयोगकर्ता की सहमति को मैनेज करने से पहले, आपको ये काम करने होंगे:

• 'Firebase के लिए Google Analytics' SDK टूल

• उपयोगकर्ता की सहमति को कैप्चर करने के लिए, सहमति की सेटिंग का बैनर

  सलाह: अगर आपको सहमति की सेटिंग खुद लागू नहीं करनी हैं, तो किसी सहमति मैनेजमेंट प्लैटफ़ॉर्म (सीएमपी) का इस्तेमाल करें.

सहमति मोड सेट अप करें

सहमति मोड सेट अप करने के लिए:

1. उपयोगकर्ता की सहमति से पहले: Analytics में मौजूद डेटा इकट्ठा करने की सुविधा को कुछ समय के लिए बंद करें.
2. सहमति की डिफ़ॉल्ट स्थिति सेट करें.
3. आपकी सहमति की सेटिंग की मदद से हुए उपयोगकर्ता इंटरैक्शन के आधार पर, सहमति की स्थिति अपडेट करें.
4. Analytics में मौजूद डेटा को इकट्ठा करने की सुविधा को फिर से चालू करें.

Analytics में डेटा इकट्ठा करने की सुविधा को कुछ समय के लिए बंद करना

सहमति मोड को बुनियादी तौर पर लागू करने का मतलब है कि उपयोगकर्ता की सहमति के बिना, Google Analytics for Firebase SDK टूल को लोड होने से ब्लॉक किया जा रहा है.

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

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

सहमति की डिफ़ॉल्ट स्थिति सेट करना

डिफ़ॉल्ट रूप से, सहमति मोड की कोई भी वैल्यू सेट नहीं होती है. अपने ऐप्लिकेशन के लिए सहमति की डिफ़ॉल्ट स्थिति सेट करने के लिए:

1. अपने ऐप्लिकेशन की info.plist फ़ाइल खोलें.

2. सहमति मोड के लिए-वैल्यू पेयर जोड़ें. कुंजी सहमति के टाइप के बारे में बताती है और वैल्यू से सहमति की स्थिति का पता चलता है. वैल्यू या तो true हो सकती है, जिसका मतलब है कि सहमति स्वीकार की गई या false का मतलब है कि सहमति अस्वीकार की गई.

   यूरोपियन इकनॉमिक एरिया (ईईए) में ट्रैफ़िक के लिए, सहमति मोड से जुड़े अपडेट के मुताबिक, ad_user_data और ad_personalization के लिए eu_consent_policy की वैल्यू सेट की जा सकती है. इसका मतलब है कि सहमति सिर्फ़ ईयू उपयोगकर्ता की सहमति से जुड़ी नीति के दायरे में आने वाले इलाकों के उपयोगकर्ताओं के लिए अस्वीकार की जाएगी.

   नीचे दी गई चीज़ें सेट करें:

   • GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE
   • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE
   • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA
   • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS

3. बदलावों को सेव करें. इसके बाद, सहमति की वैल्यू अपडेट करने का तरीका लागू करें.

उदाहरण के लिए, सभी पैरामीटर के लिए, अनुमतियों की सभी सहमति को डिफ़ॉल्ट रूप से सेट करने के लिए:

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

Analytics के कलेक्शन को फिर से चालू करना

उपयोगकर्ता की सहमति मिलने के बाद, setAnalyticsCollectionEnabled() इंस्टेंस वाले तरीके का इस्तेमाल करके, Analytics में डेटा कलेक्शन की सुविधा को फिर से चालू करें.

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

Analytics कलेक्शन अपडेट करने के लिए:

Swift

swift Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

obj-c [FIRAnalytics setAnalyticsCollectionEnabled:YES];

सहमति अपडेट करें

ऐप्लिकेशन लॉन्च होने के बाद, सहमति की वैल्यू अपडेट करने के लिए, setConsent तरीके को कॉल करें.

setConsent तरीके से सेट की गई वैल्यू, डिफ़ॉल्ट सेटिंग को बदल देती है. साथ ही, यह वैल्यू सभी ऐप्लिकेशन पर लागू रहती है. वैल्यू तब तक उसी स्थिति में रहती है, जब तक setConsent को फिर से कॉल नहीं किया जाता. भले ही, उपयोगकर्ता ऐप्लिकेशन को बंद करके फिर से चालू करता हो. setConsent सिर्फ़ आपके तय किए गए पैरामीटर को अपडेट करता है.

अगर कोई उपयोगकर्ता, Analytics या विज्ञापन के स्टोरेज के लिए पहले दी गई सहमति वापस ले लेता है, तो Google Analytics सभी उपयोगकर्ता प्रॉपर्टी मिटा देता है. इसमें ad_personalization के लिए दी गई सहमति भी शामिल है. दिलचस्पी के मुताबिक विज्ञापन दिखाने के लिए, उपयोगकर्ता की सहमति को बनाए रखने के लिए, setConsent का इस्तेमाल करके दिलचस्पी के मुताबिक विज्ञापन दिखाने की पिछली वैल्यू को पहले जैसा करें (Swift | Obj-C) .

इस उदाहरण में, सहमति की अलग-अलग वैल्यू को granted में अपडेट करने का setConsent तरीका दिखाया गया है:

Swift

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

Objective-C

[FIRAnalytics setConsent:@{
FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
FIRConsentTypeAdStorage : FIRConsentStatusGranted,
FIRConsentTypeAdUserData : FIRConsentStatusGranted,
FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

अगर कोई उपयोगकर्ता अपनी सहमति वापस लेना चाहता है, तो पक्का करें कि आपने सहमति की स्थितियों को उसी हिसाब से अपडेट किया हो और setAnalyticsCollectionEnabled() का इस्तेमाल करके, Analytics में डेटा इकट्ठा करने की सुविधा फिर से बंद करें.

सहमति मोड v2 में अपग्रेड करें

Google के लिए, डिजिटल विज्ञापन के ज़रिए उपयोगकर्ता की निजता को सुरक्षित रखने वाला नेटवर्क बनाना हमेशा से अहम रहा है. इसलिए, हम ईयू उपयोगकर्ता की सहमति से जुड़ी अपनी नीति का उल्लंघन ठीक करने के तरीके (एनफ़ोर्समेंट) को बेहतर बना रहे हैं.

Google के यूरोपियन इकनॉमिक एरिया (ईईए) में ट्रैफ़िक के लिए, सहमति मोड से जुड़े अपडेट के बारे में ज़्यादा जानें.

सहमति मोड के उपयोगकर्ताओं को, विज्ञापन के स्टोरेज और आंकड़ों के स्टोरेज के अलावा, दो नए पैरामीटर भेजने होंगे:

1. अपने ऐप्लिकेशन की Info.plist को अपडेट करें, ताकि यह शामिल किया जा सके:

   <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
   <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
   

2. उपयोगकर्ता के डेटा और दिलचस्पी के मुताबिक विज्ञापन दिखाने के पैरामीटर शामिल करने के लिए, सहमति वाले कॉल अपडेट करें:

   Swift

   Analytics.setConsent([
   .analyticsStorage: .granted,
   .adStorage: .granted,
   .adUserData: .granted,
   .adPersonalization: .granted,
   ])
   

   Objective-C

   [FIRAnalytics setConsent:@{
     FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
     FIRConsentTypeAdStorage : FIRConsentStatusGranted,
     FIRConsentTypeAdUserData : FIRConsentStatusGranted,
     FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
   }];
   

सहमति की सेटिंग की पुष्टि करें

Xcode डीबग कंसोल पर जाकर, इस बात की पुष्टि की जा सकती है कि सहमति की सेटिंग उम्मीद के मुताबिक काम कर रही हैं या नहीं.

यह तरीका अपनाएं:

1. अपने डिवाइस पर वर्बोज़ लॉगिंग सक्षम करें.

2. Xcode डीबग कंसोल में, यह देखें:

   • ad_storage
   • analytics_storage
   • ad_user_data
   • ad_personalization

   उदाहरण के लिए, अगर विज्ञापन के स्टोरेज की सुविधा चालू है, तो आपको यह मैसेज दिखेगा:

   ad_storage is granted.