Thiết lập UMP SDK

Chọn nền tảng: Android iOS Unity Flutter Android (Phiên bản cũ)

SDK Nền tảng thông báo cho người dùng (UMP) của Google là một công cụ về quyền riêng tư và thông báo giúp bạn quản lý các lựa chọn về quyền riêng tư. Để biết thêm thông tin, hãy xem bài viết Giới thiệu về công cụ Quyền riêng tư và thông báo.

Tạo loại tin nhắn

Tạo thông báo cho người dùng bằng một trong các Loại thông báo hiện có cho người dùng trong thẻ Quyền riêng tư và thông báo của tài khoản AdMob. UMP SDK cố gắng hiển thị một thông báo về quyền riêng tư được tạo từ Mã ứng dụng AdMob đặt trong dự án của bạn.

Để biết thêm thông tin, hãy xem bài viết Giới thiệu về quyền riêng tư và thông báo.

Bạn nên yêu cầu cập nhật thông tin về trạng thái đồng ý của người dùng mỗi lần chạy ứng dụng, nếu dùng requestConsentInfoUpdate(). Yêu cầu này kiểm tra những điều sau:

  • Có cần có sự đồng ý hay không. Ví dụ: bạn cần có sự đồng ý lần đầu tiên hoặc quyết định đồng ý trước đó đã hết hạn.
  • Có bắt buộc phải có điểm truy cập các lựa chọn về quyền riêng tư hay không. Một số thông báo về quyền riêng tư yêu cầu ứng dụng cho phép người dùng sửa đổi các lựa chọn về quyền riêng tư của họ bất cứ lúc nào.
@override
void initState() {
  super.initState();

  // Create a ConsentRequestParameters object.
  final params = ConsentRequestParameters();

  // Request an update to consent information on every app launch.
  ConsentInformation.instance.requestConsentInfoUpdate(
    params,
    () async {
      // Called when consent information is successfully updated.
    },
    (FormError error) {
      // Called when there's an error updating consent information.
    },
  );
}

Tải và trình bày biểu mẫu thông báo về quyền riêng tư

Sau khi nhận được trạng thái đồng ý mới nhất, hãy gọi loadAndShowConsentFormIfRequired() để tải mọi biểu mẫu cần thiết nhằm thu thập sự đồng ý của người dùng. Sau khi tải, các biểu mẫu sẽ xuất hiện ngay lập tức.

@override
void initState() {
  super.initState();

  // Create a ConsentRequestParameters object.
  final params = ConsentRequestParameters();

  // Request an update to consent information on every app launch.
  ConsentInformation.instance.requestConsentInfoUpdate(
    params,
    () async {
      ConsentForm.loadAndShowConsentFormIfRequired((loadAndShowError) {
        if (loadAndShowError != null) {
          // Consent gathering failed.
        }

        // Consent has been gathered.
      });
    },
    (FormError error) {
      // Handle the error.
    },
  );
}

Lựa chọn về quyền riêng tư

Một số biểu mẫu thông báo về quyền riêng tư được trình bày từ điểm truy cập các lựa chọn về quyền riêng tư do nhà xuất bản hiển thị, cho phép người dùng quản lý các lựa chọn về quyền riêng tư của họ bất cứ lúc nào. Để tìm hiểu thêm về những loại thông báo mà người dùng của bạn nhìn thấy tại điểm truy cập các lựa chọn về quyền riêng tư, hãy xem Các loại thông báo hiện có cho người dùng.

Kiểm tra xem bạn có cần điểm truy cập các lựa chọn về quyền riêng tư hay không

Sau khi gọi requestConsentInfoUpdate(), hãy kiểm tra getPrivacyOptionsRequirementStatus() để xác định xem ứng dụng của bạn có cần một điểm truy cập các lựa chọn về quyền riêng tư hay không. Nếu cần một điểm truy cập, hãy thêm một phần tử trên giao diện người dùng có thể nhìn thấy và tương tác vào ứng dụng của bạn để trình bày biểu mẫu các lựa chọn về quyền riêng tư. Nếu không bắt buộc phải có một điểm truy cập vào các lựa chọn về quyền riêng tư, hãy định cấu hình phần tử trên giao diện người dùng của bạn sao cho không hiển thị và tương tác được.

/// Helper variable to determine if the privacy options entry point is required.
Future<bool> isPrivacyOptionsRequired() async {
  return await ConsentInformation.instance
      .getPrivacyOptionsRequirementStatus() ==
      PrivacyOptionsRequirementStatus.required;
}

Để xem danh sách đầy đủ các trạng thái yêu cầu đối với lựa chọn về quyền riêng tư, hãy xem PrivacyOptionsRequirementStatus.

Trình bày biểu mẫu các lựa chọn về quyền riêng tư

Khi người dùng tương tác với phần tử của bạn, hãy trình bày biểu mẫu lựa chọn về quyền riêng tư:

ConsentForm.showPrivacyOptionsForm((formError) {
  if (formError != null) {
    debugPrint("${formError.errorCode}: ${formError.message}