# 이벤트 및 태그 통계

## getEventStatistics

지정된 기간 동안 이벤트가 트리거된 횟수를 검색합니다.

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

##### 요청 본문 파라미터

| 이름 <div style="width:150px"></div> | 필수 여부 | 유형 | 설명 |
|---|---|---|---|
| `auth` | 예 | string | Pushwoosh 컨트롤 패널의 [API 액세스 토큰](/ko/developer/api-reference/api-access-token/). |
| `application` | 예 | string | [Pushwoosh 애플리케이션 코드](/ko/developer/api-reference/api-identifiers/#application-code) |
| `event` | 예 | string | [이벤트 이름](/ko/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`](/ko/developer/api-reference/scheduled-requests#getresults) 요청이 필요합니다.
</Aside>

##### 요청 본문 파라미터

| 필드 | 유형 | 설명 |
|---|---|---|
| `request_id` | string | 스케줄된 요청 ID입니다. 결과를 검색하려면 [`/getResults`](/ko/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 액세스 토큰](/ko/developer/api-reference/api-access-token/). |
| `tag` | 예 | string | [태그 이름](/ko/developer/api-reference/api-identifiers/#tag), Pushwoosh 컨트롤 패널에 있는 것과 정확히 일치해야 합니다. |
| `applications` | 아니요 | array | [애플리케이션](/ko/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`](/ko/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
```