تنظیم حالت رضایت برای برنامه ها، تنظیم حالت رضایت برای برنامه ها

این صفحه برای توسعه دهندگانی است که از Google Analytics برای Firebase SDK در برنامه خود استفاده می کنند و می خواهند حالت رضایت را ادغام کنند. برای آشنایی با حالت رضایت، نمای کلی حالت رضایت را بخوانید.

Google Analytics حالت رضایت را برای تنظیم نحوه رفتار SDK شما بر اساس وضعیت رضایت کاربران ارائه می دهد. شما می توانید حالت رضایت را به صورت پایه یا پیشرفته پیاده سازی کنید. اگر مطمئن نیستید که حالت رضایت اولیه یا پیشرفته را اجرا کنید، درباره حالت رضایت اولیه در مقابل پیشرفته بیشتر بدانید و دستورالعمل‌های شرکت خود را بررسی کنید.

قبل از شروع

قبل از اینکه بتوانید رضایت کاربر را مدیریت کنید، باید موارد زیر را اجرا کنید:

• Google Analytics برای Firebase SDK

• یک بنر تنظیمات رضایت برای گرفتن رضایت کاربر

حالت رضایت را تنظیم کنید

برای تنظیم حالت رضایت، باید:

1. وضعیت رضایت پیش فرض را تنظیم کنید .

وضعیت رضایت پیش فرض را تنظیم کنید

به طور پیش فرض، هیچ مقدار حالت رضایت تنظیم نشده است. برای تنظیم وضعیت رضایت پیش‌فرض برای برنامه‌تان:

1. فایل info.plist برنامه خود را باز کنید.

2. جفت‌های کلید-مقدار حالت رضایت را اضافه کنید. کلید نوع رضایت را توصیف می کند و مقدار نشان دهنده وضعیت رضایت است. ارزش‌ها می‌توانند 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

3. تغییرات خود را ذخیره کنید سپس، مکانیسمی را برای به‌روزرسانی مقادیر رضایت اجرا کنید.

به عنوان مثال، برای تنظیم تمام رضایت نامه برای همه پارامترها به طور پیش فرض:

<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 بازیابی کنید.( سوئیفت | Obj-C ).

مثال زیر روش setConsent را نشان می دهد که مقادیر رضایت متفاوت را به granted به روز می کند:

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

اگر کاربر تصمیم گرفت رضایت خود را لغو کند، مطمئن شوید که وضعیت رضایت را بر این اساس به‌روزرسانی کرده‌اید

به حالت رضایت نسخه 2 ارتقا دهید

به عنوان بخشی از تعهد مداوم Google به یک اکوسیستم تبلیغات دیجیتال ایمن برای حفظ حریم خصوصی، ما در حال تقویت اجرای سیاست رضایت کاربر اتحادیه اروپا هستیم.

درباره به‌روزرسانی‌های Google برای حالت رضایت برای ترافیک در منطقه اقتصادی اروپا (EEA) بیشتر بیاموزید.

کاربران حالت رضایت علاوه بر ذخیره سازی تبلیغات و ذخیره سازی تجزیه و تحلیل، باید دو پارامتر جدید ارسال کنند:

1. info.plist برنامه خود را به‌روزرسانی کنید تا شامل موارد زیر باشد:

   <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
   <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
   

2. تماس‌های رضایت خود را به‌روزرسانی کنید تا پارامترهای مربوط به داده‌های کاربر آگهی و شخصی‌سازی آگهی را شامل شود:

   سویفت

   Analytics.setConsent([
   .analyticsStorage: .granted,
   .adStorage: .granted,
   .adUserData: .granted,
   .adPersonalization: .granted,
   ])
   

   هدف-C

   [FIRAnalytics setConsent:@{
     FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
     FIRConsentTypeAdStorage : FIRConsentStatusGranted,
     FIRConsentTypeAdUserData : FIRConsentStatusGranted,
     FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
   }];
   

تنظیمات رضایت را تأیید کنید

با مشاهده کنسول اشکال‌زدایی Xcode برای برنامه‌تان، می‌توانید تأیید کنید که تنظیمات رضایت شما طبق برنامه کار می‌کند.

این مراحل را دنبال کنید:

1. ثبت نام کامل را در دستگاه خود فعال کنید .

2. در کنسول اشکال زدایی Xcode، به دنبال:

   • ad_storage
   • analytics_storage
   • ad_user_data
   • ad_personalization

   به عنوان مثال، اگر فضای ذخیره آگهی فعال باشد، پیام زیر را مشاهده خواهید کرد:

   ad_storage is granted.