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

यह पेज उन डेवलपर के लिए है जो अपने ऐप्लिकेशन में, '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 में डेटा इकट्ठा करने की सुविधा को कुछ समय के लिए बंद करने के लिए, ऐप्लिकेशन टैग में अपने ऐप्लिकेशन के AndroidManifest.xml में firebase_analytics_collection_enabled की वैल्यू को false पर सेट करें. उदाहरण के लिए:

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

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

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

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

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

   • 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 के लिए वैल्यू सेट करने के बाद, जब तक setAnalyticsCollectionEnabled को फिर से कॉल नहीं किया जाता, तब तक Analytics कलेक्शन उसी स्थिति में रहता है. भले ही, उपयोगकर्ता आपके ऐप्लिकेशन को बंद करके फिर से खोलता हो.

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)
}