Skip to main content

Analytics SDK for iOS

GGAnalytics cung cấp giải pháp đo lường ứng dụng, cùng các thông tin chi tiết về việc sử dụng ứng dụng và mức độ tương tác của người dùng.

Tham khảo Demo

Tích hợp​

GGAnalytics cung cấp 2 giải pháp để tích hợp vào ứng dụng của bạn:

Swift Package Manager

dependencies: [
   .package(url: "https://bitbucket.org/vngecn/ecn-ios-sdk.git", from: "0.6.0"),
]

Sau đó, từ Xcode, chọn Target mà bạn muốn sử dụng SDK, mở tab General -> Framworks, Libraries and Embedded Content -> chọn GGAnalytics

CocoaPods

source 'https://github.com/CocoaPods/Specs.git'
source 'git@bitbucket.org:vngecn/cocoapods-specs.git'

pod 'GGAnalytics', '~> 0.6.0'

Cấu hình ứng dụng​

Thêm đoạn mã sau vào file Info.plist của ứng dụng:

<key>GGVNGClientID</key>
<string>client_id</string>

<key>GGVNGClientToken</key>
<string>client_token</string>
Thay thế `client_id`, `client_token` bằng `Client ID` và `Client Token` mà GG cấp của ứng dụng của bạn.

Cách sử dụng​

Tracking Session​

Mỗi event tạo ra sẽ được gắn kèm với một Tracking Session ID, giá trị này mặc định sẽ được GGAnalytics khởi tạo mỗi khi ứng dụng được khởi tạo.

Bạn cần gọi câu lệnh sau để bắt đầu tracking hoặc chủ động khởi tạo lại Tracking Session ID:

GGAnalytics.startNewSession(<event_parameters>)

Track Event​

GGAnalytics.trackEvent("<event_name>")

// Sử dụng câu lệnh này nếu bạn muốn gửi kèm tham số
GGAnalytics.trackEvent("<event_name>", parameters: <event_parameters>)

Các tham số được yêu cầu bởi GGAnalytics được mô tả trong tài liệu này.

Tuỳ chỉnh cấu hình​

GGAnalytics hỗ trợ tuỳ chỉnh một số cấu hình cơ bản tuỳ thuộc vào nhu cầu sử dụng của bạn:

GGAnalytics.setConfiguration(
    GGAnalytics.Configuration(
        // The maximum size of an event batch to be sent.
        maxBatchSize: 10,

        // The threshold in which the events should be sent at least once,
        // regardless of the number of current records.
        eventSendingThresholdInSeconds: 30,

        // The maximum number of requests that can be sent at the same time.
        maxConcurrentRequestCount: 3,

        // The maximum number of times that a request can be retried.
        maxRetryCount: 2
    )
)

Môi trường Sandbox​

Bạn có thể chuyển sang môi trường sandbox bằng câu lệnh sau:

GGAnalytics.enableSandbox(true)

Release Changelog​

Theo dõi thay đổi của từng phiên bản tại đây.

Hỗ trợ​

Nếu có thắc mắc trong quá trình tích hợp, bạn có thể liên hệ trực tiếp qua email BaoNQ3 để được trợ giúp.