# Estatísticas da campanha

## getCampaignStats

Recupere estatísticas de uma campanha específica para um período de tempo determinado.

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

##### Parâmetros do corpo da requisição

| Nome | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| `auth` | Sim | string | [Token de acesso da API](/pt/developer/api-reference/api-access-token/) do Painel de Controle Pushwoosh. |
| `campaign` | Sim | string | [Código da campanha](/pt/developer/api-reference/api-identifiers/#campaign-code) único. |
| `datefrom` | Sim | string | Início do período do relatório (formatado como `Y-m-d H:i:s`). |
| `dateto` | Sim | string | Fim do período do relatório (formatado como `Y-m-d H:i:s`). |

##### Exemplo de requisição

```
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",     // obrigatório. Token de acesso da API do Painel de Controle Pushwoosh
    "campaign": "XXXXX-XXXXX",          // obrigatório. Código da campanha
    "datefrom": "2024-05-01 00:00:00",  // obrigatório. Início do período do relatório
    "dateto": "2024-05-10 23:59:59"     // obrigatório. Fim do período do relatório
  }
}
```

##### Exemplo de resposta

```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "request_id": "a3ef436445abfdef6255cc2f65ce7614"
  }
}
```

#### Recuperando resultados de requisições agendadas

<Aside type="caution" title="Importante">
Como toda requisição agendada, `/getCampaignStats` requer uma requisição adicional [`/getResults`](/pt/developer/api-reference/scheduled-requests#getresults).
</Aside>

<details>
  <summary>Exemplo de resposta getResults</summary>
```
{
  "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
    }],

    // conversão (se o rastreamento de metas for permitido)
    "conversion": {
      "send": 10,
      "open": 5,
      "events": [{
        "uid": 1,
        "event": "event name",
        "hits": 5,
        "conversion": "100%",
        "revenue": 15.34
      }]
    }
  }
}
```
</details>