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

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

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

अहम जानकारी: अगर ad_storage या analytics_storage सहमति पैरामीटर को सहमति की डिफ़ॉल्ट स्थिति या setConsent का तरीका में जाकर, 'अस्वीकार किया गया' पर सेट किया गया है, तो किसी खास ऐप्लिकेशन इंस्टेंस से जुड़ा Analytics डेटा हमेशा के लिए रीसेट कर दिया जाएगा. उदाहरण के लिए, अगर ऐप्लिकेशन के सभी इंस्टेंस के लिए आंकड़ों का डेटा रीसेट किया जाता है, तो उपयोगकर्ताओं की संख्या बढ़ सकती है.

• iOS: 10.23.0 या इसके बाद के वर्शन में अपडेट करके, इस समस्या को रोका जा सकता है.
• Android: Google Play सेवाओं वाले डिवाइसों को अपने-आप एक अपडेट मिल गया है और उन डिवाइसों पर अब यह समस्या नहीं है. आपको कोई और कार्रवाई करने की ज़रूरत नहीं है.

अगर आपका ऐप्लिकेशन ऐसे डिवाइसों पर काम करता है जिनमें Google Play services नहीं है, तो इस तरह के व्यवहार को रोकने के लिए, आने वाले 22.0.1 रिलीज़ में, Android SDK को अपडेट किया जा सकेगा. तब तक, इन डिवाइसों पर इस समस्या को रोका जा सकता है. इसके लिए, यह तरीका अपनाएं:

1. अपने ऐप्लिकेशन के मेनिफ़ेस्ट में, ad_storage और analytics_storage के लिए डिफ़ॉल्ट वैल्यू सेट न करें.
2. ऐप्लिकेशन इंस्टेंस का ad_storage और analytics_storage सहमति की स्थिति सेट करने से पहले, Analytics कलेक्शन बंद करें.
3. लोगों से मिली सहमति के बाद, Analytics कलेक्शन की सुविधा फिर से चालू करें. इससे, आंकड़ों का डेटा रीसेट नहीं होगा.

अगर आपको किसी ऐप्लिकेशन इंस्टेंस के लिए, Analytics को रीसेट करना है, तो मकसद के हिसाब से बनाए गए एपीआई का इस्तेमाल करें. Android का उदाहरण देखने के लिए यहां देखें.

बेहतर सहमति मोड बुनियादी सहमति मोड

iOS Android

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

शुरू करने से पहले, इन बातों का ध्यान रखें

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

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

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

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

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

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

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

Analytics कलेक्शन को कुछ समय के लिए बंद करना

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

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

setAnalyticsCollectionEnabled(true);

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

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

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

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

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

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