این صفحه برای توسعه دهندگانی است که از Google Analytics برای Firebase SDK در برنامه خود استفاده می کنند و می خواهند حالت رضایت را ادغام کنند. برای آشنایی با حالت رضایت، نمای کلی حالت رضایت را بخوانید.
Google Analytics حالت رضایت را برای تنظیم نحوه رفتار SDK شما بر اساس وضعیت رضایت کاربران ارائه می دهد. شما می توانید حالت رضایت را به صورت پایه یا پیشرفته پیاده سازی کنید. اگر مطمئن نیستید که حالت رضایت اولیه یا پیشرفته را اجرا کنید، درباره حالت رضایت اولیه در مقابل پیشرفته بیشتر بدانید و دستورالعملهای شرکت خود را بررسی کنید.
قبل از شروع
قبل از اینکه بتوانید رضایت کاربر را مدیریت کنید، باید موارد زیر را اجرا کنید:
- Google Analytics برای Firebase SDK
یک بنر تنظیمات رضایت برای گرفتن رضایت کاربر
حالت رضایت را تنظیم کنید
برای تنظیم حالت رضایت، باید:
- قبل از اینکه کاربر رضایت دهد: مجموعه Analytics را موقتاً غیرفعال کنید .
- وضعیت رضایت پیش فرض را تنظیم کنید .
- وضعیت رضایت را بر اساس تعامل کاربر با تنظیمات رضایت خود بهروزرسانی کنید .
- مجموعه Analytics را دوباره فعال کنید .
مجموعه Analytics را موقتاً غیرفعال کنید
اجرای اولیه حالت رضایت به معنای مسدود کردن بارگیری Google Analytics برای Firebase SDK تا زمانی که کاربر رضایت خود را اعلام کند، است.
برای غیرفعال کردن موقت مجموعه Analytics، مقدارFIREBASE_ANALYTICS_COLLECTION_ENABLED
را روی false
(بولی) در فایل Info.plist
برنامه خود تنظیم کنید. به عنوان مثال، مشاهده شده در منبع XML:<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>
وضعیت رضایت پیش فرض را تنظیم کنید
به طور پیش فرض، هیچ مقدار حالت رضایت تنظیم نشده است. برای تنظیم وضعیت رضایت پیشفرض برای برنامهتان:
- فایل info.plist برنامه خود را باز کنید.
جفتهای کلید-مقدار حالت رضایت را اضافه کنید. کلید نوع رضایت را توصیف می کند و مقدار نشان دهنده وضعیت رضایت است. ارزشها میتوانند
true
باشند، یعنی رضایت داده شد، یاfalse
، یعنی رضایت رد شد.مطابق با بهروزرسانیهای حالت رضایت برای ترافیک در منطقه اقتصادی اروپا (EEA)، مقدار
eu_consent_policy
را میتوان برایad_user_data
وad_personalization
تنظیم کرد، به این معنی که رضایت فقط برای کاربران مناطق مشمول خطمشی رضایت کاربر اتحادیه اروپا رد میشود.موارد زیر را تنظیم کنید:
-
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
-
تغییرات خود را ذخیره کنید سپس، مکانیسمی را برای بهروزرسانی مقادیر رضایت اجرا کنید.
به عنوان مثال، برای تنظیم تمام رضایت نامه برای همه پارامترها به طور پیش فرض:
<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/>
مجموعه Analytics را دوباره فعال کنید
پس از رضایت کاربر، مجموعه Analytics را دوباره با استفاده از روش نمونه setAnalyticsCollectionEnabled()
فعال کنید.
مقدار تنظیم شده توسط روش setAnalyticsCollectionEnabled
در سراسر اجرای برنامه باقی می ماند و مقدار firebase_analytics_collection_enabled
در فایل Info.plist
برنامه شما را لغو می کند. هنگامی که مقداری را برای setAnalyticsCollectionEnabled
تنظیم کردید، مجموعه Analytics در آن حالت باقی می ماند تا زمانی که setAnalyticsCollectionEnabled
دوباره فراخوانی شود، حتی اگر کاربر برنامه شما را ببندد و دوباره باز کند.
برای به روز رسانی مجموعه Analytics:
سویفت
swift Analytics.setAnalyticsCollectionEnabled(true)
هدف-C
obj-c [FIRAnalytics setAnalyticsCollectionEnabled:YES];
بهروزرسانی رضایت
برای بهروزرسانی مقادیر رضایت پس از راهاندازی برنامه، با روش setConsent
تماس بگیرید.
مقدار تنظیم شده توسط روش setConsent
تنظیم پیش فرض را لغو می کند و در اجرای برنامه ها باقی می ماند. این مقدار تا زمانی که setConsent
دوباره فراخوانی نشود، در آن حالت باقی میماند، حتی اگر کاربر برنامه را ببندد و دوباره باز کند. setConsent
فقط پارامترهایی را که شما مشخص کرده اید به روز می کند.
اگر کاربری رضایت قبلی خود را برای Analytics یا ذخیرهسازی آگهی پس بگیرد، Google Analytics همه ویژگیهای کاربر، از جمله رضایت برای
ad_personalization
را حذف میکند. برای حفظ رضایت کاربر برای شخصیسازی آگهی، مقدار قبلی را برای شخصیسازی آگهی با استفاده ازsetConsent
بازیابی کنید.( سوئیفت | Obj-C ).
مثال زیر روش setConsent
را نشان می دهد که مقادیر رضایت متفاوت را به granted
به روز می کند:
سویفت
Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])
هدف-C
[FIRAnalytics setConsent:@{
FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
FIRConsentTypeAdStorage : FIRConsentStatusGranted,
FIRConsentTypeAdUserData : FIRConsentStatusGranted,
FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];
اگر کاربر تصمیم گرفت رضایت خود را لغو کند، مطمئن شوید که وضعیت رضایت را بر این اساس بهروزرسانی کردهایدو دوباره مجموعه Analytics را با استفاده از setAnalyticsCollectionEnabled()
غیرفعال کنید.
به حالت رضایت نسخه 2 ارتقا دهید
به عنوان بخشی از تعهد مداوم Google به یک اکوسیستم تبلیغات دیجیتال ایمن برای حفظ حریم خصوصی، ما در حال تقویت اجرای سیاست رضایت کاربر اتحادیه اروپا هستیم.
درباره بهروزرسانیهای Google برای حالت رضایت برای ترافیک در منطقه اقتصادی اروپا (EEA) بیشتر بیاموزید.
کاربران حالت رضایت علاوه بر ذخیره سازی تبلیغات و ذخیره سازی تجزیه و تحلیل، باید دو پارامتر جدید ارسال کنند:
info.plist برنامه خود را بهروزرسانی کنید تا شامل موارد زیر باشد:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/> <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
تماسهای رضایت خود را بهروزرسانی کنید تا پارامترهای مربوط به دادههای کاربر آگهی و شخصیسازی آگهی را شامل شود:
سویفت
Analytics.setConsent([ .analyticsStorage: .granted, .adStorage: .granted, .adUserData: .granted, .adPersonalization: .granted, ])
هدف-C
[FIRAnalytics setConsent:@{ FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted, FIRConsentTypeAdStorage : FIRConsentStatusGranted, FIRConsentTypeAdUserData : FIRConsentStatusGranted, FIRConsentTypeAdPersonalization : FIRConsentStatusGranted, }];
تنظیمات رضایت را تأیید کنید
با مشاهده کنسول اشکالزدایی Xcode برای برنامهتان، میتوانید تأیید کنید که تنظیمات رضایت شما طبق برنامه کار میکند.
این مراحل را دنبال کنید:
- ثبت نام کامل را در دستگاه خود فعال کنید .
در کنسول اشکال زدایی Xcode، به دنبال:
-
ad_storage
-
analytics_storage
-
ad_user_data
-
ad_personalization
به عنوان مثال، اگر فضای ذخیره آگهی فعال باشد، پیام زیر را مشاهده خواهید کرد:
ad_storage is granted.
-