Để thảo luận và đưa ra ý kiến phản hồi về các sản phẩm của chúng tôi, hãy tham gia kênh Discord chính thức của Ad Manager trong máy chủ Cộng đồng quảng cáo và đo lường của Google.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn này trình bày các bước mà bạn cần thực hiện để hỗ trợ triển khai thông báo theo quy định của các tiểu bang ở Hoa Kỳ trong SDK UMP. Kết hợp các hướng dẫn này với bài viết Bắt đầu, trong đó trình bày chi tiết cách chạy ứng dụng bằng SDK UMP và thiết lập thông báo. Hướng dẫn sau đây dành riêng cho thông báo theo quy định của các tiểu bang ở Hoa Kỳ.
Điều kiện tiên quyết
Trước khi tiếp tục, hãy đảm bảo bạn đã thực hiện những việc sau:
Cập nhật lên phiên bản mới nhất của UMP SDK.
Để hỗ trợ thông báo theo quy định của các tiểu bang ở Hoa Kỳ, bạn nên sử dụng phiên bản 2.1.0 trở lên.
Hoàn thành các bước trong phần Bắt đầu sử dụng.
Hãy nhớ triển khai một điểm truy cập các lựa chọn về quyền riêng tư và hiển thị điểm truy cập đó nếu cần. Khi hoàn tất hướng dẫn này, bạn sẽ có một điểm truy cập để phân phát thông báo theo quy định của các tiểu bang tại Hoa Kỳ cho người dùng.
Nếu bạn đang sử dụng thông báo theo quy định của các tiểu bang ở Hoa Kỳ cùng với các thông báo khác, hãy tham khảo phần Các loại thông báo cho người dùng hiện có để biết thời điểm các thông báo khác nhau được hiển thị cho người dùng.
Đặt thẻ cho người dùng dưới độ tuổi hợp pháp
Để cho biết liệu người dùng có chưa đủ tuổi thành niên hay không, hãy đặt
setTagForUnderAgeOfConsent (TFUA). Khi bạn đặt TFUA thành true, UMP SDK sẽ không yêu cầu người dùng đồng ý. Nếu ứng dụng của bạn nhắm đến nhiều kiểu đối tượng, hãy đặt tham số này cho người dùng là trẻ em để đảm bảo không yêu cầu họ đồng ý.
Bạn có trách nhiệm đặt tham số này khi cần thiết để tuân thủ COPPA và các quy định có liên quan khác.
Ví dụ sau đây đặt TFUA thành true trong yêu cầu đồng ý của UMP:
Java
ConsentRequestParametersparams=newConsentRequestParameters.Builder()// Indicate the user is under age of consent..setTagForUnderAgeOfConsent(true).build();consentInformation=UserMessagingPlatform.getConsentInformation(this);consentInformation.requestConsentInfoUpdate(this,params,(OnConsentInfoUpdateSuccessListener)()->{// ...},(OnConsentInfoUpdateFailureListener)requestConsentError->{// ...});
Kotlin
valparams=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->
// ...})
Đọc lựa chọn đồng ý
Sau khi người dùng đưa ra quyết định theo quy định của các tiểu bang tại Hoa Kỳ, bạn có thể đọc lựa chọn của họ từ bộ nhớ cục bộ theo quy cách của Nền tảng quyền riêng tư trên toàn cầu (GPP). Để biết thêm thông tin chi tiết, hãy xem Thông tin chi tiết trong ứng dụng.
Xin lưu ý rằng UMP SDK chỉ điền sẵn các khoá IABGPP_GppSID và IABGPP_HDR_GppString.
Thử nghiệm thông báo theo quy định của các tiểu bang tại Hoa Kỳ
Để thử nghiệm thông báo theo quy định của các tiểu bang ở Hoa Kỳ, hãy dùng UMPDebugGeographyRegulatedUSStatedebugGeography để buộc UMP SDK coi thiết bị thử nghiệm của bạn như thể thiết bị đó ở một tiểu bang được quản lý ở Hoa Kỳ. Bạn cũng có thể dùng UMPDebugGeographyOther để buộc chặn thông báo theo quy định của các tiểu bang tại Hoa Kỳ. Để biết thêm thông tin về debugGeography, hãy xem phần Chỉ định một vị trí địa lý.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eThis guide provides instructions on integrating the US States regulations message within your Android app using the UMP SDK (version 2.1.0 or higher).\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, ensure you have updated the UMP SDK, completed the 'Get Started' guide, created a US State regulations message in Ad Manager, and reviewed the available message types for potential interactions.\u003c/p\u003e\n"],["\u003cp\u003eYou can set a TagForUnderAgeOfConsent (TFUA) to indicate users under the age of consent and prevent consent requests for them, aligning with COPPA and other regulations.\u003c/p\u003e\n"],["\u003cp\u003eAfter a user interacts with the message, their choices are stored locally, accessible through the IABGPP_GppSID and IABGPP_HDR_GppString keys as per the Global Privacy Platform (GPP) specifications.\u003c/p\u003e\n"],["\u003cp\u003eTo test your implementation, utilize the \u003ccode\u003eUMPDebugGeographyRegulatedUSState\u003c/code\u003e debugGeography (UMP version 3.1.0 or higher) to simulate a device location within a regulated US state or \u003ccode\u003eUMPDebugGeographyOther\u003c/code\u003e to suppress the message.\u003c/p\u003e\n"]]],[],null,["# US IAB Support\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](/interactive-media-ads/docs/sdks/android/client-side/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 UMP SDK. For US states regulations messaging support, we recommend you to use version 2.1.0 or higher.\n- Complete [Get started](/interactive-media-ads/docs/sdks/android/client-side/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`[setTagForUnderAgeOfConsent](/admob/android/privacy/api/reference/com/google/android/ump/ConsentRequestParameters.Builder#public-consentrequestparameters.builder-settagforunderageofconsent-boolean-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\n\nThe following example sets TFUA to true on a UMP consent request: \n\n### Java\n\n ConsentRequestParameters params = new ConsentRequestParameters\n .Builder()\n // Indicate the user is under age of consent.\n .setTagForUnderAgeOfConsent(true)\n .build();\n\n consentInformation = UserMessagingPlatform.getConsentInformation(this);\n consentInformation.requestConsentInfoUpdate(\n this,\n params,\n (OnConsentInfoUpdateSuccessListener) () -\u003e {\n // ...\n },\n (OnConsentInfoUpdateFailureListener) requestConsentError -\u003e {\n // ...\n });\n\n### Kotlin\n\n val params = ConsentRequestParameters\n .Builder()\n // Indicate the user is under age of consent.\n .setTagForUnderAgeOfConsent(true)\n .build()\n\n consentInformation = UserMessagingPlatform.getConsentInformation(this)\n consentInformation.requestConsentInfoUpdate(\n this,\n params,\n ConsentInformation.OnConsentInfoUpdateSuccessListener {\n // ...\n },\n ConsentInformation.OnConsentInfoUpdateFailureListener {\n requestConsentError -\u003e\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](/interactive-media-ads/docs/sdks/android/client-side/privacy#force_a_geography).\n| **Note:** `UMPDebugGeographyRegulatedUSState` is only available in UMP version 3.1.0 or higher."]]
