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

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

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

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

अगर 'Firebase के लिए Google Analytics' iOS SDK टूल का इस्तेमाल किया जाता है, तो iOS SDK टूल को 10.23.0 पर अपडेट करके इस समस्या से बचा जा सकता है. अगर Android SDK इस्तेमाल किया जाता है, तो इस समस्या से बचा जा सकता है:

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

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

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

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

iOS Android

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

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

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

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

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

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

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

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

1. सहमति की डिफ़ॉल्ट स्थिति सेट करें.

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

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

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" />

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

ऐप्लिकेशन लॉन्च होने के बाद सहमति की वैल्यू अपडेट करने के लिए, 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)
}