Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Ad Manager sur le serveur de la communauté Google Advertising and Measurement.
Ce guide décrit les étapes nécessaires pour prendre en charge le message sur les réglementations dans les États américains dans le SDK UMP. Associez ces instructions à la section Premiers pas, qui explique comment exécuter votre application avec le SDK UMP et configurer votre message. Les conseils suivants sont spécifiques au message concernant les réglementations des États américains.
Prérequis
Avant de continuer, assurez-vous d'avoir effectué les actions suivantes :
Passez à la dernière version du SDK UMP.
Pour la prise en charge des messages concernant les réglementations des États américains, nous vous recommandons d'utiliser la version 2.1.0 ou ultérieure.
Suivez les instructions de la section Premiers pas.
Veillez à implémenter un point d'entrée pour les options de confidentialité et à l'afficher si nécessaire. En suivant ce guide, vous disposerez d'un point d'entrée pour diffuser votre message sur les réglementations des États américains auprès de vos utilisateurs.
Si vous utilisez le message lié aux réglementations dans les États américains en même temps que d'autres messages, consultez Types de messages utilisateur disponibles pour savoir quand les différents messages sont affichés à vos utilisateurs.
Définir le tag pour les utilisateurs n'ayant pas atteint l'âge minimal requis
Pour indiquer si un utilisateur n'a pas atteint l'âge de consentement, définissez
tagForUnderAgeOfConsent (TFUA). Lorsque vous définissez TFUA sur true, le SDK UMP ne demande pas le consentement de l'utilisateur. Si votre application cible une audience mixte, définissez ce paramètre pour les utilisateurs non-adultes afin de vous assurer qu'aucun consentement ne leur est demandé.
Il vous incombe de définir ce paramètre lorsque cela est nécessaire pour respecter la loi COPPA et les autres réglementations applicables.
L'exemple suivant définit TFUA sur "true" dans une demande de consentement UMP :
Swift
// Create a UMPRequestParameters object.letparameters=RequestParameters()// Indicate the user is under age of consent.parameters.isTaggedForUnderAgeOfConsent=true// Request an update for the consent information.ConsentInformation.shared.requestConsentInfoUpdate(with:parameters){[weakself]requestConsentErroringuardletselfelse{return}// ...}
Objective-C
// Create a UMPRequestParameters object.UMPRequestParameters*parameters=[[UMPRequestParametersalloc]init];// Indicate the user is under age of consent.parameters.tagForUnderAgeOfConsent=YES;// Request an update for the consent information.[UMPConsentInformation.sharedInstancerequestConsentInfoUpdateWithParameters:parameterscompletionHandler:^(NSError*_NullablerequestConsentError){// ...}];
Lire les choix de consentement
Une fois que l'utilisateur a pris une décision concernant les réglementations des États américains, vous pouvez lire son choix à partir du stockage local en suivant la spécification de la Global Privacy Platform (GPP). Pour en savoir plus, consultez Détails dans l'application.
Notez que le SDK UMP ne renseigne que les clés IABGPP_GppSID et IABGPP_HDR_GppString.
Tester vos messages concernant les réglementations des États américains
Pour tester les messages liés aux réglementations des États américains, utilisez UMPDebugGeographyRegulatedUSStatedebugGeography pour forcer le SDK UMP à traiter votre appareil de test comme s'il était situé dans un État américain soumis à des réglementations. Vous pouvez également utiliser UMPDebugGeographyOther pour forcer la suppression des messages sur les réglementations des États américains. Pour en savoir plus sur debugGeography, consultez Forcer une zone géographique.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/06 (UTC).
[null,null,["Dernière mise à jour le 2025/09/06 (UTC)."],[[["\u003cp\u003eThis guide explains how to integrate the US state regulations message into your iOS app using the User Messaging Platform (UMP) SDK.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, update to UMP SDK v2.1.0 or higher, set up a privacy options entrypoint, create a US state regulations message in Ad Manager, and review message display logic.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003etagForUnderAgeOfConsent\u003c/code\u003e parameter in your UMP request to indicate users under the age of consent, crucial for complying with COPPA and other regulations.\u003c/p\u003e\n"],["\u003cp\u003eAccess user consent choices after they interact with the US state regulations message by reading data stored according to the Global Privacy Platform (GPP) specifications.\u003c/p\u003e\n"],["\u003cp\u003eUtilize \u003ccode\u003edebugGeography\u003c/code\u003e settings, such as \u003ccode\u003eUMPDebugGeographyRegulatedUSState\u003c/code\u003e, to simulate different locations and test your implementation thoroughly.\u003c/p\u003e\n"]]],[],null,["Select 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/ios/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\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](/ad-manager/mobile-ads-sdk/ios/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\nTo indicate whether a user is under the age of consent, set\n`\n`[tagForUnderAgeOfConsent](/ad-manager/mobile-ads-sdk/ios/privacy/api/reference/Classes/UMPRequestParameters#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\nSwift \n\n // Create a UMPRequestParameters object.\n let parameters = RequestParameters()\n // Indicate the user is under age of consent.\n parameters.isTaggedForUnderAgeOfConsent = true\n\n // Request an update for the consent information.\n ConsentInformation.shared.requestConsentInfoUpdate(with: parameters) {\n [weak self] requestConsentError in\n guard let self else { return }\n\n // ...\n }\n\nObjective-C \n\n // Create a UMPRequestParameters object.\n UMPRequestParameters \\*parameters = \\[\\[UMPRequestParameters alloc\\] init\\];\n // Indicate the user is under age of consent.\n parameters.tagForUnderAgeOfConsent = YES;\n\n // Request an update for the consent information.\n [UMPConsentInformation.sharedInstance\n requestConsentInfoUpdateWithParameters:parameters\n completionHandler:^(NSError *_Nullable requestConsentError) {\n // ...\n }];\n\nRead consent choices\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\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/ios/privacy#force_a_geography).\n| **Note:** `UMPDebugGeographyRegulatedUSState` is only available in UMP version 2.7.0 or higher."]]