美國 IAB 支援

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

必要條件

請務必完成下列事項再繼續操作：

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

設定未滿規定年齡的標記

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

重要事項： UMP SDK 不會將同意聲明請求中設定的 TFUA 標記轉送至 Google Mobile Ads SDK。您必須在廣告請求中明確設定 tagForUnderAgeOfConsent 或 tagForChildDirectectedTreatment。如果您未在廣告請求中設定 tagForUnderAgeOfConsent 或 tagForChildDirectectedTreatment，UMP SDK 就不會收集任何資訊，讓 Google 判斷未達同意年齡的使用者是否使用您的應用程式。如要進一步瞭解對這類使用者施加的資料處理限制，請參閱

以下範例會在 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，請參閱「強制指定地理位置」。

注意： UMPDebugGeographyRegulatedUSState 僅適用於 UMP 3.1.0 以上版本。