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

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 ở Hoa Kỳ trong SDK Nền tảng thông báo cho người dùng (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:

  • Hãy cập nhật lên phiên bản mới nhất của SDK Nền tảng thông báo cho người dùng (UMP). Đối với tính năng 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 ở 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 thiết lập 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ư 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 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 ở 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 xử lý thiết bị thử nghiệm của bạn như thể thiết bị này được đặt ở một tiểu bang được quản lý tại Hoa Kỳ. Bạn cũng có thể dùng UMPDebugGeographyOther để buộc chặn các thông báo theo quy định của chính phủ 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ý.