# Campaign 统计数据

## getCampaignStats

检索特定 Campaign 在指定时间段内的统计数据。

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

##### 请求体参数
| 名称 <div style="width:150px"></div> | 是否必须 | 类型 | 描述 |
|---|---|---|---|
| `auth` | 是 | string | 来自 Pushwoosh 控制面板的 [API Access Token](/zh/developer/api-reference/api-access-token/)。 |
| `campaign` | 是 | string | 唯一的 [Campaign Code](/zh/developer/api-reference/api-identifiers/#campaign-code)。 |
| `datefrom` | 是 | string | 报告周期的开始时间（格式为 `Y-m-d H:i:s`）。 |
| `dateto` | 是 | string | 报告周期的结束时间（格式为 `Y-m-d H:i:s`）。 |

##### 请求示例

```javascript
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",     // 必填。来自 Pushwoosh 控制面板的 API Access Token
    "campaign": "XXXXX-XXXXX",          // 必填。Campaign Code
    "datefrom": "2024-05-01 00:00:00",  // 必填。报告周期开始时间
    "dateto": "2024-05-10 23:59:59"     // 必填。报告周期结束时间
  }
}
```
##### 响应示例
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "request_id": "a3ef436445abfdef6255cc2f65ce7614"
  }
}
```


#### 检索计划请求结果

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


<details>
  <summary>getResults 响应示例</summary>
```javascript
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "formatter": "hourly",
    "rows": [{
      "count": 0,
      "action": "open",
      "datetime": "2024-05-09 00:00:00",
      "platformid": 14
    }, {
      "count": 0,
      "action": "send",
      "datetime": "2024-05-09 00:00:00",
      "platformid": 14
    }, {
      "count": 0,
      "action": "send",
      "datetime": "2024-05-11 00:00:00",
      "platformid": 14
    }],

    // 转化（如果允许目标跟踪）
    "conversion": {
      "send": 10,
      "open": 5,
      "events": [{
        "uid": 1,
        "event": "event name",
        "hits": 5,
        "conversion": "100%",
        "revenue": 15.34
      }]
    }
  }
}
```
</details>