فريق دعم مكتب IAB في الولايات المتحدة

اختيار النظام الأساسي: Android iOS

يوضّح هذا الدليل الخطوات المطلوبة لعرض رسالة الموافقة بموجب اللوائح التنظيمية في الولايات المتحدة كجزء من "حزمة تطوير البرامج لمنصة UMP". استخدِم هذه التعليمات مع مقالة إعداد حزمة تطوير البرامج لمنصّة UMP التي توضّح بالتفصيل كيفية تشغيل تطبيقك باستخدام حزمة تطوير البرامج لمنصّة UMP وإعداد رسالتك. الإرشادات التالية خاصة برسالة اللوائح التنظيمية في الولايات الأمريكية.

المتطلبات الأساسية

قبل المتابعة، تأكَّد من تنفيذ ما يلي:

  • يجب التحديث إلى أحدث إصدار من حزمة تطوير البرامج (SDK) لمنصّة UMP. للحصول على دعم بشأن الرسائل بموجب اللوائح التنظيمية للولايات الأمريكية، ننصحك باستخدام الإصدار 2.1.0 أو إصدار أحدث.
  • إعداد "حزمة تطوير البرامج لمنصة UMP" احرص على إنشاء نقطة دخول لخيارات الخصوصية وعرضها إذا كان ذلك مطلوبًا. من خلال إكمال هذا الدليل، سيكون لديك نقطة دخول لعرض رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية للمستخدمين.
  • إنشاء رسالة بموجب اللوائح التنظيمية للولايات الأمريكية للتطبيقات
  • إذا كنت تستخدم رسالة اللوائح التنظيمية في الولايات الأمريكية إلى جانب رسائل أخرى، يُرجى الرجوع إلى أنواع رسائل المستخدمين المتاحة للتعرّف على الحالات التي يتم فيها عرض الرسائل المختلفة للمستخدمين.

للإشارة إلى ما إذا كان المستخدم دون سن الرشد، اضبط setTagForUnderAgeOfConsent (TFUA). عند ضبط TFUA على true، لا تطلب حزمة تطوير البرامج لمنصة UMP موافقة المستخدم. إذا كان تطبيقك يضمّ جمهورًا مختلطًا، اضبط هذه المَعلمة للمستخدمين الأطفال لضمان عدم طلب الموافقة. وتقع على عاتقك مسؤولية ضبط هذه المَعلمة عند الضرورة للامتثال لقانون COPPA واللوائح التنظيمية الأخرى ذات الصلة.

يضبط المثال التالي قيمة TFUA على "صحيح" في طلب الموافقة على "منصّة إدارة المستخدمين":

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). لمزيد من التفاصيل، يُرجى الاطّلاع على التفاصيل داخل التطبيق. يُرجى العِلم أنّ حزمة تطوير البرامج لمنصة UMP تملأ المفتاحَين IABGPP_GppSID وIABGPP_HDR_GppString فقط.

اختبار رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية

لاختبار رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات المتحدة، استخدِم الرمز UMPDebugGeographyRegulatedUSState debugGeography لإجبار حزمة تطوير البرامج لمنصّة UMP على التعامل مع جهازك الاختباري كما لو كان في إحدى الولايات الأمريكية الخاضعة للوائح التنظيمية. يمكنك أيضًا استخدام UMPDebugGeographyOther لفرض إيقاف عرض رسائل اللوائح التنظيمية في الولايات الأمريكية. لمزيد من التفاصيل حول debugGeography، يُرجى الاطّلاع على فرض منطقة جغرافية. ملاحظة: لا تتوفّر UMPDebugGeographyRegulatedUSState إلا في الإصدار 2.7.0 أو الإصدارات الأحدث من "منصّة إدارة المستخدم".