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

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

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

قبل از اینکه شروع کنی

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

  • گوگل آنالیتیکس برای فایربیس 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 یا Ad storage پس بگیرد، 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,
}];

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

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

درباره به‌روزرسانی‌های گوگل برای حالت رضایت برای ترافیک در منطقه اقتصادی اروپا (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,
])

    هدف-سی 

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

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

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

  1. قابلیت ثبت وقایع به صورت شفاهی (verbose logging) را در دستگاه خود فعال کنید .

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

    • ad_storage
    • analytics_storage
    • ad_user_data
    • ad_personalization

    برای مثال، اگر گزینه‌ی ذخیره‌سازی تبلیغات فعال باشد، پیام زیر را مشاهده خواهید کرد: 

    ad_storage is granted.