Các hàm log tự động

Hiện SDK có 2 log được thực hiện tự động là:

• RetentionLog: thống kê retention của người chơi, được xử lý thông qua class RetentionCounter.

• UserTotalTimeLog: thống kê tổng thời gian chơi game của người chơi mỗi lần chơi, được xử lý thông qua class TotalUserTimeCounter.

1. RetentionCounter

• Thực hiện gọi log một lần mỗi ngày khi người chơi đăng nhập, retention của người chơi được tính bằng cách lấy ngày hiện tại trừ đi ngày đăng nhập đầu tiên (Ví dụ người chơi đang nhập lần đầu vào ngày 2/3, nghỉ game ngày 3/3 và 4/3, sau đó lại đăng nhập ngày 5/3, thì retention của người chơi vào ngày 5/3 sẽ được tính là 5-2 = 3).

• Cung cấp một số thông tin về Retention của người chơi, gồm có :

  • Retention(int): Chỉ số Retention hiện tại của người chơi.

  • RetentionChanged(bool): chỉ số Retention có thay đổi vào lần đăng nhập hiện tại của người chơi không (tức lần đăng nhập hiện tại của người chơi có phải lần đăng nhập đầu tiên trong ngày).

  • FirstLoginDate(DateTime): ngày đăng nhập đầu tiên của người chơi (không tính giờ, phút, giây).

Lưu ý:

• Các thông tin về Retention được lưu lại trên máy local của người chơi, và sẽ bị mất nếu người chơi gỡ cài đặt game.

• Với các game vừa mới tích hợp SDK lần đầu thì tất cả các thiết bị cũ khi cập nhật đều sẽ bị tính là retention = 0 do không có dữ liệu trên thiết bị để tính toán. Sẽ mất một khoảng thời gian tương đối để ổn định dữ liệu (tầm 1 tuần).

VD:

Debug.Log("Chỉ số Retention của người chơi là: " + RetentionCounter.Retention);
if(RetentionCounter.RetentionChanged) {
        Debug.Log("Đây là lần đăng nhập đầu tiên của người chơi trong ngày");
} else {
        Debug.Log("Đây không phải lần đăng nhập đầu tiên của người chơi trong ngày");
}
Debug.Log("Ngày đăng nhập đầu tiên của người chơi là: " + RetentionCounter.FirstLoginDate);

2. TotalUseTimeCounter

• Thực hiện đếm tổng thời chơi game của người chơi trong 1 lần chơi, việc đếm thời gian chơi game không tính khoảng thời gian người chơi thoát khỏi cửa sổ chơi game (khi người chơi bấm nút home/app overview trên điện thoại).

• Cung cấp một số thông tin về Session của người chơi, gồm có:

  • CurrentSessionTimeSec: thời gian phiên hiện tại của người chơi (tính theo giây, đếm từ lúc hàm FalconMain.Init() thực hiện xong).

• Thời gian chơi phiên hiện tại của người chơi sẽ được load và gửi vào đầu phiên đăng nhập sau của người chơi, tức thời gian chơi trong phiên cuối cùng của vòng đời người chơi sẽ không được ghi nhận.