অ্যাপের জন্য সম্মতি মোড সেট-আপ করুন

এই পৃষ্ঠাটি এমন ডেভেলপারদের জন্য যারা তাদের অ্যাপে Firebase SDK-এর জন্য Google Analytics ব্যবহার করে এবং সম্মতি মোড সংহত করতে চায়। সম্মতি মোডের পরিচিতির জন্য, সম্মতি মোড ওভারভিউ পড়ুন।

Google Analytics আপনার ব্যবহারকারীদের সম্মতির অবস্থার উপর ভিত্তি করে আপনার SDK কীভাবে আচরণ করবে তা সামঞ্জস্য করতে সম্মতি মোড অফার করে। আপনি একটি মৌলিক বা উন্নত উপায়ে সম্মতি মোড প্রয়োগ করতে পারেন। আপনি যদি নিশ্চিত না হন যে মৌলিক বা উন্নত সম্মতি মোড প্রয়োগ করতে হবে, তাহলে মৌলিক বনাম উন্নত সম্মতি মোড সম্পর্কে আরও জানুন এবং আপনার কোম্পানির নির্দেশিকা দেখুন।

গুরুত্বপূর্ণ : যদি হয় ad_storage বা analytics_storage সম্মতি প্যারামিটারটি অস্বীকার করার জন্য সেট করা হয়, একটি ডিফল্ট সম্মতি অবস্থা বা setConsent পদ্ধতির মাধ্যমে, একটি নির্দিষ্ট অ্যাপ ইন্সট্যান্সের সাথে যুক্ত অ্যানালিটিক্স ডেটা স্থায়ীভাবে রিসেট করা হবে। উদাহরণ স্বরূপ, সমস্ত অ্যাপ ইন্সট্যান্সের জন্য অ্যানালিটিক্স ডেটা রিসেট করা হলে, ব্যবহারকারীর সংখ্যা বেড়ে যেতে পারে।

আপনি Firebase iOS SDK-এর জন্য Google Analytics ব্যবহার করলে, iOS SDK সংস্করণ 10.23.0-এ আপডেট করার মাধ্যমে আপনি এই সমস্যাটি প্রতিরোধ করতে পারেন। আপনি যদি Android SDK ব্যবহার করেন, তাহলে আপনি এই পদক্ষেপগুলি অনুসরণ করে এই সমস্যাটি প্রতিরোধ করতে পারেন:

1. আপনার অ্যাপের ম্যানিফেস্টে ad_storage এবং analytics_storage-এর জন্য ডিফল্ট মান সেট করবেন না।
2. অ্যাপ ইনস্ট্যান্সের ad_storage এবং analytics_storage সম্মতির অবস্থা সেট করার আগে Analytics সংগ্রহ অক্ষম করুন ।
3. আপনার ইতিবাচক সম্মতি পাওয়ার পরে, Analytics সংগ্রহ পুনরায় সক্ষম করুন , যা Analytics ডেটা পুনরায় সেট করবে না।

আপনি যদি একটি অ্যাপ্লিকেশন উদাহরণের জন্য বিশ্লেষণ পুনরায় সেট করতে চান, উদ্দেশ্য-নির্মিত API ব্যবহার করুন। একটি Android উদাহরণের জন্য এখানে দেখুন.

এই আচরণ সামঞ্জস্য করার জন্য আমরা আগামী সপ্তাহগুলিতে Firebase Android SDK-এর জন্য Google Analytics-এর জন্য একটি আপডেট প্রকাশ করব, তারপরে আপনি আপনার SDK আপডেট করতে পারবেন এবং আরও সম্মতি মোড পরিবর্তনগুলি আপনার অ্যাপের জন্য উপযুক্ত কিনা তা বিবেচনা করতে পারবেন।

উন্নত সম্মতি মোড মৌলিক সম্মতি মোড

iOS অ্যান্ড্রয়েড

গুরুত্বপূর্ণ : অ্যাপগুলির জন্য সম্মতি মোড 30শে অক্টোবর 2023 আপডেট করা হয়েছে এবং এখন দুটি অতিরিক্ত প্যারামিটার রয়েছে। আপনি যদি ইতিমধ্যেই সম্মতি মোড ব্যবহার করেন, তাহলে সম্মতি মোডে আপগ্রেড করুন v2 । ইউরোপিয়ান ইকোনমিক এরিয়া (EEA) এ ট্রাফিকের জন্য সম্মতি মোডে Google-এর আপডেট সম্পর্কে আরও জানুন।

তুমি শুরু করার আগে

আপনি ব্যবহারকারীর সম্মতি পরিচালনা করার আগে, আপনাকে বাস্তবায়ন করতে হবে:

• Firebase SDK-এর জন্য Google Analytics

• ব্যবহারকারীর সম্মতি ক্যাপচার করার জন্য একটি সম্মতি সেটিংস ব্যানার

  পরামর্শ: আপনি নিজে সম্মতি সেটিংস প্রয়োগ করতে না চাইলে, একটি সম্মতি ব্যবস্থাপনা প্ল্যাটফর্ম (CMP) ব্যবহার করার কথা বিবেচনা করুন।

সম্মতি মোড সেট আপ করুন

সম্মতি মোড সেট-আপ করতে, আপনাকে করতে হবে:

1. একজন ব্যবহারকারী সম্মতি দেওয়ার আগে: সাময়িকভাবে Analytics সংগ্রহ অক্ষম করুন ।
2. ডিফল্ট সম্মতি অবস্থা সেট করুন ।
3. আপনার সম্মতি সেটিংসের সাথে ব্যবহারকারীর ইন্টারঅ্যাকশনের উপর ভিত্তি করে সম্মতির অবস্থা আপডেট করুন ।
4. Analytics সংগ্রহ পুনরায় সক্ষম করুন ৷

সাময়িকভাবে Analytics সংগ্রহ অক্ষম করুন

সম্মতি মোডের একটি মৌলিক প্রয়োগের অর্থ হল Firebase SDK-এর জন্য Google 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 সংগ্রহ সেই অবস্থায় থাকে।

বিশ্লেষণ সংগ্রহ আপডেট করতে:

setAnalyticsCollectionEnabled(true);

সম্মতি আপডেট করুন

একটি অ্যাপ চালু হওয়ার পরে সম্মতির মান আপডেট করতে, setConsent পদ্ধতিতে কল করুন।

setConsent পদ্ধতি দ্বারা সেট করা মান ডিফল্ট সেটিংকে ওভাররাইড করে এবং অ্যাপ এক্সিকিউশন জুড়ে টিকে থাকে। setConsent আবার কল না করা পর্যন্ত মানটি সেই অবস্থায় থাকে, এমনকি যদি একজন ব্যবহারকারী অ্যাপটি বন্ধ করে আবার খুলেন। setConsent শুধুমাত্র আপনার নির্দিষ্ট করা প্যারামিটার আপডেট করে।

যদি কোনো ব্যবহারকারী অ্যানালিটিক্স বা বিজ্ঞাপন স্টোরেজের জন্য তাদের পূর্বে দেওয়া সম্মতি প্রত্যাহার করে নেয়, Google Analytics সমস্ত ব্যবহারকারীর বৈশিষ্ট্য মুছে দেয়, যার মধ্যে ad_personalization এর জন্য সম্মতি রয়েছে। বিজ্ঞাপন ব্যক্তিগতকরণের জন্য ব্যবহারকারীর সম্মতির পছন্দ সংরক্ষণ করতে, setConsent( Kotlin+KTX | Java ) ব্যবহার করে বিজ্ঞাপন ব্যক্তিগতকরণের পূর্ববর্তী মান পুনরুদ্ধার করুন।

নিম্নলিখিত উদাহরণটি দেখায় যে setConsent পদ্ধতিটি granted বিভিন্ন সম্মতির মান আপডেট করে:

জাভা

// 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);

কোটলিন

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