美國 IAB 支援

選取平台： Android iOS Unity

本指南說明如何透過 UMP SDK 支援美國州級法規訊息。請搭配「開始使用」一文中的操作說明，瞭解如何使用 UMP SDK 執行應用程式，以及設定訊息。以下指引專門說明美國州級法規訊息。

必要條件

繼續操作前，請務必先執行下列工作：

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

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

以下範例會在 UMP 同意聲明要求中，將 TFUA 設為 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，請參閱「強制指定地理位置」。