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

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

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

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

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

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

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

Java

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

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

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