يحدّد هذا الدليل الخطوات المطلوبة لاستخدام رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية كجزء من حزمة تطوير البرامج (SDK) لمنصّة UMP. يُرجى استخدام هذه التعليمات مع مقالة إعداد حزمة تطوير البرامج (SDK) لمنصّة UMP التي توضّح بالتفصيل كيفية تشغيل تطبيقك باستخدام حزمة تطوير البرامج (SDK) لمنصّة UMP وإعداد رسالتك. تتعلّق الإرشادات التالية تحديدًا برسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية.
المتطلبات الأساسية
قبل المتابعة، يُرجى التأكّد من تنفيذ ما يلي:
- تثبيت أحدث إصدار من حزمة تطوير البرامج لمنصة 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، يُرجى الاطّلاع على
مقالة إجبار منطقة جغرافية.
ملاحظة: لا تتوفّر UMPDebugGeographyRegulatedUSState إلا في الإصدار 2.7.0 أو إصدار أعلى من منصّة UMP.