يحدّد هذا الدليل الخطوات المطلوبة لدعم رسالة بموجب اللوائح التنظيمية في الولايات الأمريكية كجزء من حزمة تطوير البرامج لمنصة UMP. يُرجى استخدام هذه التعليمات مع مقالة البدء التي توضّح كيفية تشغيل تطبيقك باستخدام حزمة تطوير البرامج (SDK) لمنصّة UMP وإعداد رسالتك. الإرشادات التالية خاصة برسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية.
المتطلبات الأساسية
قبل المتابعة، يُرجى التأكّد من تنفيذ ما يلي:
- تثبيت أحدث إصدار من حزمة تطوير البرامج (SDK) لمنصّة UMP للحصول على الدعم في ما يتعلّق برسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية، ننصحك باستخدام الإصدار 2.1.0 أو إصدار أحدث.
- إعداد حزمة تطوير البرامج (SDK) لمنصّة UMP. يُرجى التأكّد من إنشاء نقطة دخول لخيارات الخصوصية وعرضها إذا لزم الأمر. بعد إكمال هذا الدليل، ستتوفّر لديك نقطة دخول لعرض رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية على المستخدمين.
- إنشاء رسالة بموجب اللوائح التنظيمية للولايات الأمريكية للتطبيقات
- إذا كنت تستخدم رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية إلى جانب رسائل أخرى ، يُرجى الاطّلاع على أنواع رسائل المستخدمين المتاحة لفهم متى يتم عرض الرسائل المختلفة للمستخدمين.
ضبط العلامة للقاصرين دون سن الرشد
للإشارة إلى ما إذا كان المستخدم دون سن الرشد، اضبط
setTagForUnderAgeOfConsent (TFUA). عند ضبط TFUA على true، لا تطلب حزمة تطوير البرامج (SDK) لمنصّة UMP موافقة المستخدم. إذا كان تطبيقك يستهدف جمهورًا مختلطًا، اضبط هذه المَعلمة للمستخدمين الأطفال لضمان عدم طلب الموافقة منهم.
تقع على عاتقك مسؤولية ضبط هذه المَعلمة عند الضرورة للامتثال لقانون حماية خصوصية الأطفال على الإنترنت (COPPA) واللوائح التنظيمية الأخرى ذات الصلة.
يضبط المثال التالي TFUA على "صحيح" في طلب الموافقة على منصّة UMP:
جافا
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 ->
// ...
})
قراءة خيارات الموافقة
بعد أن يتّخذ المستخدم قرارًا بموجب اللوائح التنظيمية في الولايات الأمريكية، يمكنك قراءة
خياره من وحدة التخزين المحلية باتّباع مواصفات إطار عمل Global Privacy Platform (GPP)
. لمزيد من التفاصيل، يُرجى الاطّلاع على
التفاصيل داخل التطبيق.
يُرجى العِلم أنّ حزمة تطوير البرامج (SDK) لمنصّة UMP لا تملأ إلا المفتاحَين IABGPP_GppSID وIABGPP_HDR_GppString.
اختبار رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية
لاختبار رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية، استخدِم UMPDebugGeographyRegulatedUSState debugGeography لإجبار حزمة تطوير البرامج (SDK) لمنصّة UMP على التعامل مع جهاز الاختبار كما لو كان موجودًا في ولاية أمريكية خاضعة للوائح التنظيمية. يمكنك أيضًا استخدام UMPDebugGeographyOther لإجبار حظر رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية. لمزيد من التفاصيل عن debugGeography، يُرجى الاطّلاع على
فرض منطقة جغرافية.