Catch up on everthing we announced at this year's Firebase Summit. Learn more

Bắt đầu với Google Analytics

Phần khởi động nhanh này chỉ cho bạn cách thêm Google Analytics vào ứng dụng của bạn và bắt đầu ghi nhật ký các sự kiện.

Google Analytics thu thập dữ liệu sử dụng và hành vi cho ứng dụng của bạn. SDK ghi lại hai loại thông tin chính:

  • Sự kiện: Điều gì đang xảy ra trong ứng dụng của bạn, chẳng hạn như hành động của người dùng, các sự kiện hệ thống, hoặc sai sót.
  • User Properties: Các thuộc tính bạn xác định để mô tả các phân đoạn của cơ sở người dùng của bạn, chẳng hạn như ngôn ngữ ưu tiên hoặc vị trí địa lý.

Analytics tự động đăng nhập một số sự kiệntính chất sử dụng ; bạn không cần thêm bất kỳ mã nào để kích hoạt chúng.

Trước khi bắt đầu

  1. Nếu bạn chưa sẵn sàng, thêm căn cứ hỏa lực cho dự án Apple của bạn và chắc chắn rằng Google Analytics được kích hoạt trong dự án căn cứ hỏa lực của bạn:

    • Nếu bạn đang tạo một dự án Firebase mới, hãy bật Google Analytics trong quá trình tạo dự án.

    • Nếu bạn đang sử dụng một dự án căn cứ hỏa lực hiện có mà không có kích hoạt Google Analytics, đi đến Tích hợp tab của bạn > Cài đặt Project để kích hoạt nó.

    Khi bạn bật Google Analytics trong dự án của mình, các ứng dụng Firebase của bạn được liên kết với các luồng dữ liệu Google Analytics.

  2. (Recommended). Thêm khuôn khổ AdSupport để dự án của bạn để cho phép các tính năng bổ sung như khán giả và ghi công chiến dịch.

Thêm SDK Analytics vào ứng dụng của bạn

Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc của Firebase.

  1. Trong Xcode, với dự án ứng dụng của bạn mở, điều hướng tới File> Swift gói> Thêm gói phụ thuộc.
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. Chọn thư viện Analytics.
  5. Đối với một kinh nghiệm tối ưu với Analytics, chúng tôi khuyên bạn nên cho phép Google Analytics trong dự án căn cứ hỏa lực của bạn và thêm SDK căn cứ hỏa lực cho Google Analytics để ứng dụng của bạn. Bạn có thể chọn thư viện không có bộ sưu tập IDFA hoặc có bộ sưu tập IDFA.
  6. Khi hoàn tất, Xcode sẽ tự động bắt đầu giải quyết và tải xuống các phần phụ thuộc của bạn trong nền.

Tìm hiểu thêm về IDFA, nhận dạng quảng cáo cấp thiết bị, trong của Apple tài khoản riêng tư và dữ liệu sử dụngtheo dõi ứng dụng minh bạch tài liệu.

Tiếp theo, thực hiện một số bước cấu hình:

  1. Nhập module căn cứ hỏa lực trong bạn UIApplicationDelegate :

    Nhanh

    import Firebase

    Objective-C

    @import Firebase;
  2. Cấu hình một FirebaseApp chia sẻ Ví dụ, điển hình là trong ứng dụng của bạn application:didFinishLaunchingWithOptions: phương pháp:

    Nhanh

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];


(Tùy chọn) Tắt đăng ký thuộc tính mạng quảng cáo của Apple

Để tiện cho bạn, SDK sẽ tự động đăng ký ứng dụng của bạn với Apple để ghi công mạng quảng cáo với SKAdNetwork . Nếu bạn muốn vô hiệu hóa tính năng này, thiết lập giá trị của GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED để NO (Boolean) trong file info.plist của ứng dụng.

Bắt đầu ghi nhật ký sự kiện

Sau khi bạn đã cấu hình FirebaseApp Ví dụ, bạn có thể bắt đầu đăng nhập sự kiện với logEvent() phương pháp.

Một số sự kiện được đề nghị cho tất cả các ứng dụng ; những người khác được đề xuất cho các loại hình kinh doanh hoặc ngành dọc cụ thể. Bạn nên gửi các sự kiện được đề xuất cùng với các thông số được chỉ định của chúng, để đảm bảo thông tin chi tiết có sẵn tối đa trong báo cáo của bạn và để hưởng lợi từ các tính năng và tích hợp trong tương lai khi chúng có sẵn. Phần này chứng tỏ một sự kiện đăng nhập được xác định trước, để biết thêm thông tin về các sự kiện đăng nhập, xem Log sự kiện .

Ví dụ sau minh họa cách ghi lại sự kiện được đề xuất để cho biết người dùng đã nhấp vào một phần tử cụ thể trong ứng dụng của bạn:

Nhanh

Lưu ý: sản phẩm căn cứ hỏa lực này không có sẵn trên hệ điều hành MacOS mục tiêu.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objective-C

Lưu ý: sản phẩm căn cứ hỏa lực này không có sẵn trên hệ điều hành MacOS mục tiêu.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

Để xem sự kiện này trong bảng điều khiển gỡ lỗi Xcode, hãy bật gỡ lỗi Analytics:

  1. Trong Xcode, chọn sản phẩm> Scheme> Chỉnh sửa chương trình ...
  2. Chọn Run từ menu bên trái.
  3. Chọn tab Arguments.
  4. Trong luận cứ truyền Launch phần, add -FIRAnalyticsDebugEnabled .

Bước tiếp theo