Nhóm hỗ trợ IAB tại Hoa Kỳ

Chọn nền tảng: Android iOS

Hướng dẫn này trình bày các bước mà bạn cần thực hiện để hỗ trợ triển khai thông báo theo quy định của các tiểu bang ở Hoa Kỳ trong SDK UMP. Hãy kết hợp các hướng dẫn này với Bắt đầu sử dụng, trong đó nêu chi tiết cách chạy ứng dụng bằng SDK UMP và thiết lập thông báo. Hướng dẫn sau đây dành riêng cho thông báo theo quy định của các tiểu bang ở Hoa Kỳ.

Điều kiện tiên quyết

Trước khi tiếp tục, hãy đảm bảo bạn thực hiện những việc sau:

  • Cập nhật lên phiên bản SDK UMP mới nhất. Để được hỗ trợ thông báo theo quy định của các tiểu bang ở Hoa Kỳ, bạn nên sử dụng phiên bản 2.1.0 trở lên.
  • Thiết lập SDK IMA. Hãy nhớ triển khai một điểm truy cập các lựa chọn về quyền riêng tư và hiển thị điểm truy cập đó nếu cần. Khi hoàn tất hướng dẫn này, bạn sẽ có một điểm truy cập để phân phát thông báo theo quy định của các tiểu bang ở Hoa Kỳ cho người dùng.
  • Tạo thông báo theo quy định của các tiểu bang ở Hoa Kỳ cho ứng dụng.
  • Nếu bạn đang sử dụng thông báo theo quy định của các tiểu bang ở Hoa Kỳ cùng với các thông báo khác, hãy tham khảo Các loại thông báo cho người dùng hiện có để hiểu rõ thời điểm các thông báo khác nhau được hiển thị cho người dùng.

Để cho biết liệu người dùng có chưa đủ tuổi thành niên hay không, hãy đặt setTagForUnderAgeOfConsent (TFUA). Khi bạn đặt TFUA thành true, SDK UMP sẽ không yêu cầu người dùng đồng ý. Nếu ứng dụng của bạn có đối tượng hỗn hợp, hãy đặt tham số này cho người dùng trẻ em để đảm bảo không yêu cầu họ đồng ý. Bạn có trách nhiệm đặt tham số này khi cần để tuân thủ COPPA và các quy định có liên quan khác.

Ví dụ sau đây đặt TFUA thành true trên một yêu cầu đồng ý của UMP:

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

Sau khi người dùng đưa ra quyết định theo quy định của các tiểu bang ở Hoa Kỳ, bạn có thể đọc lựa chọn của họ từ bộ nhớ cục bộ theo quy cách của Nền tảng quyền riêng tư trên toàn cầu (GPP) . Để biết thêm thông tin chi tiết, hãy xem bài viết Thông tin chi tiết trong ứng dụng. Xin lưu ý rằng SDK UMP chỉ điền các khoá IABGPP_GppSID và IABGPP_HDR_GppString.

Kiểm thử thông báo theo quy định của các tiểu bang ở Hoa Kỳ

Để kiểm thử thông báo theo quy định của các tiểu bang ở Hoa Kỳ, hãy sử dụng UMPDebugGeographyRegulatedUSState debugGeography để buộc SDK UMP coi thiết bị kiểm thử của bạn như thể thiết bị đó đang ở một tiểu bang ở Hoa Kỳ có quy định. Bạn cũng có thể sử dụng UMPDebugGeographyOther để buộc tắt thông báo theo quy định của các tiểu bang ở Hoa Kỳ. Để biết thêm thông tin chi tiết về debugGeography, hãy xem bài viết Chỉ định một vị trí địa lý.

Trước
Yêu cầu sự đồng ý của người dùng ở Liên minh Châu Âu
Tiếp
Diễn giải các giá trị của chế độ đồng ý