Công khai cho người dùng ở Hoa Kỳ

Chọn nền tảng: Android Mới chọn Android iOS Unity

Hướng dẫn này trình bày các bước cần thiết để hỗ trợ thông báo theo quy định của các tiểu bang tại Hoa Kỳ trong UMP SDK. Hãy kết hợp các hướng dẫn này với Bắt đầu sử dụng để biết chi tiết về 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 tại 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 mới nhất của SDK UMP. Để hỗ trợ thông báo theo quy định của các tiểu bang tại Hoa Kỳ, bạn nên sử dụng phiên bản 2.1.0 trở lên.
  • Thiết lập SDK UMP. 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à kết xuất điểm truy cập đó nếu cần. Sau 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 tại Hoa Kỳ cho người dùng.
  • Tạo thông báo theo quy định của các tiểu bang tại 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 tại 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ó để biết 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ó dưới độ tuổi hợp pháp để tự quản lý tài khoả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 nhắm đến nhiều kiểu đối tượng, hãy đặt tham số này cho người dùng trẻ em để đảm bảo không yêu cầu sự đồng ý. Bạn có trách nhiệm đặt tham số này khi cần thiết để 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 tại 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 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 sẵ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 tại Hoa Kỳ

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