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

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

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

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

iOS Android

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

शुरू करने से पहले

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

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

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

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

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

सहमति मोड सेट अप करने के लिए, आपको ये काम करने होंगे:

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

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

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

Analytics कलेक्शन को कुछ समय के लिए बंद करने के लिए, ऐप्लिकेशन टैग में अपने ऐप्लिकेशन के AndroidManifest.xml में firebase_analytics_collection_enabled की वैल्यू को false पर सेट करें. उदाहरण के लिए:

<meta-data android:name="firebase_analytics_collection_enabled" android:value="false" />

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

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

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

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

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

<meta-data android:name="google_analytics_default_allow_analytics_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />

Analytics कलेक्शन की सुविधा फिर से चालू करना

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

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

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

setAnalyticsCollectionEnabled(true);

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

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

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

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

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

Java

// Set consent types.
Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);

mFirebaseAnalytics.setConsent(consentMap);

Kotlin

Firebase.analytics.setConsent {
  analyticsStorage(ConsentStatus.GRANTED)
  adStorage(ConsentStatus.GRANTED)
  adUserData(ConsentStatus.GRANTED)
  adPersonalization(ConsentStatus.GRANTED)
}

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

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

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

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

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

1. अपने ऐप्लिकेशन के AndroidManifest.xml को अपडेट करें, ताकि इन चीज़ों को शामिल किया जा सके:

   <meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
   <meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />
   ```
   

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

   Java

   // Set consent types.
   Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
   consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
   consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
   consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
   consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);
   
   mFirebaseAnalytics.setConsent(consentMap);
   

   Kotlin

   Firebase.analytics.setConsent {
     analyticsStorage(ConsentStatus.GRANTED)
     adStorage(ConsentStatus.GRANTED)
     adUserData(ConsentStatus.GRANTED)
     adPersonalization(ConsentStatus.GRANTED)
   }
   

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

अपने ऐप्लिकेशन के लॉग मैसेज देखकर, इस बात की पुष्टि की जा सकती है कि सहमति की सेटिंग उम्मीद के मुताबिक काम कर रही हैं या नहीं.

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

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

2. Android Studio के लॉगकैट में, Setting consent से शुरू होने वाला लॉग मैसेज ढूंढें. उदाहरण के लिए, विज्ञापन का स्टोरेज चालू है, तो आपको यह लॉग मैसेज दिखेगा:

   Setting consent, ... AD_STORAGE=granted