미국 주 규정 메시지를 다른 메시지와 함께 사용하는 경우 사용 가능한 사용자 메시지 유형을 참고하여 사용자에게 다양한 메시지가 표시되는 시점을 파악하세요.
동의 연령 미만의 사용자를 위한 태그 설정
사용자가 동의 연령 미만인지 여부를 나타내려면
setTagForUnderAgeOfConsent (TFUA)를 설정하세요. TFUA를 true로 설정하면 UMP SDK가 사용자에게 동의를 요청하지 않습니다. 앱의 사용자가 다양하다면 아동 사용자에 대해 이 매개변수를 설정하여 동의가 요청되지 않도록 하세요.
COPPA 및 기타 관련 규정을 준수하기 위해 필요한 경우 이 매개변수를 설정하는 것은 개발자의 책임입니다.
다음 예에서는 UMP 동의 요청에서 TFUA를 true로 설정합니다.
자바
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->
// ...})
동의 선택 읽기
사용자가 미국 주 규정 결정을 내린 후에는 Global Privacy Platform (GPP) 사양에 따라 로컬 스토리지에서 선택사항을 읽을 수 있습니다. 자세한 내용은 인앱 세부정보를 참고하세요.
UMP SDK는 IABGPP_GppSID 및 IABGPP_HDR_GppString 키만 채웁니다.
미국 주 규정 메시지 테스트
미국 주 규정 메시지를 테스트하려면 UMPDebugGeographyRegulatedUSStatedebugGeography를 사용하여 UMP SDK가 테스트 기기를 규제 대상 미국 주에 있는 기기인 것처럼 취급하도록 강제하세요. UMPDebugGeographyOther를 사용하여 미국 주 규정 메시지를 강제로 숨길 수도 있습니다. debugGeography에 대한 자세한 내용은 지역 강제 설정을 참고하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-21(UTC)"],[[["This guide provides instructions on integrating the US states regulations message into your Android app using the User Messaging Platform (UMP) SDK."],["Before you begin, ensure you have updated to the latest UMP SDK, completed the 'Get started' guide, created a US states regulations message, and reviewed the available user message types."],["Set the TagForUnderAgeOfConsent (TFUA) parameter to `true` for users under the age of consent to prevent the UMP SDK from requesting consent, ensuring compliance with regulations like COPPA."],["You can read the user's consent choices from local storage following the Global Privacy Platform (GPP) spec after they have interacted with the message."],["For testing purposes, utilize the `debugGeography` setting with `UMPDebugGeographyRegulatedUSState` to simulate a device location within a regulated US state."]]],["To support US state regulations within the UMP SDK, ensure you have the latest SDK version and have completed the basic setup. Create a US states regulations message and manage its display alongside other messages. Use `setTagForUnderAgeOfConsent(true)` for users under the age of consent, and ensure that this tag is also set on ad requests, as the UMP SDK does not do it. After user selection, access their consent choice via local storage according to GPP. For testing, utilize `UMPDebugGeographyRegulatedUSState` or `UMPDebugGeographyOther`.\n"]]