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

Google Analytics cung cấp các tính năng cho phép bạn kiểm soát việc thu thập và sử dụng dữ liệu Analytics.

Tắt thu thập dữ liệu Analytics

Trong một số trường hợp, bạn có thể muốn tắt tạm thời hoặc vĩnh viễn việc 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 nghĩa vụ pháp lý. Google Analytics cung cấp nhiều tùy chọn để vô hiệu hóa và hủy kích hoạt bộ sưu tập Analytics. Được sử dụng cùng nhau, chúng hỗ trợ nhiều trường hợp sử dụng điển hình.

Tạm thời vô hiệu hóa bộ sưu tập

Nếu muốn tạm thời vô hiệu hóa việc thu thập Analytics, chẳng hạn như để có được sự đồng ý của người dùng cuối trước khi thu thập dữ liệu, thì bạn có thể đặt giá trị FIREBASE_ANALYTICS_COLLECTION_ENABLED thành NO (Boolean) trong tệp Info.plist của ứng dụng. Ví dụ: được xem trong XML nguồn:

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

Để bật lại bộ sưu tập, chẳng hạn như sau khi người dùng cuối đồng ý, hãy gọi phương thức phiên bản setAnalyticsCollectionEnabled của Analytics . Ví dụ:

Nhanh

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

Mục tiêu-C

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

Nếu bạn cần tạm dừng việc thu thập lại vì bất kỳ lý do gì, bạn có thể gọi

Nhanh

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

Mục tiêu-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

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

Vô hiệu hóa vĩnh viễn bộ sưu tập

Nếu bạn cần tắt vĩnh viễn bộ sưu tập Analytics trong một phiên bản ứng dụng của mình, 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 .

Để kích hoạt lại bộ sưu tập, hãy xóa FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED khỏi Info.plist của bạn. Việc đặt FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED thành NO (Boolean) không có tác dụng và dẫn đến hành vi tương tự như không đặt FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED trong tệp Info.plist của bạn.

Vô hiệu hóa việc 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 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 đư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ố kỹ thuật phụ sau 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 (Mã định danh cho nhà cung cấp) trong ứng dụng Apple của mình, hãy đặt giá trị 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 của mình với một tài khoản quảng cáo hoặc đã bật 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 hóa. Ví dụ: điều này có nghĩa là bạn có thể sử dụng các sự kiện được 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ừ 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 hóa.

Bạn có thể kiểm soát theo chương trình xem 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 hóa hay không bằng cách sử dụng bất kỳ tùy chọn nào sau đây:

Tắt các 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 Googlelà cách được đề xuất để bật và tắt quảng cáo được cá nhân hóa.

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 hoạt động cá nhân hóa bằng tùy 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 thành NO (Boolean) trong tệp Info.plist của ứng dụng của bạn.

Kích hoạt lại các 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

Nếu sử dụng thông số AnalyticsUserPropertyAllowAdPersonalizationSignals để kiểm soát việc cá nhân hóa quảng cáo, thì bạn có thể bật lại tính năng cá nhân hóa quảng cáo bằng phương thức setUserProperty như hiển thị bên dưới:

Nhanh

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

Mục tiêu-C

Lưu ý: Sản phẩm Firebase này không có sẵn trên mục tiêu macOS.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Nếu bạn đã chọn tạm thời tắt tính năng thu thập 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 hóa khi bật lại tính năng thu thập phân tích cho người dùng, hãy đảm bảo rằng lệnh gọi của bạn để chỉ định cài đặt này diễn ra trước gọi để kích hoạt lại bộ sưu tập phân tích. Ví dụ:

Nhanh

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

Mục tiêu-C

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

Xác nhận cài đặt của bạn

Khi tín hiệu cá nhân hóa 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 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 có sẵn cho cá nhân hóa 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 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 của bạn

Khi bạn đã thực hiện các thay đổi đối với cài đặt Google Analytics của mình, 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 tra các thay đổi của mình. Khi bạn thực hiện các thay đổi trong Analytics, có thể mất vài phút để triển khai trong ứng dụng của bạn. 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 một giờ để hoàn tất.