# Estadísticas de eventos y etiquetas

## getEventStatistics

Recupera el número de veces que se activó un evento durante un período específico.

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

##### Parámetros del cuerpo de la solicitud

| Nombre    <div style="width:150px"></div>          | Requerido | Tipo   | Descripción                                                                          |
|--------------|----------|--------|--------------------------------------------------------------------------------------|
| `auth`       | Sí       | string | [Token de acceso a la API](/es/developer/api-reference/api-access-token/) del Panel de Control de Pushwoosh. |
| `application` | Sí       | string | [Código de aplicación de Pushwoosh](/es/developer/api-reference/api-identifiers/#application-code)                                                         |
| `event`      | Sí       | string | [Nombre del evento](/es/developer/api-reference/api-identifiers/#event-name), exactamente como se creó en el Panel de Control de Pushwoosh.                           |
| `date_from`  | Sí       | string | Inicio del período para recuperar estadísticas.                                      |
| `date_to`    | Sí       | string | Fin del período para recuperar estadísticas.                                        |
| `attributes` | No       | array  | Un array de atributos de evento para filtrar resultados.                                  |

##### Ejemplo de solicitud

```
{
  "request": {
    "auth":"yxoPUlwqm…………pIyEX4H",  // requerido. Token de acceso a la API del Panel de Control de Pushwoosh
    "application": "XXXXX-XXXXX",   // requerido. Código de aplicación de Pushwoosh
    "event": "Event name",          // requerido. El nombre del Evento exactamente como se creó en el Panel de Control de Pushwoosh
    "date_from": "2024-09-12",      // requerido. Inicio del período del informe
    "date_to": "2024-09-12",        // requerido. Fin del período del informe
    "attributes": [{                // opcional.
      "name": "attributeName",
      "operator": "EQ",
      "values": ["val"]
    }]
  }
}
```

##### Ejemplo de respuesta
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "request_id": "DC1_bc63f00c736696d75cea17aa6855ba19"
  }
}
```

#### Recuperación de resultados de solicitudes programadas

<Aside type="caution" title="Importante">
Al igual que toda solicitud programada, **/getEventStatistics** requiere una solicitud adicional [`/getResults`](/es/developer/api-reference/scheduled-requests#getresults).
</Aside>

##### Parámetros del cuerpo de la solicitud

| Campo        | Tipo   | Descripción                                                                                  |
|-------------|--------|----------------------------------------------------------------------------------------------|
| `request_id` | string | ID de solicitud programada. Use [`/getResults`](/es/developer/api-reference/scheduled-requests#getresults) para recuperar resultados. |

<details>
  <summary>Respuesta programada (/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

Recupera estadísticas para una etiqueta específica.

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

##### Parámetros del cuerpo de la solicitud

| Nombre    <div style="width:150px"></div>         | Requerido | Tipo   | Descripción                                                                                   |
|--------------|----------|--------|-----------------------------------------------------------------------------------------------|
| `auth`       | Sí       | string | [Token de acceso a la API](/es/developer/api-reference/api-access-token/) del Panel de Control de Pushwoosh. |
| `tag`        | Sí       | string | [Nombre de la etiqueta](/es/developer/api-reference/api-identifiers/#tag), exactamente como en el Panel de Control de Pushwoosh.                                             |
| `applications` | No      | array  | Lista de [aplicaciones](/es/developer/api-reference/api-identifiers/#application-code). Especifique solo si la etiqueta es específica de la aplicación.                       |

##### Ejemplo de solicitud

```json
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",
    "tag": "TAG_NAME",
    "applications": [
      "APPLICATION_1",
      "APPLICATION_2",
      "APPLICATION_3"
    ]
  }
}
```

#### Recuperación de resultados de solicitudes programadas

<Aside type="caution" title="Importante">
Al igual que toda solicitud programada, **getTagStats** requiere una solicitud adicional [`/getResults`](/es/developer/api-reference/scheduled-requests#getresults).
</Aside>

##### Respuesta de `/getResults`

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

<Aside type="note">
El archivo de respuesta es un CSV con un separador de punto y coma (`;`).
</Aside>

#### Ejemplo de contenido CSV

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