Para analizar nuestros productos y proporcionar comentarios sobre ellos, únete al canal oficial de Discord de Ad Manager en el servidor de la Comunidad de Publicidad y Medición de Google.
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta guía, se describen los pasos necesarios para admitir el mensaje sobre las reglamentaciones estatales de EE.UU. como parte del SDK de la UMP. Combina estas instrucciones con Comienza a usar el SDK de UMP, que detalla cómo ejecutar tu app con el SDK de UMP y configurar tu mensaje. La siguiente orientación es específica para el mensaje de las reglamentaciones estatales de EE.UU.
Requisitos previos
Antes de continuar, asegúrate de hacer lo siguiente:
Actualiza a la versión más reciente del SDK de UMP.
Para obtener asistencia con los mensajes sobre las reglamentaciones de los estados de EE.UU., te recomendamos que uses la versión 2.1.0 o una posterior.
Completa la sección Comienza ahora.
Asegúrate de implementar un punto de entrada de opciones de privacidad y renderizarlo si es necesario. Cuando completes esta guía, tendrás un punto de entrada para publicar tu mensaje sobre las reglamentaciones estatales de EE.UU. a tus usuarios.
Si utilizas el mensaje de las reglamentaciones estatales de EE.UU. junto con otros mensajes, consulta Tipos de mensajes para los usuarios disponibles para comprender cuándo se muestran los diferentes mensajes a los usuarios.
Cómo establecer la etiqueta para usuarios menores de la edad de consentimiento
Para indicar si un usuario no alcanza la edad de consentimiento, configura
setTagForUnderAgeOfConsent (TFUA). Cuando configuras TFUA como true, el SDK de UMP no solicita el consentimiento del usuario. Si tu app tiene un público mixto, configura este parámetro para los usuarios infantiles y asegúrate de que no se solicite el consentimiento.
Es tu responsabilidad establecer este parámetro cuando sea necesario para cumplir con la COPPA y otras reglamentaciones pertinentes.
.
En el siguiente ejemplo, se establece TFUA como verdadero en una solicitud de consentimiento de 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ómo leer las selecciones de consentimiento
Después de que el usuario toma una decisión sobre las reglamentaciones estatales de EE.UU., puedes leer su elección desde el almacenamiento local según la especificación de Global Privacy Platform (GPP). Para obtener más detalles, consulta Detalles en la app.
Ten en cuenta que el SDK de UMP solo completa las claves IABGPP_GppSID y IABGPP_HDR_GppString.
Prueba tus mensajes sobre las reglamentaciones estatales de EE.UU.
Para probar los mensajes sobre las reglamentaciones de los estados de EE.UU., usa UMPDebugGeographyRegulatedUSStatedebugGeography para forzar al SDK de UMP a tratar tu dispositivo de prueba como si estuviera ubicado en un estado de EE.UU. regulado. También puedes usar UMPDebugGeographyOther para forzar la supresión de los mensajes sobre las reglamentaciones estatales de EE.UU. Para obtener más detalles sobre debugGeography, consulta Cómo forzar una ubicación geográfica.
[null,null,["Última actualización: 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."]]