本指南將概略說明如何在 UMP SDK 中支援美國州級法規訊息。請搭配參閱入門指南，進一步瞭解如何使用 UMP SDK 執行應用程式，以及設定訊息。以下指引專門適用於美國州級法規訊息。
必要條件
繼續操作之前，請務必完成下列步驟：
- 請更新至最新版 UMP SDK。如需美國州別法規訊息支援功能，建議您使用 2.1.0 以上版本。
- 完成「開始使用」步驟。請務必實作隱私權選項進入點，並視需要顯示該進入點。完成本指南後，您就能向使用者放送美國州級法規訊息。
- 建立應用程式的美國州級法規訊息。
- 如果您同時使用美國州級法規訊息和其他訊息，請參閱可用的使用者訊息類型，瞭解何時向使用者顯示不同的訊息。
設定未滿規定年齡的標記
如要指出使用者是否未滿法定同意年齡，請設定
setTagForUnderAgeOfConsent (TFUA)。將 TFUA 設為 true 時，UMP SDK 就不會向使用者要求同意聲明。如果應用程式包含混合各年齡層的目標對象，請為兒童使用者設定這個參數，確保系統不會要求他們同意。您有責任在必要時設定這個參數，以便遵守 COPPA 和其他相關法規。
以下範例會將 TFUA 設為 UMP 同意聲明要求的 true：
Swift
// Create a UMPRequestParameters object.
let parameters = UMPRequestParameters()
// Indicate the user is under age of consent.
parameters.tagForUnderAgeOfConsent = true
// Request an update for the consent information.
UMPConsentInformation.sharedInstance.requestConsentInfoUpdate(with: parameters) {
[weak self] requestConsentError in
guard let self else { return }
// ...
}
Objective-C
// Create a UMPRequestParameters object.
UMPRequestParameters *parameters = [[UMPRequestParameters alloc] init];
// Indicate the user is under age of consent.
parameters.tagForUnderAgeOfConsent = YES;
// Request an update for the consent information.
[UMPConsentInformation.sharedInstance
requestConsentInfoUpdateWithParameters:parameters
completionHandler:^(NSError *_Nullable requestConsentError) {
// ...
}];
閱讀同意聲明選項
使用者做出美國州級法規決定後，您可以依據全球隱私權平台 (GPP) 規格，從本機儲存空間讀取他們的選擇。詳情請參閱「應用程式內詳細資料」。請注意，UMP SDK 只會填入 IABGPP_GppSID 和 IABGPP_HDR_GppString 鍵。
測試美國州級法規訊息
如要測試美國各州的規範訊息，請使用 UMPDebugGeographyRegulatedUSState debugGeography 強制 UMP SDK 將測試裝置視為位於受規範的美國州份。您也可以使用 UMPDebugGeographyOther 強制抑制美國州級法規訊息。如要進一步瞭解 debugGeography，請參閱「強制指定地理區域」。