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

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

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. Kết hợp các hướng dẫn này với bài viết Bắt đầu, trong đó 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 đã 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 UMP SDK. Để 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.
  • Hoàn thành các bước trong phần Bắt đầu sử dụng. 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 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 ở 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ó để 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ó chưa đủ tuổi thành niên hay không, hãy đặt setTagForUnderAgeOfConsent (TFUA). Khi bạn đặt TFUA thành true, UMP SDK 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 là 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 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 trong 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 thông tin chi tiết, hãy xem Thông tin chi tiết trong ứng dụng. Xin lưu ý rằng UMP SDK chỉ điền sẵn các khoá IABGPP_GppSID và IABGPP_HDR_GppString.

Thử nghiệm thông báo theo quy định của các tiểu bang tại Hoa Kỳ

Để thử nghiệm 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 UMP SDK coi thiết bị thử nghiệm của bạn như thể thiết bị đó ở một tiểu bang được quản lý ở Hoa Kỳ. Bạn cũng có thể dùng UMPDebugGeographyOther để buộc chặn thông báo theo quy định của các tiểu bang tại Hoa Kỳ. Để biết thêm thông tin về debugGeography, hãy xem phần Chỉ định một vị trí địa lý.