Panduan ini menguraikan langkah-langkah yang diperlukan untuk mendukung pesan peraturan negara bagian AS sebagai bagian dari UMP SDK. Gabungkan petunjuk ini dengan
Mulai, yang menjelaskan cara menjalankan aplikasi Anda
dengan UMP SDK dan menyiapkan pesan Anda. Panduan berikut khusus untuk pesan peraturan negara bagian AS.
Prasyarat
Sebelum melanjutkan, pastikan Anda melakukan hal berikut:
Update ke UMP SDK versi terbaru.
Untuk dukungan pesan peraturan negara bagian AS, sebaiknya gunakan versi
2.1.0
atau yang lebih tinggi.
Selesaikan
Mulai.
Pastikan untuk menerapkan titik entri opsi privasi dan menampilkannya jika diperlukan. Dengan menyelesaikan panduan ini, Anda memiliki titik entri untuk menayangkan pesan peraturan negara bagian AS kepada pengguna.
Jika Anda menggunakan pesan peraturan negara bagian AS bersama dengan pesan lainnya, lihat
Jenis pesan pengguna yang tersedia
untuk memahami kapan pesan yang berbeda ditampilkan kepada pengguna Anda.
Menetapkan tag untuk pengguna di bawah usia dewasa
Untuk menunjukkan apakah pengguna berusia di bawah usia dewasa, tetapkan
tagForUnderAgeOfConsent (TFUA). Jika Anda menyetel TFUA ke true, UMP SDK tidak akan meminta izin dari pengguna. Jika aplikasi Anda memiliki audiens campuran, tetapkan parameter ini untuk pengguna anak-anak guna memastikan izin tidak diminta.
Anda bertanggung jawab untuk menetapkan parameter ini jika diperlukan agar mematuhi COPPA dan peraturan lain yang relevan.
Contoh berikut menetapkan TFUA ke benar (true) pada permintaan izin 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){// ...}];
Membaca pilihan izin
Setelah pengguna membuat keputusan terkait peraturan negara bagian Amerika Serikat, Anda dapat membaca
pilihannya dari penyimpanan lokal dengan mengikuti spesifikasi Global Privacy Platform (GPP). Untuk mengetahui detail selengkapnya, lihat
Detail Dalam Aplikasi.
Perhatikan bahwa UMP SDK hanya mengisi kunci IABGPP_GppSID dan IABGPP_HDR_GppString.
Menguji pesan peraturan negara bagian AS Anda
Untuk menguji pesan peraturan negara bagian AS, gunakan
UMPDebugGeographyRegulatedUSStatedebugGeography untuk memaksa UMP
SDK memperlakukan perangkat pengujian Anda seolah-olah perangkat tersebut berada di negara bagian AS yang diatur. Anda juga dapat menggunakan UMPDebugGeographyOther untuk memaksa peniadaan pesan peraturan negara bagian AS. Untuk mengetahui detail selengkapnya tentang debugGeography, lihat
Memaksakan geografi.
[null,null,["Terakhir diperbarui pada 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."]]
