# 事件和标签统计

## getEventStatistics

检索指定期间内触发事件的次数。

`POST` `https://api.pushwoosh.com/json/1.3/getEventStatistics`

##### 请求体参数

| 名称    <div style="width:150px"></div>          | 必填 | 类型   | 描述                                                                          |
|--------------|----------|--------|--------------------------------------------------------------------------------------|
| `auth`       | 是      | string | 来自 Pushwoosh 控制面板的 [API 访问令牌](/zh/developer/api-reference/api-access-token/)。 |
| `application` | 是      | string | [Pushwoosh 应用程序代码](/zh/developer/api-reference/api-identifiers/#application-code)                                                         |
| `event`      | 是      | string | [事件名称](/zh/developer/api-reference/api-identifiers/#event-name)，与 Pushwoosh 控制面板中创建的完全一致。                           |
| `date_from`  | 是      | string | 检索统计信息的起始时间。                                      |
| `date_to`    | 是      | string | 检索统计信息的结束时间。                                        |
| `attributes` | 否       | array  | 用于筛选结果的事件属性数组。                                  |

##### 请求示例

```
{
  "request": {
    "auth":"yxoPUlwqm…………pIyEX4H",  // 必填。来自 Pushwoosh 控制面板的 API 访问令牌
    "application": "XXXXX-XXXXX",   // 必填。Pushwoosh 应用程序代码
    "event": "Event name",          // 必填。与 Pushwoosh 控制面板中创建的完全一致的事件名称
    "date_from": "2024-09-12",      // 必填。报告周期的开始时间
    "date_to": "2024-09-12",        // 必填。报告周期的结束时间
    "attributes": [{                // 可选。
      "name": "attributeName",
      "operator": "EQ",
      "values": ["val"]
    }]
  }
}
```

##### 响应示例
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "request_id": "DC1_bc63f00c736696d75cea17aa6855ba19"
  }
}
```

#### 检索计划请求结果
<Aside type="caution" title="重要">
与每个计划请求一样，**/getEventStatistics** 需要额外的 [`/getResults`](/zh/developer/api-reference/scheduled-requests#getresults) 请求。
</Aside>

##### 请求体参数

| 字段        | 类型   | 描述                                                                                  |
|-------------|--------|----------------------------------------------------------------------------------------------|
| `request_id` | string | 计划请求 ID。使用 [`/getResults`](/zh/developer/api-reference/scheduled-requests#getresults) 检索结果。 |

<details>
  <summary>计划请求 (/getResults) 响应</summary>
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": [{
    "date": "2024-09-12 00:00",
    "count": 12
  }, {
    "date": "2024-09-12 01:00",
    "count": 2
  }, {
    "date": "2024-09-12 02:00",
    "count": 4
  }, {
    "date": "2024-09-12 03:00",
    "count": 8
  }, {
    "date": "2024-09-12 04:00",
    "count": 9
  }, {
    "date": "2024-09-12 05:00",
    "count": 2
  }, {
    "date": "2024-09-12 06:00",
    "count": 0
  }, {
    "date": "2024-09-12 07:00",
    "count": 0
  }, {
    "date": "2024-09-12 08:00",
    "count": 0
  }, {
    "date": "2024-09-12 09:00",
    "count": 0
  }, {
    "date": "2024-09-12 10:00",
    "count": 0
  }, {
    "date": "2024-09-12 11:00",
    "count": 0
  }, {
    "date": "2024-09-12 12:00",
    "count": 0
  }, {
    "date": "2024-09-12 13:00",
    "count": 0
  }, {
    "date": "2024-09-12 14:00",
    "count": 0
  }, {
    "date": "2024-09-12 15:00",
    "count": 0
  }, {
    "date": "2024-09-12 16:00",
    "count": 0
  }, {
    "date": "2024-09-12 17:00",
    "count": 0
  }, {
    "date": "2024-09-12 18:00",
    "count": 0
  }, {
    "date": "2024-09-12 19:00",
    "count": 0
  }, {
    "date": "2024-09-12 20:00",
    "count": 0
  }, {
    "date": "2024-09-12 21:00",
    "count": 0
  }, {
    "date": "2024-09-12 22:00",
    "count": 0
  }, {
    "date": "2024-09-12 23:00",
    "count": 0
  }]
}
```
</details>



## getTagStats

检索特定标签的统计信息。

`POST` `https://api.pushwoosh.com/json/1.3/getTagStats`

##### 请求体参数

| 名称    <div style="width:150px"></div>         | 必填 | 类型   | 描述                                                                                   |
|--------------|----------|--------|-----------------------------------------------------------------------------------------------|
| `auth`       | 是      | string | 来自 Pushwoosh 控制面板的 [API 访问令牌](/zh/developer/api-reference/api-access-token/)。 |
| `tag`        | 是      | string | [标签名称](/zh/developer/api-reference/api-identifiers/#tag)，与 Pushwoosh 控制面板中的完全一致。                                             |
| `applications` | 否      | array  | [应用程序](/zh/developer/api-reference/api-identifiers/#application-code)列表。仅当标签是特定于应用程序时才指定。                       |

##### 请求示例

```json
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",
    "tag": "TAG_NAME",
    "applications": [
      "APPLICATION_1",
      "APPLICATION_2",
      "APPLICATION_3"
    ]
  }
}
```
#### 检索计划请求结果
<Aside type="caution" title="重要">
与每个计划请求一样，**getTagStats** 需要额外的 [`/getResults`](/zh/developer/api-reference/scheduled-requests#getresults) 请求。
</Aside>

##### `/getResults` 响应

```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "fileName": "DIRECT_FILE_URL.csv"
  }
}
```

<Aside type="note">
响应是一个带有分号 (`;`) 分隔符的 CSV 文件。
</Aside>

#### CSV 内容示例

```csv
13C2B-72C62;ua_settingpushbod;3
13C2B-72C62;ua_settingpushhealth;3
13C2B-72C62;ua_settingpushstrength;3
13C2B-72C62;ua_settingpushupdate;2
```