Trang này mô tả các tính năng mà Google Analytics cung cấp, cho phép bạn kiểm soát việc thu thập và sử dụng dữ liệu Analytics.
Tắt tính năng thu thập dữ liệu Analytics
Trong một số trường hợp, bạn có thể muốn tạm thời hoặc vĩnh viễn tắt tính năng thu thập dữ liệu Analytics, chẳng hạn như để thu thập sự đồng ý của người dùng cuối hoặc để thực hiện các nghĩa vụ pháp lý. Google Analytics cung cấp nhiều tuỳ chọn để tắt và huỷ kích hoạt tính năng thu thập Analytics. Khi được sử dụng cùng nhau, các tính năng này hỗ trợ nhiều trường hợp sử dụng thông thường.
Tạm thời tắt tính năng thu thập
Nếu muốn tạm thời tắt tính năng thu thập Analytics, chẳng hạn như để lấy sự đồng ý của người dùng cuối trước khi thu thập dữ liệu, bạn có thể đặt giá trị của FIREBASE_ANALYTICS_COLLECTION_ENABLED
thành NO
(Boolean) trong tệp Info.plist
của ứng dụng. Ví dụ: xem trong tệp XML nguồn:
<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>
Để bật lại tính năng thu thập, chẳng hạn như sau khi người dùng cuối đồng ý, hãy gọi phương thức thực thể setAnalyticsCollectionEnabled
của Analytics
. Ví dụ:
Swift
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
Nếu cần tạm ngưng lại việc thu thập dữ liệu vì bất kỳ lý do gì, bạn có thể gọi lệnh sau và việc thu thập dữ liệu sẽ bị tạm ngưng cho đến khi bạn bật lại.
Swift
Analytics.setAnalyticsCollectionEnabled(false)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:NO];
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);
Giá trị do phương thức setAnalyticsCollectionEnabled
đặt sẽ tồn tại trong các lần thực thi ứng dụng và ghi đè giá trị của FIREBASE_ANALYTICS_COLLECTION_ENABLED
trong tệp Info.plist
của ứng dụng. Sau khi bạn đặt giá trị cho setAnalyticsCollectionEnabled
, tính năng thu thập dữ liệu của Analytics sẽ vẫn ở trạng thái đó cho đến khi setAnalyticsCollectionEnabled
được gọi lại, ngay cả khi người dùng đóng và mở lại ứng dụng của bạn.
Vô hiệu hoá bộ sưu tập vĩnh viễn
Nếu bạn cần vô hiệu hoá vĩnh viễn tính năng thu thập Analytics trong một phiên bản ứng dụng, hãy đặt FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED
thành YES
(Boolean) trong tệp Info.plist
của ứng dụng. Việc đặt FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED
thành YES
(Boolean) sẽ được ưu tiên hơn mọi giá trị cho FIREBASE_ANALYTICS_COLLECTION_ENABLED
trong Info.plist
của ứng dụng cũng như mọi giá trị được đặt bằng setAnalyticsCollectionEnabled
.
Để bật lại tính năng thu thập, hãy xoá FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED
khỏi Info.plist
. Việc đặt FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED
thành NO
(Boolean) sẽ không có hiệu lực và dẫn đến hành vi tương tự như khi bạn không đặt FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED
trong tệp Info.plist
.
Tắt tính năng thu thập IDFA
Nếu bạn đã cài đặt Firebase thông qua CocoaPods bằng cách thêm pod 'Firebase/Analytics'
vào tệp Podfile của ứng dụng và muốn tắt tính năng thu thập IDFA (mã nhận dạng cho quảng cáo của thiết bị) trong ứng dụng Apple, hãy đảm bảo rằng khung AdSupport không có trong ứng dụng của bạn.
Để cài đặt Firebase mà không có bất kỳ tính năng thu thập IDFA nào, hãy sử dụng
subspec sau đây thay cho pod 'Firebase/Analytics'
:
pod 'Firebase/AnalyticsWithoutAdIdSupport'
Tìm hiểu thêm về IDFA trong tài liệu của Apple:
- Quyền riêng tư của người dùng và việc sử dụng dữ liệu
- Minh bạch về hoạt động theo dõi trong ứng dụng
Tắt tính năng thu thập IDFV
Nếu bạn muốn tắt tính năng thu thập IDFV (Mã nhận dạng cho nhà cung cấp) trong ứng dụng Apple, hãy đặt giá trị của GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED
thành NO
(Boolean) trong tệp Info.plist
của ứng dụng.
Kiểm soát việc thu thập dữ liệu cho quảng cáo được cá nhân hoá
Nếu bạn đã liên kết dự án Google Analytics với một tài khoản quảng cáo hoặc bật tính năng tích hợp quảng cáo hoặc chọn chia sẻ dữ liệu, thì dữ liệu Analytics của bạn có thể đủ điều kiện để sử dụng trong quảng cáo được cá nhân hoá.
Ví dụ: điều này có nghĩa là bạn có thể sử dụng các sự kiện đã thu thập như first_open
để tạo và triển khai danh sách đối tượng cho hoạt động tái tiếp thị, trừ phi bạn cho biết rằng dữ liệu đó không dùng được cho quảng cáo được cá nhân hoá.
Bạn có thể kiểm soát việc sử dụng dữ liệu Analytics của người dùng cho quảng cáo được cá nhân hoá bằng cách lập trình bằng bất kỳ lựa chọn nào sau đây:
Đề xuất: Tự động bật hoặc tắt tính năng cá nhân hoá quảng cáo bằng cách thực hiện lựa chọn đồng ý của người dùng. Triển khai API chế độ đồng ý của Google.
Bật hoặc tắt tính năng cá nhân hoá quảng cáo ở cấp người dùng: Kiểm soát tính năng cá nhân hoá quảng cáo dưới dạng thuộc tính người dùng.
Bật hoặc tắt tính năng cá nhân hoá quảng cáo ở cấp tài sản Analytics: Tắt tính năng cá nhân hoá quảng cáo theo khu vực địa lý trong tài sản Analytics.
Tắt các tính năng quảng cáo được cá nhân hoá thông qua thuộc tính người dùng
API chế độ đồng ý của Google là cách đề xuất để bật và tắt quảng cáo được cá nhân hoá.Tuy nhiên, nếu ứng dụng của bạn chưa sử dụng chế độ đồng ý, bạn có thể kiểm soát tính năng cá nhân hoá bằng tuỳ chọn sau.
Để tắt hành vi quảng cáo được cá nhân hoá theo mặc định, hãy đặt giá trị của GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS
thành NO
(Boolean) trong tệp Info.plist
của ứng dụng.
Bật lại các tính năng quảng cáo được cá nhân hoá thông qua tài sản người dùng
Nếu sử dụng tham số AnalyticsUserPropertyAllowAdPersonalizationSignals
để kiểm soát tính năng cá nhân hoá quảng cáo, bạn có thể bật lại tính năng này bằng phương thức setUserProperty
như sau:
Swift
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Objective-C
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);
Nếu bạn đã chọn tạm thời tắt tính năng thu thập dữ liệu phân tích (ví dụ: cho đến khi người dùng cuối đồng ý) và bạn muốn kiểm soát các tính năng quảng cáo được cá nhân hoá khi bật lại tính năng thu thập dữ liệu phân tích cho người dùng, hãy đảm bảo rằng lệnh gọi để chỉ định chế độ cài đặt này phải được thực hiện trước lệnh gọi để bật lại tính năng thu thập dữ liệu phân tích. Ví dụ:
Swift
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
Xác nhận các chế độ cài đặt của bạn
Khi tín hiệu cá nhân hoá quảng cáo đã bị tắt cho một người dùng thông qua một trong các cơ chế được xác định ở trên, các gói sự kiện tiếp theo được ghi lại từ thiết bị của người dùng đó sẽ chứa một thuộc tính người dùng có tên là non_personalized_ads
với giá trị là 1 để cho biết rằng các sự kiện trong gói đó không dùng được cho quảng cáo được cá nhân hoá. Việc tắt tính năng quảng cáo được cá nhân hoá không ảnh hưởng đến việc sử dụng dữ liệu cho mục đích đo lường, bao gồm cả báo cáo và phân bổ.
Xem các thay đổi về cấu hình
Sau khi bạn thực hiện thay đổi đối với chế độ cài đặt Google Analytics, SDK sẽ tải các thay đổi đó xuống. Quy trình này diễn ra nhanh chóng và liền mạch, nhờ đó, bạn có thể nhanh chóng kiểm thử các thay đổi. Khi bạn thực hiện thay đổi trong Analytics, có thể mất vài phút để triển khai trong ứng dụng. Nếu ứng dụng của bạn đang hoạt động, thì quá trình triển khai đầy đủ có thể mất tối đa một giờ để hoàn tất.