Thiết lập chế độ đồng ý cho ứng dụng

Trang này dành cho các nhà phát triển sử dụng SDK Google Analytics cho Firebase trong ứng dụng và muốn tích hợp chế độ đồng ý. Để biết thông tin giới thiệu về chế độ đồng ý, hãy đọc bài viết Tổng quan về chế độ đồng ý.

Google Analytics cung cấp chế độ đồng ý để điều chỉnh cách hoạt động của SDK dựa trên trạng thái đồng ý của người dùng. Bạn có thể triển khai chế độ đồng ý theo cách cơ bản hoặc nâng cao. Nếu bạn không chắc nên triển khai chế độ đồng ý cơ bản hay nâng cao, hãy tìm hiểu thêm về chế độ đồng ý cơ bản so với chế độ đồng ý nâng cao và tham khảo nguyên tắc của công ty bạn.

Trước khi bắt đầu

Để có thể quản lý sự đồng ý của người dùng, bạn cần triển khai:

  • SDK Google Analytics cho Firebase

  • Biểu ngữ cài đặt về sự đồng ý để thu thập sự đồng ý của người dùng

Để thiết lập chế độ đồng ý, bạn cần phải:

  1. Đặt trạng thái đồng ý mặc định.

Theo mặc định, hệ thống không đặt giá trị nào cho chế độ đồng ý. Cách đặt trạng thái đồng ý mặc định cho ứng dụng:

  1. Mở tệp AndroidManifest.xml của ứng dụng.

  2. Thêm cặp khoá-giá trị của chế độ đồng ý. Khoá mô tả loại đồng ý và giá trị cho biết trạng thái đồng ý. Giá trị có thể là true, nghĩa là người dùng đã đồng ý hoặc false, nghĩa là người dùng đã từ chối.

    Theo nội dung cập nhật đối với chế độ đồng ý cho lưu lượng truy cập ở Khu vực kinh tế Châu Âu (EEA), bạn có thể đặt giá trị eu_consent_policy cho ad_user_data và ad_personalization, nghĩa là chỉ từ chối sự đồng ý đối với người dùng ở những khu vực chịu sự điều chỉnh của Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu.

    Thiết lập những thông tin sau:

    • google_analytics_default_allow_analytics_storage
    • google_analytics_default_allow_ad_storage
    • google_analytics_default_allow_ad_user_data
    • google_analytics_default_allow_ad_personalization_signals

  3. Lưu các thay đổi. Tiếp theo, hãy triển khai cơ chế để cập nhật giá trị đồng ý.

Ví dụ: để đặt tất cả trạng thái đồng ý cho tất cả thông số theo mặc định, hãy làm như sau:

<meta-data android:name="google_analytics_default_allow_analytics_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />

Để cập nhật giá trị đồng ý sau khi ứng dụng khởi chạy, hãy gọi phương thức setConsent.

Giá trị do phương thức setConsent đặt sẽ ghi đè chế độ cài đặt mặc định và duy trì trong các quá trình thực thi ứng dụng. Giá trị này vẫn ở trạng thái đó cho đến khi setConsent được gọi lại, ngay cả khi người dùng đóng và mở lại ứng dụng. setConsent chỉ cập nhật các tham số mà bạn chỉ định.

Nếu người dùng rút lại sự đồng ý trước đó đối với Analytics hoặc tính năng lưu trữ quảng cáo, thì Google Analytics sẽ xoá tất cả tài sản người dùng, bao gồm cả sự đồng ý đối với ad_personalization. Để giữ nguyên lựa chọn đồng ý của người dùng về việc cá nhân hoá quảng cáo, hãy khôi phục giá trị trước đó cho tính năng cá nhân hoá quảng cáo bằng cách sử dụng setConsent (Kotlin+KTX | Java) .

Ví dụ sau đây cho thấy phương thức setConsent cập nhật các giá trị đồng ý khác nhau thành granted:

Java

// Set consent types.
Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);

mFirebaseAnalytics.setConsent(consentMap);

Kotlin

Firebase.analytics.setConsent {
  analyticsStorage(ConsentStatus.GRANTED)
  adStorage(ConsentStatus.GRANTED)
  adUserData(ConsentStatus.GRANTED)
  adPersonalization(ConsentStatus.GRANTED)
}

Nếu người dùng quyết định thu hồi sự đồng ý, hãy nhớ cập nhật trạng thái đồng ý cho phù hợp

Để thực hiện cam kết không ngừng xây dựng một hệ sinh thái quảng cáo kỹ thuật số đảm bảo quyền riêng tư, Google đang tăng cường việc thực thi Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu.

Tìm hiểu thêm về Nội dung cập nhật của Google đối với chế độ đồng ý cho lưu lượng truy cập ở Khu vực kinh tế Châu Âu (EEA).

Người dùng chế độ đồng ý cần gửi thêm 2 thông số mới ngoài bộ nhớ quảng cáo và bộ nhớ phân tích:

  1. Cập nhật tệp AndroidManifest.xml của ứng dụng để thêm:

    <meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />
```

  2. Cập nhật lệnh gọi đồng ý để thêm các tham số cho dữ liệu người dùng quảng cáo và tính năng cá nhân hoá quảng cáo:

    Java

    // Set consent types.
Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);

mFirebaseAnalytics.setConsent(consentMap);

    Kotlin

    Firebase.analytics.setConsent {
  analyticsStorage(ConsentStatus.GRANTED)
  adStorage(ConsentStatus.GRANTED)
  adUserData(ConsentStatus.GRANTED)
  adPersonalization(ConsentStatus.GRANTED)
}

Bạn có thể xác minh rằng chế độ cài đặt về sự đồng ý của mình đang hoạt động như dự kiến bằng cách xem thông báo nhật ký cho ứng dụng.

Hãy làm theo các bước sau:

  1. Bật tính năng ghi nhật ký chi tiết trên thiết bị của bạn.

  2. Trong logcat của Android Studio, hãy tìm thông báo nhật ký bắt đầu bằng Setting consent. Ví dụ: nếu Bộ nhớ quảng cáo đang bật, bạn sẽ thấy thông báo nhật ký sau:

    Setting consent, ... AD_STORAGE=granted