미국 주 규정 메시지를 다른 메시지와 함께 사용하는 경우 사용 가능한 사용자 메시지 유형을 참고하여 사용자에게 다양한 메시지가 표시되는 시점을 파악하세요.
동의 연령 미만의 사용자를 위한 태그 설정
사용자가 동의 연령 미만인지 여부를 나타내려면
tagForUnderAgeOfConsent (TFUA)를 설정하세요. TFUA를 true로 설정하면 UMP SDK에서
사용자에게 동의를 요청하지 않습니다. 앱 사용자의 연령대가 다양하면
아동 사용자에 대해 이 매개변수를 설정하여 동의가 요청되지 않도록 하세요.
COPPA 및 기타 관련 규정을 준수하기 위해 필요한 경우 이 매개변수를 설정하는 것은 개발자의 책임입니다.
다음 예에서는 UMP 동의 요청 시 TFUA를 true로 설정합니다.
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){// ...}];
동의 여부 읽기
사용자가 미국 주 규정 결정을 내린 후에는 Global Privacy Platform (GPP) 사양에 따라 로컬 스토리지에서 선택사항을 읽을 수 있습니다. 자세한 내용은 인앱 세부정보를 참고하세요.
UMP SDK는 IABGPP_GppSID 및 IABGPP_HDR_GppString 키만 채웁니다.
미국 주 규정 메시지 테스트
미국 주 규정 메시지를 테스트하려면 UMPDebugGeographyRegulatedUSStatedebugGeography를 사용하여 UMP SDK가 테스트 기기를 규제 대상 미국 주에 있는 기기인 것처럼 취급하도록 강제하세요. UMPDebugGeographyOther를 사용하여 미국 주 규정 메시지를 강제로 숨길 수도 있습니다. debugGeography에 대한 자세한 내용은 지역 강제 설정을 참고하세요.
[null,null,["최종 업데이트: 2025-09-02(UTC)"],[[["\u003cp\u003eThis guide explains how to integrate the US states regulations message into your iOS app using the User Messaging Platform (UMP) SDK.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, update to the latest UMP SDK, complete the Get Started guide, create a US states regulations message, and review available message types for potential interactions.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003etagForUnderAgeOfConsent\u003c/code\u003e parameter to indicate users under the age of consent and ensure compliance with COPPA and other regulations.\u003c/p\u003e\n"],["\u003cp\u003eAccess user consent choices after they interact with the message by reading from local storage according to the Global Privacy Platform (GPP) specifications.\u003c/p\u003e\n"],["\u003cp\u003eTest your implementation using the \u003ccode\u003edebugGeography\u003c/code\u003e setting in the UMP SDK to simulate being in a regulated US state or to suppress the messages.\u003c/p\u003e\n"]]],["To support US states regulations, update to UMP SDK 2.1.0+ and complete the \"Get Started\" guide. Create a US states regulations message, and implement a privacy options entry point. For users under the age of consent, set `tagForUnderAgeOfConsent` to `true` in `UMPRequestParameters`, noting that this tag needs to be set on ad requests as well. After a user's decision, read their choice via the Global Privacy Platform spec. Test using `UMPDebugGeographyRegulatedUSState` (v2.7.0+) to simulate a regulated US state.\n"],null,["Select platform: [Android](/admob/android/privacy/us-iab-support \"View this page for the Android platform docs.\") [iOS](/admob/ios/privacy/us-iab-support \"View this page for the iOS platform docs.\") [Unity](/admob/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](/admob/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](/admob/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 states regulations message](//support.google.com/admob/answer/10860309) for apps.\n- If you're using the US states regulations message alongside other messages, consult [Available user message types](//support.google.com/admob/answer/10114020) 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](/admob/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 from an app for child-directed treatment](//support.google.com/admob/answer/6219315).\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](/admob/ios/privacy#force_a_geography).\n| **Note:** `UMPDebugGeographyRegulatedUSState` is only available in UMP version 2.7.0 or higher."]]