Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa guida descrive i passaggi necessari per supportare il messaggio relativo ai regolamenti statali degli Stati Uniti
nell'ambito dell'SDK UMP. Abbina queste istruzioni alla guida Inizia, che descrive in dettaglio come eseguire l'app con l'SDK UMP e configurare il messaggio. Le seguenti indicazioni sono specifiche per
il messaggio relativo ai regolamenti statali degli Stati Uniti.
Prerequisiti
Prima di continuare, assicurati di:
Esegui l'aggiornamento all'ultima versione dell'SDK UMP.
Per il supporto dei messaggi relativi alle normative degli stati degli Stati Uniti, ti consigliamo di utilizzare la versione
2.1.0
o successive.
Completa
Inizia.
Assicurati di implementare un punto di accesso alle opzioni sulla privacy e di eseguirne il rendering se
necessario. Completando questa guida, avrai un punto di ingresso per pubblicare il messaggio relativo ai regolamenti statali degli Stati Uniti per i tuoi utenti.
Se utilizzi il messaggio relativo ai regolamenti statali degli Stati Uniti insieme ad altri
messaggi, consulta
Tipi di messaggi per gli utenti disponibili
per capire quando vengono mostrati agli utenti i diversi messaggi.
Impostare il tag per utenti di età inferiore a quella del consenso digitale
Per indicare se un utente non ha ancora raggiunto l'età del consenso digitale, imposta
setTagForUnderAgeOfConsent (TFUA). Quando imposti TFUA su true, l'SDK UMP
non richiede il consenso dell'utente. Se la tua app ha un pubblico misto, imposta
questo parametro per gli utenti minorenni per assicurarti che non venga richiesto il consenso.
È tua
responsabilità impostare questo parametro ove necessario per rispettare il COPPA
e altri regolamenti pertinenti.
L'esempio seguente imposta TFUA su true in una richiesta di consenso 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->
// ...})
Leggi le scelte relative al consenso
Dopo che l'utente ha preso una decisione in merito ai regolamenti statali degli Stati Uniti, puoi leggere
la sua scelta dallo spazio di archiviazione locale seguendo le specifiche della Global Privacy Platform (GPP). Per ulteriori dettagli, consulta la sezione
Dettagli in-app.
Tieni presente che l'SDK UMP compila solo le chiavi IABGPP_GppSID e
IABGPP_HDR_GppString.
Testare i messaggi relativi ai regolamenti statali degli Stati Uniti
Per testare i messaggi relativi alle normative degli stati degli Stati Uniti, utilizza
UMPDebugGeographyRegulatedUSStatedebugGeography per forzare l'SDK UMP
a trattare il tuo dispositivo di test come se si trovasse in uno stato degli Stati Uniti regolamentato. Puoi anche utilizzare UMPDebugGeographyOther per forzare la soppressione dei messaggi relativi ai regolamenti statali degli Stati Uniti. Per ulteriori dettagli su debugGeography, vedi
Forzare un'area geografica.
[null,null,["Ultimo aggiornamento 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."]]