---
sourceType: api-reference
sourceTypeMatchedRule: openApis
slug: MA/openApis/open/apis/stats
title: Thống kê
---
Được sử dụng để thu thập thông tin thống kê của Mini App trong một khoảng thời gian cụ thể.

### Parameters

| Field       | Type   | Example             | Required | Description                                                         |
| ----------- | ------ | ------------------- | -------- | ------------------------------------------------------------------- |
| miniAppId   | long   | 3595174957789840753 | true     | ID của Mini App tương ứng                                           |
| type        | string | access-traffic      | true     | Loại dữ liệu thống kê cần lấy, tham khảo danh sách StatsType ở dưới |
| startTime   | long   | 1692032400000       | true     | Thời gian bắt đầu lấy dữ liệu                                       |
| endTime     | long   | 1692032400000       | true     | Thời gian kết thúc lấy dữ liệu                                      |
| utmSource   | string | all                 |          | Chỉ cần truyền với param type nhất định                             |
| utmCampaign | string | all                 |          | Chỉ cần truyền với param type nhất định                             |
| os          | string | all                 |          | Chỉ cần truyền với param type nhất định                             |

:::info Lưu ý

- Khoảng thời gian lấy dữ liệu trong vòng 90 ngày.
- startTime, endTime đơn vị milliseconds.
- startTime phải đúng vào lúc 0h(UTC+7) của ngày cần lấy.
- endTime có thể là giá trị bất kỳ trong ngày, hệ thống sẽ tự động làm tròn đến cuối ngày.
  :::

### Return Value

| Attribute | Type   | Description                 |
| --------- | ------ | --------------------------- |
| err       | number | Thành công / thất bại       |
| msg       | string | Thành công / thất bại       |
| data      | object | Dữ liệu thành công (nếu có) |

### Sample Code

### Code sample — Java

```js
import com.vng.zalo.miniapp.openapi.sdk.models.StatsRequest;
import com.vng.zalo.miniapp.openapi.sdk.models.StatsResponse;

StatsRequest request = new StatsRequest();
request.setMiniAppId({Your Mini App's Id});
request.setType("access-traffic");
request.setStartTime(1701363600000L);
request.setEndTime(1702486800000L);
request.setUtmSource("zalo-search");
request.setUtmMedium("zalo-search");
request.setUtmCampaign("zalo-search"); // optional
request.setOs("Android"); // optional
StatsResponse response = client.getStats(request);
```

### Code sample — Node.js

```js
const statsRequest: StatsRequest = {
  miniAppId: {Your Mini App's Id},
  type: "access-traffic",
  startTime: 1700240400000,
  endTime: 1702832399999,
  utmSource: "zalo-search", // optional
};
const { error, message, data } = await client.getStats(statsRequest);
```

## Error Code

Tham khảo [tại đây](/docs/MA/openApis/errorCode)

## StatsType

### overview

Định nghĩa: Thống kê tổng quan của mini app.
### utm-sources

Định nghĩa: Danh sách các utm sources của mini app.

### access-traffic

Định nghĩa: Thống kê nguồn truy cập của mini app.

Biểu đồ tương ứng:

![stats-access](/assets/MA/img/open-apis/stats/stats-access.jpg)

### traffic-by-sources

Định nghĩa: Thống kê nguồn truy cập theo các utm sources.

Biểu đồ tương ứng:

![stats-traffic-by-sources](/assets/MA/img/open-apis/stats/stats-traffic.jpg)

### traffic-by-zalo-sources

Định nghĩa: Thống kê nguồn truy cập theo các Zalo sources.

Biểu đồ tương ứng:

![stats-traffic-by-zalo-sources](/assets/MA/img/open-apis/stats/stats-traffic-by-zalo-sources.png)

### platform

Định nghĩa: Thống kê theo hệ điều hành.

Biểu đồ tương ứng:

![stats-platform](/assets/MA/img/open-apis/stats/stats-platform.jpg)

### age

Định nghĩa: Thống kê theo tuổi.

### gender

Định nghĩa: Thống kê theo giới tính.

Biểu đồ tương ứng:

![stats-age](/assets/MA/img/open-apis/stats/stats-age-gender.jpg)

### avg-used-time

Định nghĩa: Thống kê thời gian sử dụng trung bình.

### used-time

Định nghĩa: Thống kê thời gian sử dụng.

Biểu đồ tương ứng:

![stats-used-time](/assets/MA/img/open-apis/stats/stats-used-time-avg.jpg)