> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/api/es/api-publica-de-exoclick/api-manual-global-stats.md).

# API de estadísticas globales

Esta sección describe los parámetros de solicitud y los datos de resultado de la API de estadísticas globales.

{% hint style="info" %}
Las rutas de la API de estadísticas han sido renombradas:

* `/statistics/advertiser/...` -> `/statistics/a/...`
* `/statistics/publisher/...` -> `/statistics/p/...`
  {% endhint %}

{% hint style="info" %}
La API de Estadísticas Globales solo muestra las consultas RTB omitidas para Date, Sites, Zones, Countries, Regions y Sub IDs.
{% endhint %}

| Parámetro    | Descripción                                                                                    | Notas  | Tipo        |
| ------------ | ---------------------------------------------------------------------------------------------- | ------ | ----------- |
| count        | Devuelve solo el total de resultados.                                                          | entero | opcional    |
| detallado    | Obtén más detalle si es posible.                                                               | entero | opcional    |
| zona horaria | Configuración de zona horaria para el filtro 'hour' y 'group\_by'                              | cadena | opcional    |
| totals       | Indica si se deben añadir totales a la respuesta o no.                                         | entero | opcional    |
| filter       | Filtros para restringir los valores devueltos de una consulta de estadísticas                  | objeto | opcional    |
| group\_by    | Una lista de valores group\_by que se aplicarán en los datos. Se permiten como máximo cuatro.  | matriz | obligatorio |
| order\_by    | Ordenación de los resultados por uno o varios campos específicos. Se permiten como máximo dos. | matriz | opcional    |
| projection   | Subestructuras individuales que un usuario quiere que se devuelvan en la respuesta.            | matriz | opcional    |
| limit        | El número de registros a devolver en esta respuesta.                                           | entero | opcional    |
| offset       | La posición desde la que recuperar los registros.                                              | entero | opcional    |

## Parámetro count

|                      |                                       |
| -------------------- | ------------------------------------- |
| Propiedad            | count                                 |
| Tipo                 | opcional                              |
| Tipo de variable     | entero                                |
| Valor predeterminado | 0                                     |
| Valores disponibles  | \[0, 1]                               |
| Descripción          | Devuelve solo el total de resultados. |

#### Ejemplo:

```json
{
    "count": 1
}
```

## Parámetro detailed

|                      |                                                   |
| -------------------- | ------------------------------------------------- |
| Propiedad            | detallado                                         |
| Tipo                 | opcional                                          |
| Tipo de variable     | entero                                            |
| Valor predeterminado | 0                                                 |
| Valores disponibles  | \[0, 1]                                           |
| Descripción          | Indica si se devuelve información detallada o no. |

#### Ejemplo:

```json
{
    "detailed": 1
}
```

## Parámetro timezone

Configuración de zona horaria para `hour` filter y `group_by`.

|                      |                                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Propiedad            | zona horaria                                                                                                                          |
| Tipo                 | opcional                                                                                                                              |
| Tipo de variable     | cadena                                                                                                                                |
| Valor predeterminado | America/New\_york                                                                                                                     |
| Valores disponibles  | Establece el campo de zona horaria de / collections / timezones                                                                       |
| Descripción          | NOTA: Las zonas horarias solo son relevantes cuando consultamos datos basados en horas; para datos no horarios, esto no tiene efecto. |

#### Ejemplo:

```json
{
    "timezone": "Europe/Dublin"
}
```

## Parámetro totals

|                      |                                                        |
| -------------------- | ------------------------------------------------------ |
| Propiedad            | totals                                                 |
| Tipo                 | opcional                                               |
| Tipo de variable     | entero                                                 |
| Valor predeterminado | 0                                                      |
| Valores disponibles  | \[0,1]                                                 |
| Descripción          | Indica si se deben añadir totales a la respuesta o no. |

#### Ejemplo:

```json
{
    "totals": 1
}
```

## Parámetro filter

|                                    |                                                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Propiedad                          | filter                                                                                                                                                                                                                                                                                                                                                                                                         |
| Tipo                               | opcional                                                                                                                                                                                                                                                                                                                                                                                                       |
| Tipo de variable                   | objeto                                                                                                                                                                                                                                                                                                                                                                                                         |
| Opción disponible para anunciantes | \[”adblock”, ”advertiser\_ad\_type\_id”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date\_from”, “date\_to”, “device\_id”, “device\_type\_id”, hour”, “language\_id”, “operating\_system\_id”, “region\_id”, “site\_hostname”, “site\_id”, “size”, “sub”, “zone\_id”, “campaign\_group\_id”, “campaign\_id”, “exclude\_deleted”, “offer\_id”, “offer\_landing\_page\_id”, “variation\_id”] |
| Opción disponible para editores    | \[”adblock”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date\_from”, “date\_to”, “device\_id”, “device\_type\_id”, “hour”, “language\_id”, “operating\_system\_id”, “region\_id”, “site\_hostname”, “site\_id”, “zone\_id”, “publisher\_ad\_type\_id”, “size”, “sub”]                                                                                                                      |
| Descripción                        | Filtra por ciertos parámetros.                                                                                                                                                                                                                                                                                                                                                                                 |

### Filtro: `country_iso`

|                      |                                                                |
| -------------------- | -------------------------------------------------------------- |
| Propiedad            | country\_iso                                                   |
| Tipo                 | opcional                                                       |
| Tipo de variable     | cadena                                                         |
| Valor predeterminado | -                                                              |
| Valores disponibles  | Consulta la propiedad iso3 del endpoint /collections/countries |
| Descripción          | Lista de códigos ISO 3                                         |

#### Ejemplo:

```json
{
    "filter": {
        "country_iso": ["ESP", "IRL"]
    }
}
```

### Filtro `date_from`, `date_to`

El `date_from` y `date_to` Los parámetros controlan el intervalo temporal del que quieres obtener información de estadísticas.

* date\_from: Fecha inicial del rango para estadísticas, (predeterminado: inicio del mes),
* date\_to: Fecha final del rango para estadísticas, (predeterminado: hoy)

|                      |                                                                   |
| -------------------- | ----------------------------------------------------------------- |
| Propiedad            | date\_from, date\_to                                              |
| Tipo                 | opcional                                                          |
| Tipo de variable     | cadena                                                            |
| Valor predeterminado | Las fechas usan por defecto el mes actual.                        |
| Valores disponibles  | YYYY-mm-dd                                                        |
| Descripción          | Rango de fechas desde/hasta para estadísticas. Formato YYYY-mm-dd |

#### Ejemplo:

```json
{
    "filter": {
        "date_from": "2019-02-25",
        "date_to": "2019-02-28"
    }
}
```

Las zonas horarias solo son relevantes cuando consultamos datos basados en horas; para datos no horarios, esto no tiene efecto.

### Filtro: advertiser\_ad\_type\_id, campaign\_group\_id, campaign\_id, browser\_id, carrier\_id, category\_id, device\_id, device\_type\_id, language\_id, offer\_id, offer\_landing\_page\_id, operating\_system\_id, hour, region\_id, site\_id, sub, variation\_id, zone\_id, publisher\_ad\_type\_id

|                      |                                                                                                                                                                                                                                                                                                                          |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Propiedad            | advertiser\_ad\_type\_id, campaign\_group\_id, campaign\_id, browser\_id, carrier\_id, category\_id, device\_id, device\_type\_id, language\_id, offer\_id, offer\_landing\_page\_id, operating\_system\_id, hour, region\_id, site\_id, sub, variation\_id, zone\_id, advertiser\_ad\_type\_id, publisher\_ad\_type\_id |
| Tipo                 | opcional                                                                                                                                                                                                                                                                                                                 |
| Tipo de variable     | matriz                                                                                                                                                                                                                                                                                                                   |
| Tipo de elementos    | entero                                                                                                                                                                                                                                                                                                                   |
| Valor predeterminado | -                                                                                                                                                                                                                                                                                                                        |
| Valores disponibles  | Propiedades relativas O colecciones                                                                                                                                                                                                                                                                                      |
| Descripción          | Lista de IDs de entidad                                                                                                                                                                                                                                                                                                  |

#### Ejemplo:

```json
{
    "filter": {
        "campaign_id": [123, 456],
        "browser_id": [789]
    }
}
```

### Filtro: `exclude_deleted`

|                      |                                                          |
| -------------------- | -------------------------------------------------------- |
| Propiedad            | exclude\_deleted                                         |
| Tipo                 | opcional                                                 |
| Tipo de variable     | entero                                                   |
| Valor predeterminado | 0                                                        |
| Valores disponibles  | \[0, 1]                                                  |
| Descripción          | Indica si se deben excluir o no las campañas eliminadas. |

#### Ejemplo:

```json
{
    "filter": {
        "exclude_deleted": 1
    }
}
```

### Filtro: `adblock`

|                      |                                                    |
| -------------------- | -------------------------------------------------- |
| Propiedad            | adblock                                            |
| Tipo                 | opcional                                           |
| Tipo de variable     | cadena                                             |
| Valor predeterminado | "all"                                              |
| Valores disponibles  | "adblock", "all", "standard"                       |
| Descripción          | Indica si se deben incluir o no las zonas adblock. |

#### Ejemplo:

```json
{
    "filter": {
        "adblock": "standard"
    }
}
```

### Filtro: `site_hostname`

|                      |                                                                                                                             |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| Propiedad            | site\_hostname                                                                                                              |
| Tipo                 | opcional                                                                                                                    |
| Tipo de variable     | cadena                                                                                                                      |
| Valor predeterminado | -                                                                                                                           |
| Valores disponibles  | Los caracteres válidos para los nombres de host son las letras de la a a la z, los dígitos del 0 al 9, el guion y el punto. |
| Descripción          | Filtra por el nombre de host del sitio.                                                                                     |

#### Ejemplo:

```json
{
    "filter": {
        "site_hostname": ["www.example.com", "www.example-site.org"]
    }
}
```

### Filtro: `size`

|                      |                                                                                              |
| -------------------- | -------------------------------------------------------------------------------------------- |
| Propiedad            | size                                                                                         |
| Tipo                 | opcional                                                                                     |
| Tipo de variable     | cadena                                                                                       |
| Valor predeterminado | -                                                                                            |
| Valores disponibles  | Los caracteres válidos para size son los dígitos del 0 al 9 y el carácter x. Ejemplo 300x100 |
| Descripción          | Filtra por tamaño                                                                            |

#### Ejemplo:

```json
{
    "filter": {
        "size": ["300x100"]
    }
}
```

## Parámetro group\_by

|                                      |                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Propiedad                            | group\_by                                                                                                                                                                                                                                                                                                                                                                                                  |
| Tipo                                 | obligatorio                                                                                                                                                                                                                                                                                                                                                                                                |
| Tipo de variable                     | matriz                                                                                                                                                                                                                                                                                                                                                                                                     |
| Tipo de elementos                    | cadena                                                                                                                                                                                                                                                                                                                                                                                                     |
| Valor predeterminado                 | -                                                                                                                                                                                                                                                                                                                                                                                                          |
| Valores disponibles para anunciantes | \[”adblock”, “advertiser\_ad\_type\_id”, browser\_id”, “idcampaign\_group“, “campaign\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date”, “hour”, “device\_id”, “device\_type\_id”, “language\_id”, “operating\_system\_id”, “region\_id”, “site\_id”, “sub”, “zone\_id”, “week”, “month”, “quarter”, “year”, “offer\_id”, “offer\_landing\_page\_id”, “site\_hostname”, “size”, “variation\_id”] |
| Valores disponibles para editores    | \[“adblock”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date”, “device\_id”, “device\_type\_id” , “hour”, “language\_id”, “month”, “operating\_system\_id”, “quarter”, “region\_id”, “site\_id”, “sub”, “week”, “year”, “zone\_id”]                                                                                                                                                    |
| Descripción                          | Una lista de subsolicitudes para incluir datos adicionales en la respuesta.                                                                                                                                                                                                                                                                                                                                |

#### Ejemplo:

```json
{
  "group_by": [
    "browser",
    "date"
  ]
}
```

## Parámetro order\_by

| Propiedad                                                                  | order\_by                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo                                                                       | opcional                                                                                                                                                                                                                                                                                                                                                         |
| Tipo de variable                                                           | matriz                                                                                                                                                                                                                                                                                                                                                           |
| Tipo de elementos                                                          | cadena                                                                                                                                                                                                                                                                                                                                                           |
| Valor predeterminado                                                       | -                                                                                                                                                                                                                                                                                                                                                                |
| Valores de campo de métricas disponibles                                   | \[“cpc”, “cpc”, “cpm”, “cpv”, “ctr”, “clicks”, “impressions”, “video\_impressions”, “video\_views”, “vtr”, “rtb\_win\_ratio”, “rtb\_avg\_total\_time”, “rtb\_skipped”, “rtb\_bid\_response\_ratio”, “rtb\_avg\_cpm”, “rtb\_timeouts\_ratio”, “rt\_errors\_ratio”, “rtb\_no\_bid\_ratio”, “rtb\_skipped\_ratio”]                                                  |
| Valores de campo disponibles que dependen de \`group\_by’ para anunciantes | \[”adblock”, “browser\_id”, “campaign\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “device\_id”, “date”, “device\_type\_id”, “hour”, “ecpa1”, “g1”,“language\_id”, “month”, “offer\_id”, “offer\_landing\_page\_id”, “operating\_system\_id”, “quarter”, “region\_id”, “site\_hostname”, “site\_id”, “sub”, “variation\_id”, “week”, “year” ,“zone\_id”] |
| Valores de campo disponibles que dependen de \`group\_by’ para editores    | \[“adblock”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “device\_id”, “date”, “device\_type\_id” , “hour”, “language\_id”, “month”, “operating\_system\_id”, “quarter”, “region\_id”, “site\_id”, “sub”, “week”, “year”, “zone\_id”]                                                                                                          |
| Valores de orden disponibles                                               | \[“asc”, “desc”]                                                                                                                                                                                                                                                                                                                                                 |
| Descripción                                                                | Una lista de opciones disponibles para order\_by                                                                                                                                                                                                                                                                                                                 |

{% hint style="info" %}
**Sugerencias**:

* Los campos de métricas están siempre disponibles para usarse como campo de order\_by.
* Para ordenar por un valor específico (por ejemplo, por “browser\_id”), debes incluirlo en el parámetro “group\_by”.
  {% endhint %}

Los valores “g1” y “ecpa1” solo están disponibles cuando el usuario tiene Seguimiento de conversiones (Goals). Todos los objetivos asociados a un número de serie (g1, g2, …gx). Los valores eCPA son, en consecuencia, ecpa1, ecpa2, …ecpax.

#### Ejemplo:

```json
{
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ]
}
```

Para organizar cronológicamente los resultados de la campaña, la “date” debe incluirse tanto en “group\_by” como en “order\_by”:

```json
{
  "group_by": [
    "campaign_id",
    "date"
  ],
  "order_by": [
    {
      "field": "date",
      "order": "asc"
    }
  ]
}
```

## Parámetro projection

El parámetro projection refleja lo que se devolverá en el payload resultante. Si no se especifica, se devolverán todas las subestructuras.

| Propiedad                                     | projection                           |
| --------------------------------------------- | ------------------------------------ |
| Tipo                                          | opcional                             |
| Tipo de variable                              | objeto                               |
| Tipo de elementos                             | matriz                               |
| Valor predeterminado                          | todas las opciones, ver abajo        |
| Valores de campo disponibles para anunciantes | \[“base”, “rtb”, “video”, “goals\*”] |
| Valores de campo disponibles para editores    | \[“base”, “rtb”, “video”, “wpn”]     |

\*Algunos campos "goal", como "profit" y "roi", se calculan en función del coste de la campaña, por lo que también debes usar el campo "base" si quieres recibir las métricas "goals" correctas.

#### Ejemplos:

Para recibir todas las métricas posibles como anunciante, usa:

```json
{
    "projection": {
      "base": ["*"],
      "video": ["*"],
      "goals": ["*"],
      "rtb": ["*"]
    }
}
```

Para recibir todas las métricas posibles como editor, usa:

```json
{
    "projection": {
      "base": ["*"],
      "video": ["*"],
      "wpn": ["*"],
      "rtb": ["*"]
    }
}
```

También puedes especificar las métricas dentro de cada campo de projection:

```json
{
    "projection": {
      "base": ["impressions","clicks","cost","revenue","cpc","cpm","ctr"],
      "video": ["impressions","views","cpv","vtr"],
      "rtb": ["total_time","queries","value","success","no_bid","skipped","errors","timeouts","wins","win_ratio"],
      //solo para editores
      "wpn": ["subscriptions","unsubscriptions","sent"]
    }
}
```

El único campo que no permite una proyección específica de métricas es "goals"

## Parámetro limit

El número de registros a devolver en esta respuesta.

|                      |          |
| -------------------- | -------- |
| Propiedad            | limit    |
| Tipo                 | opcional |
| Tipo de variable     | entero   |
| Valor predeterminado | 50       |

#### Ejemplo:

```json
{
    "limit": 25
}
```

## Parámetro offset

La posición desde la que recuperar los registros.

|                      |          |
| -------------------- | -------- |
| Propiedad            | offset   |
| Tipo                 | opcional |
| Tipo de variable     | entero   |
| Valor predeterminado | 0        |

#### Ejemplo

```json
{
    "offset": 150
}
```

## Ejemplo 1

Estadística de campaña de anunciante con filtrado.

#### Solicitud:

```json
{
    "detailed": true,
    "totals": 1,
    "filter": {
      "date_from": "2019-03-10",
      "date_to": "2019-03-11",
      "country_iso": ["USA"]
    },
    "group_by": ["campaign_id"],
    "order_by": [
      {
        "field": "campaign_id",
        "order": "desc"
      }
    ]
    "projection": {
        "base": ["*"],
        "video": ["*"],
        "rtb": ["*"]
      },
    "limit": 2,
    "offset": 0
  }
```

#### Respuesta:

```json
{
  "request_metadata": {
    "count": 4,
    "limit": 2,
    "offset": 0
  },
  "result": [
    {
      "clicks": 0,
      "cost": 1.3302,
      "cpc": 0,
      "cpm": 0.45586017820425,
      "ctr": 0,
      "group_by": {
        "campaign_id": {
          "active": "1",
          "campaign_ad_type_name": "Popunders",
          "id": "1234567",
          "name": "Ron Mainstream Campaign "
        }
      },
      "impressions": 2918,
      "rtb": {
        "avg_cpm": 0.15582967823432,
        "avg_total_time": 89.522714492492,
        "errors": 112,
        "errors_ratio": 0.011368411650186,
        "no_bid": 870594,
        "no_bid_ratio": 88.368490823053,
        "queries": 985186,
        "response_ratio": 11.57101298638,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 984590,
        "timeouts": 484,
        "timeouts_ratio": 0.049127778916875,
        "total_time": 88196525,
        "value": 1776.396,
        "win_ratio": 0.29842080581738,
        "wins": 2940
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    },
    {
      "clicks": 0,
      "cost": 18.1621655,
      "cpc": 0,
      "cpm": 1.8273634671496,
      "ctr": 0,
      "group_by": {
        "campaign_id": {
          "active": "1",
          "campaign_ad_type_name": "Popunders",
          "id": "7654321",
          "name": "Ron Mainstream Campaign Test"
        }
      },
      "impressions": 9939,
      "rtb": {
        "avg_cpm": 1.4753505300475,
        "avg_total_time": 88.777190144965,
        "errors": 46,
        "errors_ratio": 0.0014192869995779,
        "no_bid": 3209674,
        "no_bid_ratio": 99.031490893114,
        "queries": 3241064,
        "response_ratio": 0.8964340105595,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 3238728,
        "timeouts": 2290,
        "timeouts_ratio": 0.070655809326814,
        "total_time": 287732555,
        "value": 4286.48343,
        "win_ratio": 0.30665855410445,
        "wins": 9939
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    }
  ],
  "result_total": {
    "clicks": 0,
    "cost": 74.0473595,
    "cpc": 0,
    "cpm": 2.0864288391096,
    "ctr": 0,
    "impressions": 35490,
    "rtb": {
      "avg_cpm": 0.23441613972984,
      "avg_total_time": 87.995789332859,
      "errors": 539,
      "errors_ratio": 0.0049868154705264,
      "no_bid": 9771471,
      "no_bid_ratio": 90.405422546568,
      "queries": 10808501,
      "response_ratio": 9.5135301370653,
      "skipped": 0,
      "skipped_ratio": 0,
      "success": 10799741,
      "timeouts": 8221,
      "timeouts_ratio": 0.07606050089647,
      "total_time": 951102577,
      "win_ratio": 0.32861171035651,
      "wins": 35518
    },
    "video": {
      "cpv": 0,
      "impressions": 0,
      "views": 0,
      "vtr": 0
    }
  }
}
```

## Ejemplo 2

Estadística de anunciante por fecha para el mes actual, ordenada por impresiones.

#### Solicitud:

```json
{
  "group_by": ["date"],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ]
  "projection": {
      "base": ["*"],
      "video": ["*"],
      "rtb": ["*"]
    }
}
```

#### Respuesta:

```json
{
  "request_metadata": {
    "count": 3,
    "limit": 50,
    "offset": 0
  },
  "result": [
    {
      "clicks": 0,
      "cost": 624.2439917,
      "cpc": 0,
      "cpm": 1.0978015474007,
      "ctr": 0,
      "group_by": {
        "date": {
          "date": "2019-03-02"
        }
      },
      "impressions": 568631,
      "rtb": {
        "avg_cpm": 0.31273156270632,
        "avg_total_time": 114.34705591799,
        "errors": 4143,
        "errors_ratio": 0.0076578188576312,
        "no_bid": 48085697,
        "no_bid_ratio": 88.8804144989,
        "queries": 54101567,
        "response_ratio": 10.971772776933,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 54021598,
        "timeouts": 75826,
        "timeouts_ratio": 0.14015490530986,
        "total_time": 6186354907,
        "value": 185634.35958,
        "win_ratio": 1.1633248996281,
        "wins": 629377
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    },
    {
      "clicks": 0,
      "cost": 622.1688691,
      "cpc": 0,
      "cpm": 1.1800128762878,
      "ctr": 0,
      "group_by": {
        "date": {
          "date": "2019-03-01"
        }
      },
      "impressions": 527256,
      "rtb": {
        "avg_cpm": 0.27775587567531,
        "avg_total_time": 118.91585420372,
        "errors": 2954,
        "errors_ratio": 0.0078196779097434,
        "no_bid": 32641750,
        "no_bid_ratio": 86.407573260111,
        "queries": 37776492,
        "response_ratio": 13.412992397494,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 37708708,
        "timeouts": 64830,
        "timeouts_ratio": 0.17161466448499,
        "total_time": 4492223815,
        "value": 140737.73563,
        "win_ratio": 1.4077723257099,
        "wins": 531807
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    },
    {
      "clicks": 0,
      "cost": 441.843491,
      "cpc": 0,
      "cpm": 0.96186339096399,
      "ctr": 0,
      "group_by": {
        "date": {
          "date": "2019-03-03"
        }
      },
      "impressions": 459362,
      "rtb": {
        "avg_cpm": 0.26462497173837,
        "avg_total_time": 116.9210100884,
        "errors": 2183,
        "errors_ratio": 0.0059889808787451,
        "no_bid": 32174177,
        "no_bid_ratio": 88.268681100486,
        "queries": 36450275,
        "response_ratio": 11.500815837466,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 36366256,
        "timeouts": 81836,
        "timeouts_ratio": 0.22451408116948,
        "total_time": 4261802971,
        "value": 110932.87869,
        "win_ratio": 1.2852029237091,
        "wins": 468460
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    }
  ]
}
```

## Ejemplo 3

Estadística del publicador por fecha y region\_id, ordenada por impresiones.

#### Solicitud:

```json
{
  "detailed": true,
  "filter": {
    "date_from": "2019-03-10",
    "date_to": "2019-03-11",
    "country_iso": ["USA"]
  },
  "group_by": ["date", "region_id"],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ],
  "projection": {
    "base": ["*"],
    "video": ["*"],
    "wpn": ["*"],
    "rtb": ["*"]
  }
  "limit": 30,
  "offset": 0
}
```

#### Respuesta:

```json
{
  "request_metadata": {
    "count": 2,
    "limit": 30,
    "offset": 0
  },
  "result": [
    {
      "clicks": 3087,
      "cpc": 0.033842716164561,
      "cpm": 0.069188574849649,
      "ctr": 0.20444155402072,
      "group_by": {
        "date": {
          "date": "2019-03-11"
        },
        "region_id": {
          "country_iso": "USA",
          "country_long_name": "Estados Unidos de América",
          "country_short_name": "Estados Unidos",
          "id": 5332921,
          "name": "California"
        }
      },
      "impressions": 1494954,
      "revenue": 104.4724648,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.038451404048583,
        "impressions": 15013,
        "views": 2717,
        "vtr": 18.097648704456
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    },
    {
      "clicks": 3071,
      "cpc": 0.03151133555845,
      "cpm": 0.066658890819906,
      "ctr": 0.21153940205505,
      "group_by": {
        "date": {
          "date": "2019-03-10"
        },
        "region_id": {
          "country_iso": "USA",
          "country_long_name": "Estados Unidos de América",
          "country_short_name": "Estados Unidos",
          "id": 5332921,
          "name": "California"
        }
      },
      "impressions": 1436818,
      "revenue": 96.7713115,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.036216808196108,
        "impressions": 14921,
        "views": 2672,
        "vtr": 17.907646940554
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    }
  ]
}
```

## Ejemplo 4

Estadística del publicador por site\_id con proyección.

#### Solicitud:

```json
{
  "detailed": true,
  "projection": {
    "base": ["*"],
    "video": ["*"],
    "wpn": ["*"],
    "rtb": ["*"]
  },
  "filter": {
    "date_from": "2019-03-10",
    "date_to": "2019-03-11",
    "country_iso": ["USA"]
  },
  "group_by": ["site_id"],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ],
  "limit": 30,
  "offset": 0
}
```

#### Respuesta

```json
{
  "request_metadata": {
    "count": 2,
    "limit": 30,
    "offset": 0
  },
  "result": [
    {
      "clicks": 14320,
      "cpc": 0.028298959692737,
      "cpm": 0.057945765404939,
      "ctr": 0.20476288186597,
      "group_by": {
        "site_id": {
          "id": "11223344",
          "name": "nice-example.com"
        }
      },
      "impressions": 6916414,
      "revenue": 405.2411028,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.031519102652252,
        "impressions": 77041,
        "views": 12857,
        "vtr": 16.688516504199
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    },
    {
      "clicks": 14148,
      "cpc": 0.028769196296296,
      "cpm": 0.063791981699323,
      "ctr": 0.22173710048179,
      "impressions": 6314909,
      "revenue": 407.0265892,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.036406671663685,
        "impressions": 65620,
        "views": 11180,
        "vtr": 17.037488570558
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    }
  ]
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/api/es/api-publica-de-exoclick/api-manual-global-stats.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.