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

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

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

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

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

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

يضبط المثال التالي TFUA على true في طلب موافقة UMP:

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، يُرجى الاطّلاع على فرض موقع جغرافي.