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 ý. Để tìm hiểu 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 và nâng cao và kiểm tra các nguyên tắc của công ty.
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ữ chế độ cài đặt lấy sự đồng ý để ghi nhận sự đồng ý của người dùng
Thiết lập chế độ đồng ý
Để thiết lập chế độ đồng ý, bạn cần:
Đặt trạng thái đồng ý mặc định
Theo mặc định, không có giá trị nào của chế độ đồng ý được đặt. Cách đặt trạng thái đồng ý mặc định cho ứng dụng của bạn:
- Mở tệp info.plist của ứng dụng.
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 ý. Các giá trị có thể là
true
, nghĩa là người dùng đã đồng ý hoặcfalse
(tức là người dùng đã từ chối đồng ý). Hãy thiết lập như 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
Lưu các thay đổi. Tiếp theo, hãy triển khai cơ chế cập nhật các giá trị đồng ý.
Ví dụ: để đặt tất cả trạng thái đồng ý cấp quyền cho tất cả thông số 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 sự đồng ý
Để cập nhật các giá trị về sự đồng ý sau khi một ứng dụng 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à vẫn tồn tại 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 tham số mà bạn chỉ định.
Nếu người dùng rút lại sự đồng ý đã cho trước đó đối với 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 ý đối với
ad_personalization
. Để giữ lại 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ụngsetConsent
(Swift | Obj-C) .
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
:
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 ý theo
Nâng cấp lên chế độ đồng ý phiên bản 2
Theo cam kết lâu dài của Google về một hệ sinh thái quảng cáo kỹ thuật số đảm bảo quyền riêng tư, chúng tôi đ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).
Ngoài việc lưu trữ quảng cáo và lưu trữ số liệu phân tích, người dùng ở chế độ đồng ý cần phải gửi 2 thông số mới:
Cập nhật tệp info.plist của ứng dụng để bao gồm:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/> <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
Cập nhật các lệnh gọi yêu cầu đồng ý để đưa các thông số cho dữ liệu người dùng quảng cáo và hoạt động cá nhân hoá quảng cáo vào:
Swift
Analytics.setConsent([ .analyticsStorage: .granted, .adStorage: .granted, .adUserData: .granted, .adPersonalization: .granted, ])
Objective-C
[FIRAnalytics setConsent:@{ FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted, FIRConsentTypeAdStorage : FIRConsentStatusGranted, FIRConsentTypeAdUserData : FIRConsentStatusGranted, FIRConsentTypeAdPersonalization : FIRConsentStatusGranted, }];
Xác minh chế độ cài đặt lấy sự đồng ý
Bạn có thể xác minh rằng chế độ cài đặt lấy sự đồng ý đang hoạt động như dự kiến bằng cách xem bảng điều khiển gỡ lỗi CameraX cho ứng dụng của mình.
Hãy làm theo các bước sau:
- Bật tính năng ghi nhật ký chi tiết trên thiết bị của bạn.
Trong bảng điều khiển gỡ lỗi của Xcode, hãy tìm:
ad_storage
analytics_storage
ad_user_data
ad_personalization
Ví dụ: nếu Bộ nhớ quảng cáo đang bật, bạn sẽ thấy thông báo sau:
ad_storage is granted.