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

Chọn nền tảng: iOS+ Android

Trang này mô tả các tính năng mà Google Analytics cung cấ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 lựa chọn để tắt và huỷ kích hoạt tính năng thu thập dữ liệu Analytics. Khi được sử dụng cùng nhau, các lựa chọn này sẽ hỗ trợ nhiều trường hợp sử dụng điển hình.

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

Nếu muốn tạm thời 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 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ụ: khi xem trong XML nguồn:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>

Để bật lại tính năng thu thập dữ liệu, 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

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

Objective-C

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

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Nếu cần tạm dừng thu thập lại vì bất kỳ lý do nào, bạn có thể gọi lệnh sau và quá trình thu thập sẽ bị tạm dừng cho đến khi bạn bật lại.

Swift

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu macOS. 
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 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.

Huỷ kích hoạt vĩnh viễn tính năng thu thập dữ liệu

Nếu cần huỷ kích hoạt vĩnh viễn tính năng thu thập dữ liệu Analytics trong một phiên bản của ứ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ó mức độ ưu tiên cao hơn mọi giá trị của 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 dữ liệu, hãy xoá FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED khỏi Info.plist. Việc đặt FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED thành NO (Boolean) không có hiệu lực và dẫn đến hành vi tương tự như khi 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 mô-đun FirebaseAnalytics vào ứng dụng thông qua SPM hoặc CocoaPods và muốn tắt tính năng thu thập IDFA (mã nhận dạng 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ài đặt Firebase mà không có khả năng thu thập IDFA, hãy sử dụng phần sau thay vì phần phụ thuộc FirebaseAnalytics:

Trình quản lý gói Swift

  .target(
    name: "MyTargetName",
    dependencies: [
      .product(name: "FirebaseAnalyticsCore", package: "Firebase"),
      // ...
    ]
  ),

CocoaPods

pod 'FirebaseAnalytics/Core'

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

Tắt tính năng thu thập IDFV

Nếu muốn tắt tính năng thu thập IDFV (Mã nhận dạng 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á. Điều này có nghĩa là chẳng hạn, 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 tiếp thị lại, trừ phi 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ể kiểm soát theo phương thức lập trình việc có nên sử dụng dữ liệu Analytics của người dùng cho quảng cáo được cá nhân hoá hay không bằng cách sử dụng bất kỳ lựa chọn nào sau đây:

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 cho chế độ đồng ý của Google là cách được đề 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 lựa 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 thuộc tính 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 cá nhân hoá quảng cáo bằng setUserProperty như minh hoạ bên dưới:

Swift

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

Objective-C

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu macOS. 
[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à 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

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

Objective-C

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu macOS. 
[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 các tín hiệu cá nhân hoá quảng cáo đã bị tắt đối với 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 có sẵn 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ả việc báo cáo và phân bổ.

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

Sau khi bạn thay đổi các chế độ cài đặt của Google Analytics, SDK sẽ tải các thay đổi đó xuống. Quá trình này diễn ra nhanh chóng và liền mạch, vì vậy, bạn có thể nhanh chóng kiểm thử các thay đổi. Khi bạ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ì toàn bộ quá trình triển khai có thể mất tối đa một giờ để hoàn tất.