يحدّد هذا الدليل الخطوات المطلوبة لدعم رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية كجزء من حزمة تطوير البرامج (SDK) لمنصّة UMP. يُرجى استخدام هذه التعليمات مع مقالة بدء الاستخدام التي توضّح كيفية تشغيل تطبيقك باستخدام حزمة تطوير البرامج (SDK) لمنصّة UMP وإعداد رسالتك. الإرشادات التالية خاصة برسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية.
المتطلبات الأساسية
قبل المتابعة، يُرجى التأكّد من إجراء ما يلي:
- تثبيت أحدث إصدار من حزمة تطوير البرامج (SDK) لمنصّة UMP للحصول على الدعم في ما يتعلّق برسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية، ننصحك باستخدام الإصدار 2.1.0 أو إصدار أحدث.
- إعداد حزمة تطوير البرامج (SDK) لمنصّة UMP. يُرجى التأكّد من تنفيذ نقطة دخول لخيارات الخصوصية وعرضها إذا لزم الأمر. من خلال إكمال هذا الدليل، سيكون لديك نقطة دخول لعرض رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية للمستخدمين.
- إنشاء رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية للتطبيقات
- إذا كنت تستخدم رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية إلى جانب رسائل أخرى، يُرجى الاطّلاع على أنواع رسائل المستخدمين المتاحة للتعرّف على الحالات التي يتم فيها عرض الرسائل المختلفة للمستخدمين.
ضبط العلامة للمستخدمين دون سن الرشد
للإشارة إلى ما إذا كان المستخدم دون سن الرشد، اضبط
tagForUnderAgeOfConsent (TFUA). عند ضبط TFUA على true، لا تطلب حزمة تطوير البرامج (SDK) لمنصّة UMP الموافقة من المستخدم. إذا كان تطبيقك يستهدف جمهورًا مختلطًا، اضبط هذه المَعلمة للمستخدمين الأطفال لضمان عدم طلب الموافقة منهم.
تقع على عاتقك مسؤولية ضبط هذه المَعلمة عند الضرورة للامتثال لقانون حماية خصوصية الأطفال على الإنترنت (COPPA) واللوائح التنظيمية الأخرى ذات الصلة.
يضبط المثال التالي TFUA على "صحيح" في طلب موافقة من منصّة UMP:
Swift
// Create a UMPRequestParameters object.
let parameters = RequestParameters()
// Indicate the user is under age of consent.
parameters.isTaggedForUnderAgeOfConsent = true
// Request an update for the consent information.
ConsentInformation.shared.requestConsentInfoUpdate(with: parameters) {
[weak self] requestConsentError in
guard let self else { return }
// ...
}
Objective-C
// Create a UMPRequestParameters object.
UMPRequestParameters *parameters = [[UMPRequestParameters alloc] init];
// Indicate the user is under age of consent.
parameters.tagForUnderAgeOfConsent = YES;
// Request an update for the consent information.
[UMPConsentInformation.sharedInstance
requestConsentInfoUpdateWithParameters:parameters
completionHandler:^(NSError *_Nullable requestConsentError) {
// ...
}];
قراءة خيارات الموافقة
بعد أن يتّخذ المستخدم قرارًا بموجب اللوائح التنظيمية في الولايات الأمريكية، يمكنك قراءة
خياره من وحدة التخزين المحلية باتّباع مواصفات إطار عمل Global Privacy Platform (GPP)
. لمزيد من التفاصيل، يُرجى الاطّلاع على
التفاصيل داخل التطبيق.
يُرجى العِلم أنّ حزمة تطوير البرامج (SDK) لمنصّة UMP لا تملأ إلا المفتاحَين IABGPP_GppSID وIABGPP_HDR_GppString.
اختبار رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية
لاختبار رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية، استخدِم UMPDebugGeographyRegulatedUSState debugGeography لإجبار حزمة تطوير البرامج (SDK) لمنصّة UMP على التعامل مع جهاز الاختبار كما لو كان موجودًا في ولاية أمريكية خاضعة للوائح التنظيمية. يمكنك أيضًا استخدام UMPDebugGeographyOther لإجبار حظر رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية. لمزيد من التفاصيل عن debugGeography، يُرجى الاطّلاع على
إجبار منطقة جغرافية.