यह पेज उन डेवलपर के लिए है जो अपने ऐप्लिकेशन में, 'Firebase के लिए Google Analytics' SDK टूल का इस्तेमाल करते हैं और सहमति मोड को इंटिग्रेट करना चाहते हैं. सहमति मोड के बारे में जानने के लिए, सहमति मोड की खास जानकारी लेख पढ़ें.
Google Analytics, सहमति मोड की सुविधा देता है. इसकी मदद से, उपयोगकर्ताओं की सहमति की स्थिति के आधार पर, एसडीके के काम करने के तरीके में बदलाव किया जा सकता है. सहमति मोड को बेसिक या ऐडवांस तरीके से लागू किया जा सकता है. अगर आपको यह तय करने में मुश्किल हो रही है कि सहमति मोड का बेसिक वर्शन लागू किया जाए या ऐडवांस, तो सहमति मोड के बेसिक और ऐडवांस वर्शन के बारे में ज़्यादा जानें. साथ ही, अपनी कंपनी की गाइडलाइन देखें.
शुरू करने से पहले
उपयोगकर्ता की सहमति मैनेज करने से पहले, आपको ये काम करने होंगे:
- 'Firebase के लिए Google Analytics' SDK टूल लागू करना
उपयोगकर्ता की सहमति कैप्चर करने के लिए, सहमति की सेटिंग वाला बैनर लागू करना
सहमति मोड सेट अप करना
सहमति मोड सेट अप करने के लिए, आपको ये काम करने होंगे:
सहमति की डिफ़ॉल्ट स्थिति सेट करना
डिफ़ॉल्ट रूप से, सहमति मोड की कोई वैल्यू सेट नहीं होती. अपने ऐप्लिकेशन के लिए, सहमति की डिफ़ॉल्ट स्थिति सेट करने के लिए:
- अपने ऐप्लिकेशन की info.plist फ़ाइल खोलें.
सहमति मोड के की-वैल्यू पेयर जोड़ें. की, सहमति के टाइप के बारे में बताती है. वहीं, वैल्यू, सहमति की स्थिति के बारे में बताती है. वैल्यू,
trueहो सकती है. इसका मतलब है कि सहमति दी गई है. इसके अलावा, वैल्यूfalseभी हो सकती है. इसका मतलब है कि सहमति नहीं दी गई है.यूरोपियन इकनॉमिक एरिया (ईईए) में ट्रैफ़िक के लिए, सहमति मोड से जुड़े अपडेट के मुताबिक,
ad_user_dataऔरad_personalizationके लिए,eu_consent_policyकी वैल्यू सेट की जा सकती है. इसका मतलब है कि सहमति सिर्फ़ उन इलाकों के उपयोगकर्ताओं के लिए नहीं दी गई है जिन पर ईयू उपयोगकर्ता की सहमति से जुड़ी नीति लागू होती है.इन्हें सेट करें:
GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGEGOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGEGOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATAGOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS
बदलावों को सेव करें. इसके बाद, सहमति की वैल्यू अपडेट करने के लिए, कोई तरीका लागू करें.
उदाहरण के लिए, डिफ़ॉल्ट रूप से सभी पैरामीटर के लिए, सहमति देने की स्थिति सेट करने के लिए:
<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/>
सहमति अपडेट करें
ऐप्लिकेशन लॉन्च होने के बाद, सहमति की वैल्यू अपडेट करने के लिए,
setConsent तरीके को कॉल करें.
setConsent तरीके से सेट की गई वैल्यू, डिफ़ॉल्ट सेटिंग को बदल देती है. साथ ही, यह ऐप्लिकेशन के सभी वर्शन में बनी रहती है. वैल्यू तब तक उसी स्थिति में बनी रहती है, जब तक setConsent को फिर से कॉल न किया जाए. भले ही, कोई उपयोगकर्ता ऐप्लिकेशन बंद करके फिर से खोल ले. setConsent सिर्फ़ उन पैरामीटर को अपडेट करता है जिन्हें आपने तय किया है.
अगर कोई उपयोगकर्ता, Analytics या विज्ञापन स्टोरेज के लिए पहले दी गई सहमति वापस लेता है, तो Google Analytics, उपयोगकर्ता की सभी प्रॉपर्टी मिटा देता है. इनमें सहमति भी शामिल है
ad_personalization. विज्ञापन के हिसाब से दिलचस्पी के मुताबिक विज्ञापन दिखाने की सुविधा के लिए, उपयोगकर्ता की सहमति की पसंद को बनाए रखने के लिए, विज्ञापन के हिसाब से दिलचस्पी के मुताबिक विज्ञापन दिखाने की सुविधा के लिए पिछली वैल्यू कोsetConsent(Swift | Obj-C) का इस्तेमाल करके वापस लाएं.
यहां दिए गए उदाहरण में, setConsent तरीका, सहमति की अलग-अलग वैल्यू को granted पर अपडेट करता है:
Swift
Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])
Objective-C
[FIRAnalytics setConsent:@{
FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
FIRConsentTypeAdStorage : FIRConsentStatusGranted,
FIRConsentTypeAdUserData : FIRConsentStatusGranted,
FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];
अगर कोई उपयोगकर्ता अपनी सहमति वापस लेने का फ़ैसला करता है, तो पक्का करें कि आपने सहमति की स्थितियों को अपडेट कर दिया हो और Analytics कलेक्शन को फिर से बंद कर दिया हो
सहमति मोड v2 पर अपग्रेड करना
Google के लिए, निजता को ध्यान में रखते हुए डिजिटल विज्ञापन नेटवर्क बनाना हमेशा से अहम रहा है. इसलिए, हम ईयू उपयोगकर्ता की सहमति से जुड़ी अपनी नीति का उल्लंघन ठीक करने के तरीके (एनफ़ोर्समेंट) को बेहतर बना रहे हैं.
यूरोपियन इकनॉमिक एरिया (ईईए) में ट्रैफ़िक के लिए, सहमति मोड से जुड़े Google के अपडेट के बारे में ज़्यादा जानें .
सहमति मोड का इस्तेमाल करने वाले लोगों को, विज्ञापन स्टोरेज और Analytics स्टोरेज के अलावा, दो नए पैरामीटर भेजने होंगे:
अपने ऐप्लिकेशन की info.plist फ़ाइल को अपडेट करें, ताकि इसमें ये शामिल हों:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/> <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>सहमति के लिए किए जाने वाले कॉल को अपडेट करें, ताकि इनमें विज्ञापन के हिसाब से उपयोगकर्ता का डेटा और विज्ञापन के हिसाब से दिलचस्पी के मुताबिक विज्ञापन दिखाने की सुविधा के पैरामीटर शामिल हों:
Swift
Analytics.setConsent([ .analyticsStorage: .granted, .adStorage: .granted, .adUserData: .granted, .adPersonalization: .granted, ])Objective-C
[FIRAnalytics setConsent:@{ FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted, FIRConsentTypeAdStorage : FIRConsentStatusGranted, FIRConsentTypeAdUserData : FIRConsentStatusGranted, FIRConsentTypeAdPersonalization : FIRConsentStatusGranted, }];
सहमति की सेटिंग की पुष्टि करना
अपने ऐप्लिकेशन के Xcode डीबग कंसोल को देखकर, यह पुष्टि की जा सकती है कि सहमति की सेटिंग, उम्मीद के मुताबिक काम कर रही हैं या नहीं.
यह तरीका अपनाएं:
- अपने डिवाइस पर वर्बोस लॉगिंग चालू करें.
Xcode डीबग कंसोल में, इन्हें ढूंढें:
ad_storageanalytics_storagead_user_dataad_personalization
उदाहरण के लिए, अगर विज्ञापन स्टोरेज चालू है, तो आपको यह मैसेज दिखेगा:
ad_storage is granted.