این راهنما مراحل لازم برای پشتیبانی از پیام مقررات ایالتی امریکا را بهعنوان بخشی از کیت توسعه نرمافزار UMP شرح میدهد. این دستورالعملها را با راهاندازی کیت توسعه نرمافزار «پلاتفرم پیامرسانی کاربر» جفت کنید که جزئیات نحوه اجرای برنامه با کیت توسعه نرمافزار «پلاتفرم پیامرسانی کاربر» و راهاندازی پیام را ارائه میدهد. راهنمایی زیر مختص پیام مقررات ایالتهای امریکا است.
پیشنیازها
قبلاز ادامه دادن، مطمئن شوید که کارهای زیر را انجام دادهاید:
- به جدیدترین نسخه کیت توسعه نرمافزار UMP بهروزرسانی کنید. برای پشتیبانی از پیامرسانی مقررات ایالتی امریکا، توصیه میکنیم از نسخه ۲.۱.۰ یا بالاتر استفاده کنید.
- راهاندازی کردن کیت توسعه نرمافزار UMP. حتماً نقطه ورودی گزینههای حریم خصوصی را پیادهسازی کنید و درصورت لزوم آن را ارائه دهید. با تکمیل این راهنما، نقطه ورودی برای ارائه پیام مقررات ایالتهای ایالات متحده به کاربران خود خواهید داشت.
- ایجاد پیام مقررات ایالتی امریکا برای برنامهها.
- اگر از پیام مقررات ایالتی امریکا در کنار پیامهای دیگر استفاده میکنید، به انواع پیامهای کاربر دردسترس مراجعه کنید تا متوجه شوید پیامهای مختلف چه زمانی به کاربران شما نمایش داده میشوند.
تنظیم برچسب برای زیر سن قانونی
برای نشان دادن اینکه کاربر زیر سن قانونی است،
setTagForUnderAgeOfConsent (TFUA) را تنظیم کنید. وقتی TFUA را روی true تنظیم میکنید، UMP SDK
از کاربر درخواست رضایت نمیکند. اگر برنامهتان مخاطب مختلط دارد، این پارامتر را برای کاربران کودک تنظیم کنید تا مطمئن شوید رضایت درخواست نمیشود.
مسئولیت تنظیم این پارامتر در جایی که برای رعایت COPPA و سایر مقررات مربوطه لازم است، برعهده شما است.
مثال زیر TFUA را در درخواست رضایت UMP روی true تنظیم میکند:
جاوا
ConsentRequestParameters params = new ConsentRequestParameters
.Builder()
// Indicate the user is under age of consent.
.setTagForUnderAgeOfConsent(true)
.build();
consentInformation = UserMessagingPlatform.getConsentInformation(this);
consentInformation.requestConsentInfoUpdate(
this,
params,
(OnConsentInfoUpdateSuccessListener) () -> {
// ...
},
(OnConsentInfoUpdateFailureListener) requestConsentError -> {
// ...
});
Kotlin
val params = ConsentRequestParameters
.Builder()
// Indicate the user is under age of consent.
.setTagForUnderAgeOfConsent(true)
.build()
consentInformation = UserMessagingPlatform.getConsentInformation(this)
consentInformation.requestConsentInfoUpdate(
this,
params,
ConsentInformation.OnConsentInfoUpdateSuccessListener {
// ...
},
ConsentInformation.OnConsentInfoUpdateFailureListener {
requestConsentError ->
// ...
})
خواندن انتخابهای رضایت
پساز اینکه کاربر تصمیم خود را درباره مقررات ایالتهای امریکا گرفت، میتوانید انتخاب او را از فضای ذخیرهسازی محلی مطابق با مشخصات «پلاتفرم حریم خصوصی جهانی» (GPP) بخوانید. برای جزئیات بیشتر، به جزئیات درونبرنامه مراجعه کنید.
توجه داشته باشید که کیت توسعه نرمافزار «پلاتفرم پیامرسانی کاربر» فقط کلیدهای IABGPP_GppSID و
IABGPP_HDR_GppString را پر میکند.
آزمایش کردن پیامرسانی مقررات ایالتی امریکا
برای آزمایش پیامرسانی مقررات ایالتهای ایالات متحده، ازUMPDebugGeographyRegulatedUSState debugGeography استفاده کنید تا UMP
SDK را مجبور کنید با دستگاه آزمایشی شما طوری رفتار کند که گویی دستگاه در یکی از ایالتهای ایالات متحده با مقررات خاص
قرار دارد. همچنین میتوانید از UMPDebugGeographyOther برای توقف اجباری پیامهای مقررات ایالتی امریکا استفاده کنید. برای جزئیات بیشتر درباره debugGeography،
اجباری کردن منطقه جغرافیایی را ببینید.
توجه: UMPDebugGeographyRegulatedUSState فقط در
UMP نسخه
۳.۱.۰
یا بالاتر دردسترس است.