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

Trang này dành cho những nhà phát triển sử dụng SDK Google Analytics cho Firebase trong ứng dụng của họ 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 chắn 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

Trước khi 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 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 info.plist 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 (tức là đã đồng ý) hoặc false (tức là đã 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, tức là chỉ từ chối sự đồng ý của người dùng ở những khu vực phải tuân thủ 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 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ả các tham số đều được cấp quyền đồng ý theo mặc định:

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

Để cập nhật giá trị đồng ý sau khi ứng dụng đã ra mắt, 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 quá trình thực thi ứng dụng. Giá trị 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 thông số mà bạn chỉ định.

Nếu người dùng rút lại sự đồng ý đã đưa ra trước đó cho Analytics hoặc bộ nhớ Quảng cáo, thì Google Analytics sẽ xoá tất cả các thuộc tính người dùng, bao gồm cả sự đồng ý cho ad_personalization. Để lưu giữ lựa chọn đồng ý của người dùng cho hoạt động cá nhân hoá quảng cáo, hãy khôi phục giá trị trước đó cho hoạt động cá nhân hoá quảng cáo bằng cách sử dụng setConsent (Swift | Obj-C).

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

Swift

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

Objective-C

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

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 đối với chế độ đồng ý cho lưu lượng truy cập ở Khu vực kinh tế Châu Âu (EEA) của Google.

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ớ Analytics:

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

    <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

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

    Swift

    Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])

    Objective-C

    [FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

Bạn có thể xác minh rằng chế độ cài đặt về sự đồng ý đang hoạt động như dự kiến bằng cách xem bảng điều khiển gỡ lỗi Xcode cho ứng dụng của mình.

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 bảng điều khiển gỡ lỗi Xcode, hãy tìm:

    • ad_storage
    • analytics_storage
    • ad_user_data
    • ad_personalization

    Ví dụ: nếu bật bộ nhớ Quảng cáo, bạn sẽ thấy thông báo sau:

    ad_storage is granted.