美國 IAB 支援

本指南將概略說明如何在 UMP SDK 中支援美國州級法規訊息。請搭配參閱入門指南，進一步瞭解如何使用 UMP SDK 執行應用程式，以及設定訊息。以下指引專門適用於美國州級法規訊息。

必要條件

繼續操作前，請務必完成下列步驟：

  • 請更新至最新版 UMP SDK。如需美國州別法規訊息支援功能，建議您使用 2.1.0 以上版本。
  • 完成「開始使用」步驟。請務必實作隱私權選項進入點，並視需要顯示該選項。完成本指南後，您就能向使用者放送美國州級法規訊息。
  • 建立應用程式的美國州級法規訊息。
  • 如果您同時使用美國州級法規訊息和其他訊息，請參閱可用的使用者訊息類型，瞭解何時向使用者顯示不同的訊息。

如要指出使用者是否未滿法定同意年齡，請設定 setTagForUnderAgeOfConsent (TFUA)。將 TFUA 設為 true 時，UMP SDK 就不會向使用者要求同意聲明。如果應用程式包含混合各年齡層的目標對象，請為兒童使用者設定這個參數，確保系統不會要求他們同意。您有責任在必要時設定這個參數，以便遵守 COPPA 和其他相關法規。

以下範例會將 TFUA 設為 UMP 同意聲明要求的 true：

JavaKotlin
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 -> {
      // ...
    });

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，請參閱「強制指定地理區域」。