يوضّح هذا الدليل الخطوات المطلوبة لعرض رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات المتحدة كجزء من "حزمة تطوير البرامج لمنصة UMP". يمكنك الاستعانة بهذه التعليمات مع مقالة
البدء التي توضّح كيفية تشغيل تطبيقك
باستخدام حزمة تطوير البرامج (SDK) لمنصّة UMP وإعداد رسالتك. الإرشادات التالية خاصة برسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية.
المتطلبات الأساسية
قبل المتابعة، تأكَّد من تنفيذ ما يلي:
حدِّث إلى أحدث إصدار من
مكوّن Unity الإضافي.
للاستفادة من ميزة عرض الرسائل المتوافقة مع لوائح الولايات الأمريكية، ننصحك باستخدام الإصدار 8.7.0 أو إصدار أحدث.
أكمِل الخطوات في البدء.
احرص على إنشاء نقطة دخول لخيارات الخصوصية وعرضها عند الحاجة. من خلال إكمال هذا الدليل، سيكون لديك نقطة دخول لعرض رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية للمستخدمين.
إذا كنت تستخدم رسالة طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية إلى جانب رسائل أخرى، يُرجى الرجوع إلى أنواع رسائل المستخدمين المتاحة للتعرّف على الحالات التي يتم فيها عرض الرسائل المختلفة للمستخدمين.
ضبط علامة القاصرين دون سن الرشد
للإشارة إلى ما إذا كان المستخدم دون سن الرشد، اضبط
tagForUnderAgeOfConsent (TFUA). عند ضبط TFUA على true، لا تطلب حزمة تطوير البرامج لمنصة UMP الحصول على موافقة المستخدم. إذا كان تطبيقك يضمّ جمهورًا مختلطًا، اضبط هذه المَعلمة للمستخدمين الأطفال لضمان عدم طلب الموافقة.
وتقع على عاتقك مسؤولية ضبط هذه المَعلمة عند الضرورة للامتثال لقانون COPPA واللوائح التنظيمية الأخرى ذات الصلة.
يضبط المثال التالي قيمة TFUA على "صحيح" في طلب الموافقة على "منصّة إدارة المستخدمين":
ConsentRequestParametersparams=newConsentRequestParameters{// Indicate the user is under age of consent.TagForUnderAgeOfConsent=true;};ConsentInformation.Update(params,(FormErrorupdateError)=>
{// ...});
قراءة خيارات الموافقة
بعد أن يتّخذ المستخدم قرارًا بموجب اللوائح التنظيمية في الولايات الأمريكية، يمكنك الاطّلاع على خياره من وحدة التخزين المحلية باتّباع مواصفات إطار عمل Global Privacy Platform (GPP). لمزيد من التفاصيل، يُرجى الاطّلاع على التفاصيل داخل التطبيق.
يُرجى العِلم أنّ حزمة تطوير البرامج لمنصة UMP لا تملأ سوى المفتاحَين IABGPP_GppSID وIABGPP_HDR_GppString.
اختبار رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية
لاختبار رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات المتحدة، استخدِم الرمز UMPDebugGeographyRegulatedUSStatedebugGeography لفرض حزمة تطوير البرامج لمنصّة UMP على التعامل مع جهازك الاختباري كما لو كان الجهاز في ولاية أمريكية خاضعة للوائح التنظيمية. يمكنك أيضًا استخدام UMPDebugGeographyOther لفرض إيقاف رسائل طلب الموافقة بموجب اللوائح التنظيمية في الولايات الأمريكية. لمزيد من التفاصيل حول debugGeography، يُرجى الاطّلاع على
فرض منطقة جغرافية.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# US IAB Support\n\nSelect platform: [Android](/ad-manager/mobile-ads-sdk/android/privacy/us-iab-support \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/privacy/us-iab-support \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/privacy/us-iab-support \"View this page for the Unity platform docs.\")\n\n\u003cbr /\u003e\n\nThis guide outlines the steps required to support the US states regulations\nmessage as part of the UMP SDK. Pair these instructions with\n[Get started](/ad-manager/mobile-ads-sdk/unity/privacy), which details how to get your app running\nwith the UMP SDK and set up your message. The following guidance is specific to\nthe US states regulations message.\n\nPrerequisites\n-------------\n\nBefore continuing, ensure you do the following:\n\n- Update to the latest version of the Unity plugin. For US states regulations messaging support, we recommend you to use version 8.7.0 or higher.\n- Complete [Get started](/ad-manager/mobile-ads-sdk/unity/privacy). Be sure to implement a privacy options entrypoint and render it if required. By completing this guide, you have an entrypoint to serve your US states regulations message to your users.\n- [Create a US state regulations message](//support.google.com/admanager/answer/10115735) for apps.\n- If you're using the US states regulations message alongside other messages, consult [Available user message types](//support.google.com/admanager/answer/10075998) to understand when different messages are displayed to your users.\n\nSet the tag for under age of consent\n------------------------------------\n\nTo indicate whether a user is under the age of consent, set\n`\n`[tagForUnderAgeOfConsent](/ad-manager/mobile-ads-sdk/unity/reference/class/google-mobile-ads/ump/api/consent-request-parameters#tagforunderageofconsent) (TFUA). When you set TFUA to `true`, the UMP SDK\ndoesn't request consent from the user. If your app has a mixed audience, set\nthis parameter for child users to ensure consent is not requested.\nIt is your\nresponsibility for setting this parameter where necessary to comply with COPPA\nand other relevant regulations.\n| **Important:** The UMP SDK does not forward the TFUA tag set on consent requests to the Google Mobile Ads SDK. You must explicitly set the `tagForUnderAgeOfConsent` or `tagForChildDirectectedTreatment` on ad requests. If you don't set the `tagForUnderAgeOfConsent` or `tagForChildDirectectedTreatment` on ad requests, the UMP SDK does not collect any information that allows Google to determine whether or not users under the age of consent use your app. For more information about data processing restrictions for these users, see [Tag an ad request for child-directed treatment](//support.google.com/admanager/answer/3671211).\n\nThe following example sets TFUA to true on a UMP consent request: \n\n ConsentRequestParameters params = new ConsentRequestParameters\n {\n // Indicate the user is under age of consent.\n TagForUnderAgeOfConsent = true;\n };\n\n ConsentInformation.Update(params, (FormError updateError) =\u003e\n {\n // ...\n });\n\nRead consent choices\n--------------------\n\nAfter the user has made a US states regulations decision, you can read\ntheir choice from local storage following the Global Privacy Platform (GPP)\nspec. For more details see,\n[In-App Details](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Core/CMP%20API%20Specification.md#in-app-details).\nNote that the UMP SDK only populates the `IABGPP_GppSID` and\n`IABGPP_HDR_GppString` keys.\n\nTest your US states regulations messaging\n-----------------------------------------\n\nTo test your US states regulations messaging, use the\n`UMPDebugGeographyRegulatedUSState` `debugGeography` to force the UMP\nSDK to treat your test device as if the device were located in a regulated US\nstate. You can also use `UMPDebugGeographyOther` to force suppression of US\nstates regulations messages. For more details on `debugGeography`, see\n[Force a geography](/ad-manager/mobile-ads-sdk/unity/privacy#force_a_geography).\n| **Note:** `UMPDebugGeographyRegulatedUSState` is only available in Unity plugin 9.4.0 or higher."]]
