Định cấu hình hoạt động thu thập và sử dụng dữ liệu Analytics


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 phân tích, 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 yêu cầu pháp lý nghĩa vụ bổ sung. Google Analytics cung cấp nhiều tuỳ chọn để vô hiệu hoá và huỷ kích hoạt bộ sưu tập Analytics. Khi được sử dụng cùng nhau, chúng hỗ trợ nhiều các trường hợp sử dụng thông thường.

Tạm thời tắt tính năng thu thập dữ liệu

Nếu bạn muốn tạm thời vô hiệu hoá tính năng thu thập Analytics, chẳng hạn như để 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ị FIREBASE_ANALYTICS_COLLECTION_ENABLED đến NO (Boolean) trong ứng dụng của bạn Info.plist. Ví dụ như được xem trong 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 setAnalyticsCollectionEnabled phương thức thực thể của Analytics. Ví dụ:

Swift

Lưu ý: Sản phẩm Firebase này không dành cho macOS mục tiêu.
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Lưu ý: Sản phẩm Firebase này không dành cho macOS mục tiêu.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Nếu cần tạm ngưng thu thập lại vì bất kỳ lý do gì, bạn có thể gọi hàm việc theo dõi và bộ sưu tập sẽ bị tạm ngưng cho đến khi bạn bật lại tính năng này.

Swift

Lưu ý: Sản phẩm Firebase này không dành cho macOS mục tiêu.
Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

Giá trị do phương thức setAnalyticsCollectionEnabled đặt sẽ vẫn tồn tại trên ứng dụng lần thực thi và ghi đè giá trị cho FIREBASE_ANALYTICS_COLLECTION_ENABLED trong tệp Info.plist của ứng dụng. Sau khi đặt giá trị cho setAnalyticsCollectionEnabled, bộ sưu tập Analytics 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.

Huỷ kích hoạt vĩnh viễn bộ sưu tập

Nếu bạn cần tắt vĩnh viễn tính năng thu thập Analytics trong một phiên bản của hãy đặt FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED thành YES (Boolean) trong tệp Info.plist của ứng dụng. Đang đặt FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED thành YES (Boolean) được ưu tiên hơn bất kỳ giá trị nào cho FIREBASE_ANALYTICS_COLLECTION_ENABLED trong Info.plist của ứng dụng cũng như bất kỳ các giá trị được đặt bằng setAnalyticsCollectionEnabled.

Để bật lại bộ sưu tập, hãy xoá FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED khỏi Info.plist của bạn. Đang đặt FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED thành NO (Boolean) không có tác dụng và dẫn đến hành vi giống như khi không có Đã đặ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 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 trên mỗi thiết bị) mã nhận dạng cho quảng cáo) trong ứng dụng Apple của bạn, hãy đảm bảo rằng khung AdSupport không được đưa vào ứng dụng của bạn.

Để cài đặt Firebase mà không có bất kỳ khả năng thu thập IDFA nào, hãy sử dụng thông số phụ thay cho pod 'Firebase/Analytics':

pod 'Firebase/AnalyticsWithoutAdIdSupport'

Tìm hiểu thêm về IDFA trong tài liệu của Apple:

Tắt bộ sưu tập IDFV

Nếu bạn muốn tắt tính năng thu thập IDFV (Giá trị nhận dạng cho nhà cung cấp) trong Ứng dụng Apple, đặ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 hóa

Nếu bạn đã liên kết dự án Google Analytics với một tài khoản Google Ads hoặc đã bật tính năng tích hợp quảng cáo hoặc chọn tham gia chia sẻ dữ liệu, 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ụ: 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 tiếp thị lại trừ khi bạn cho biết rằng dữ liệu đó không có sẵn cho quảng cáo được cá nhân hoá.

Bạn có thể lập trình để kiểm soát việc có nên sử dụng dữ liệu Analytics của người dùng hay không cho quảng cáo được cá nhân hoá bằng cách sử dụng bất kỳ tuỳ chọn nào sau đây:

Tắt tính năng quảng cáo được cá nhân hóa thông qua thuộc tính người dùng

API chế độ đồng ý của Google là cách bạn nên dùng để 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 ý, thì bạn có thể kiểm soát cá nhân hoá bằng tuỳ chọn sau.

Để tắt hành vi quảng cáo được cá nhân hóa theo mặc định, hãy đặt giá trị của GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS đến NO (Boolean) trong tệp Info.plist của ứng dụng.

Bật lại tính năng quảng cáo được cá nhân hoá thông qua thuộc tính người dùng

Nếu bạn sử dụng tham số AnalyticsUserPropertyAllowAdPersonalizationSignals Để kiểm soát chế độ cá nhân hóa quảng cáo, bạn có thể bật lại chế độ cá nhân hóa quảng cáo với setUserProperty như được hiển thị dưới đây:

Swift

Lưu ý: Sản phẩm Firebase này không dành cho macOS mục tiêu.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

Lưu ý: Sản phẩm Firebase này không dành cho macOS mục tiêu.
[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 số 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 sau khi bật lại tính năng thu thập số liệu phân tích cho người dùng, hãy đảm bảo rằng khi bạn thực hiện yêu cầu chỉ định chế độ cài đặt này trước khi thực hiện cuộc gọi để bật lại số liệu phân tích bộ sưu tập. Ví dụ:

Swift

Lưu ý: Sản phẩm Firebase này không dành cho macOS mục tiêu.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Lưu ý: Sản phẩm Firebase này không dành cho macOS mục tiêu.
[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 đối với một người dùng thông qua một trong 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ị sẽ chứa một thuộc tính người dùng có tên non_personalized_ads với giá trị là 1 để cho biết rằng các sự kiện trong gói đó không hỗ trợ việc cá nhân hoá quảng cáo. Việc tắt quảng cáo được cá nhân hóa không ảnh hưởng đến việc sử dụng cho mục đích đo lường, bao gồm cả việc báo cáo và phân bổ.

Xem các thay đổi về cấu hình

Khi bạn đã thực hiện thay đổi đối với cài đặt Google Analytics của mình, SDK tải xuống các thay đổi. Quá trình này diễn ra nhanh chóng và liền mạch nên bạn có thể nhanh chóng thử nghiệm các thay đổi của bạn. Khi bạn thực hiện các thay đổi trong Analytics, quá trình này có thể mất vài phút để triển khai trong ứng dụng của mình. Nếu ứng dụng của bạn đang hoạt động, toàn bộ quy trình triển khai có thể mất lên đến 1 giờ để hoàn tất.