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

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ài viết Bắt đầu. Bài viết này trình bày 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 làm như sau:

  • Cập nhật lên phiên bản SDK UMP mới nhất. Để hỗ trợ nhắn tin 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.
  • Hoàn tất phần Bắt đầu. Hãy nhớ triển khai đ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. Sau khi hoàn thành 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 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 ở 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 hiện có cho người dùng để biết thời điểm các thông báo khác nhau hiển thị cho người dùng.

Để cho biết người dùng có đủ 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 nhắm đến nhiều kiểu đối tượng, hãy đặt thông số này cho người dùng là 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 yêu cầu đồng ý 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 phần 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_GppSIDIABGPP_HDR_GppString.

Thử nghiệm 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ị thử nghiệm của bạn như thể thiết bị đó nằm ở một tiểu bang ở Hoa Kỳ chịu sự quản lý. Bạn cũng có thể sử dụng UMPDebugGeographyOther để buộc loại bỏ 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 phần Buộc chỉ định vị trí địa lý.