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