> 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/it/api-pubblica-di-exoclick/api-manual-global-stats.md).

# API delle statistiche globali

Questa sezione descrive i parametri di richiesta e i dati di risultato dell'API delle Statistiche Globali.

{% hint style="info" %}
Le route dell'API delle statistiche sono state rinominate:

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

{% hint style="info" %}
La Global Statistics API mostra solo le query RTB saltate per Date, Sites, Zones, Countries, Regions e Sub ID.
{% endhint %}

| Parametro  | Descrizione                                                                                       | Note    | Tipo         |
| ---------- | ------------------------------------------------------------------------------------------------- | ------- | ------------ |
| count      | Restituisce solo il totale dei risultati.                                                         | intero  | opzionale    |
| detailed   | Ottieni maggiori dettagli, se possibile.                                                          | intero  | opzionale    |
| timezone   | Impostazione del fuso orario per il filtro 'hour' e 'group\_by'                                   | stringa | opzionale    |
| totals     | Indica se aggiungere o meno i totali alla risposta.                                               | intero  | opzionale    |
| filter     | Filtri per limitare i valori restituiti da una query di statistiche                               | oggetto | opzionale    |
| group\_by  | Un elenco di valori group\_by da applicare ai dati. Ne sono consentiti al massimo quattro.        | array   | obbligatorio |
| order\_by  | Ordinamento dei risultati in base a uno o più campi specifici. Ne sono consentiti al massimo due. | array   | opzionale    |
| projection | Sotto-strutture individuali che un utente desidera vengano restituite nella risposta.             | array   | opzionale    |
| limit      | Il numero di record da restituire in questa risposta.                                             | intero  | opzionale    |
| offset     | La posizione da cui recuperare i record.                                                          | intero  | opzionale    |

## Numero di parametri

|                    |                                           |
| ------------------ | ----------------------------------------- |
| Proprietà          | count                                     |
| Tipo               | opzionale                                 |
| Tipo di variabile  | intero                                    |
| Valore predefinito | 0                                         |
| Valori disponibili | \[0, 1]                                   |
| Descrizione        | Restituisce solo il totale dei risultati. |

#### Esempio:

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

## Parametro detailed

|                    |                                                       |
| ------------------ | ----------------------------------------------------- |
| Proprietà          | detailed                                              |
| Tipo               | opzionale                                             |
| Tipo di variabile  | intero                                                |
| Valore predefinito | 0                                                     |
| Valori disponibili | \[0, 1]                                               |
| Descrizione        | Indica se restituire informazioni dettagliate o meno. |

#### Esempio:

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

## Parametro timezone

Impostazione del fuso orario per `hour` filtro e `group_by`.

|                    |                                                                                                                           |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| Proprietà          | timezone                                                                                                                  |
| Tipo               | opzionale                                                                                                                 |
| Tipo di variabile  | stringa                                                                                                                   |
| Valore predefinito | America/New\_york                                                                                                         |
| Valori disponibili | Imposta il campo del fuso orario di / collections / timezones                                                             |
| Descrizione        | NOTA: i fusi orari sono rilevanti solo quando eseguiamo query basate su dati orari; per i dati non orari, non ha effetto. |

#### Esempio:

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

## Parametro totals

|                    |                                                     |
| ------------------ | --------------------------------------------------- |
| Proprietà          | totals                                              |
| Tipo               | opzionale                                           |
| Tipo di variabile  | intero                                              |
| Valore predefinito | 0                                                   |
| Valori disponibili | \[0,1]                                              |
| Descrizione        | Indica se aggiungere o meno i totali alla risposta. |

#### Esempio:

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

## Parametro filter

|                                           |                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Proprietà                                 | filter                                                                                                                                                                                                                                                                                                                                                                                                         |
| Tipo                                      | opzionale                                                                                                                                                                                                                                                                                                                                                                                                      |
| Tipo di variabile                         | oggetto                                                                                                                                                                                                                                                                                                                                                                                                        |
| Opzione disponibile per gli inserzionisti | \[”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”] |
| Opzione disponibile per i publisher       | \[”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”]                                                                                                                      |
| Descrizione                               | Filtra per determinati parametri.                                                                                                                                                                                                                                                                                                                                                                              |

### Filtro: `country_iso`

|                    |                                                             |
| ------------------ | ----------------------------------------------------------- |
| Proprietà          | country\_iso                                                |
| Tipo               | opzionale                                                   |
| Tipo di variabile  | stringa                                                     |
| Valore predefinito | -                                                           |
| Valori disponibili | Vedi la proprietà iso3 dell'endpoint /collections/countries |
| Descrizione        | Elenco dei codici ISO 3                                     |

#### Esempio:

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

### Filtro `date_from`, `date_to`

Il `date_from` e `date_to` i parametri controllano l'intervallo temporale da cui vuoi recuperare le informazioni statistiche.

* date\_from: data di inizio dell'intervallo per le statistiche, (predefinito: inizio del mese),
* date\_to: data di fine dell'intervallo per le statistiche, (predefinito: oggi)

|                    |                                                                       |
| ------------------ | --------------------------------------------------------------------- |
| Proprietà          | date\_from, date\_to                                                  |
| Tipo               | opzionale                                                             |
| Tipo di variabile  | stringa                                                               |
| Valore predefinito | Le date hanno come valore predefinito il mese corrente.               |
| Valori disponibili | YYYY-mm-dd                                                            |
| Descrizione        | Intervallo date di inizio/fine per le statistiche. Formato YYYY-mm-dd |

#### Esempio:

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

I fusi orari sono rilevanti solo quando eseguiamo query basate su dati orari; per i dati non orari, non ha effetto.

### Filter: 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

|                    |                                                                                                                                                                                                                                                                                                                          |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Proprietà          | 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               | opzionale                                                                                                                                                                                                                                                                                                                |
| Tipo di variabile  | array                                                                                                                                                                                                                                                                                                                    |
| Tipo di elementi   | intero                                                                                                                                                                                                                                                                                                                   |
| Valore predefinito | -                                                                                                                                                                                                                                                                                                                        |
| Valori disponibili | Proprietà relative O raccolte                                                                                                                                                                                                                                                                                            |
| Descrizione        | Elenco degli ID delle entità                                                                                                                                                                                                                                                                                             |

#### Esempio:

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

### Filtro: `exclude_deleted`

|                    |                                                   |
| ------------------ | ------------------------------------------------- |
| Proprietà          | exclude\_deleted                                  |
| Tipo               | opzionale                                         |
| Tipo di variabile  | intero                                            |
| Valore predefinito | 0                                                 |
| Valori disponibili | \[0, 1]                                           |
| Descrizione        | Indica se escludere o meno le campagne eliminate. |

#### Esempio:

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

### Filtro: `adblock`

|                    |                                             |
| ------------------ | ------------------------------------------- |
| Proprietà          | adblock                                     |
| Tipo               | opzionale                                   |
| Tipo di variabile  | stringa                                     |
| Valore predefinito | "all"                                       |
| Valori disponibili | "adblock", "all", "standard"                |
| Descrizione        | Indica se includere o meno le zone adblock. |

#### Esempio:

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

### Filtro: `site_hostname`

|                    |                                                                                                          |
| ------------------ | -------------------------------------------------------------------------------------------------------- |
| Proprietà          | site\_hostname                                                                                           |
| Tipo               | opzionale                                                                                                |
| Tipo di variabile  | stringa                                                                                                  |
| Valore predefinito | -                                                                                                        |
| Valori disponibili | I caratteri validi per gli hostname sono le lettere da a a z, le cifre da 0 a 9, il trattino e il punto. |
| Descrizione        | Filtra per hostname del sito.                                                                            |

#### Esempio:

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

### Filtro: `size`

|                    |                                                                                      |
| ------------------ | ------------------------------------------------------------------------------------ |
| Proprietà          | size                                                                                 |
| Tipo               | opzionale                                                                            |
| Tipo di variabile  | stringa                                                                              |
| Valore predefinito | -                                                                                    |
| Valori disponibili | I caratteri validi per size sono le cifre da 0 a 9 e il carattere x. Esempio 300x100 |
| Descrizione        | Filtra per size                                                                      |

#### Esempio:

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

## Parametro group\_by

|                                          |                                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Proprietà                                | group\_by                                                                                                                                                                                                                                                                                                                                                                                                  |
| Tipo                                     | obbligatorio                                                                                                                                                                                                                                                                                                                                                                                               |
| Tipo di variabile                        | array                                                                                                                                                                                                                                                                                                                                                                                                      |
| Tipo di elementi                         | stringa                                                                                                                                                                                                                                                                                                                                                                                                    |
| Valore predefinito                       | -                                                                                                                                                                                                                                                                                                                                                                                                          |
| Valori disponibili per gli inserzionisti | \[”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”] |
| Valori disponibili per i publisher       | \[“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”]                                                                                                                                                    |
| Descrizione                              | Un elenco di sotto-richieste per includere dati aggiuntivi nella risposta.                                                                                                                                                                                                                                                                                                                                 |

#### Esempio:

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

## Parametro order\_by

| Proprietà                                                                     | order\_by                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo                                                                          | opzionale                                                                                                                                                                                                                                                                                                                                                        |
| Tipo di variabile                                                             | array                                                                                                                                                                                                                                                                                                                                                            |
| Tipo di elementi                                                              | stringa                                                                                                                                                                                                                                                                                                                                                          |
| Valore predefinito                                                            | -                                                                                                                                                                                                                                                                                                                                                                |
| Valori disponibili dei campi delle metriche                                   | \[“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”]                                                  |
| Valori di campo disponibili dipendenti da \`group\_by\` per gli inserzionisti | \[”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”] |
| Valori di campo disponibili dipendenti da \`group\_by\` per i publisher       | \[“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”]                                                                                                          |
| Valori di ordinamento disponibili                                             | \[“asc”, “desc”]                                                                                                                                                                                                                                                                                                                                                 |
| Descrizione                                                                   | Un elenco di opzioni order\_by disponibili                                                                                                                                                                                                                                                                                                                       |

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

* I campi delle metriche sono sempre disponibili per essere usati come campo order\_by.
* Per ordinare in base a un valore specifico (ad esempio per “browser\_id”), devi includerlo nel parametro “group\_by”.
  {% endhint %}

I valori “g1”, “ecpa1” sono disponibili solo quando l'utente ha Conversion Tracking (Goals). Tutti gli obiettivi sono associati a un numero di serie (g1, g2, …gx). I valori eCPA sono di conseguenza ecpa1, ecpa2, …ecpax.

#### Esempio:

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

Esempio per organizzare cronologicamente i risultati della campagna: il campo “date” deve essere incluso sia in “group\_by” che in “order\_by”:

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

## Parametro projection

Il parametro projection indica ciò che verrà restituito nel payload risultante. Se non viene specificato, verranno restituite tutte le sotto-strutture.

| Proprietà                                         | projection                           |
| ------------------------------------------------- | ------------------------------------ |
| Tipo                                              | opzionale                            |
| Tipo di variabile                                 | oggetto                              |
| Tipo di elementi                                  | array                                |
| Valore predefinito                                | tutte le opzioni, vedi sotto         |
| Valori di campo disponibili per gli inserzionisti | \[“base”, “rtb”, “video”, “goals\*”] |
| Valori di campo disponibili per i publisher       | \[“base”, “rtb”, “video”, “wpn”]     |

\*Alcuni campi "goal", come "profit" e "roi", sono calcolati in base al costo della campagna, quindi devi usare anche il campo "base" se vuoi ricevere metriche "goals" corrette.

#### Esempi:

Per ricevere tutte le metriche possibili come inserzionista, usa:

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

Per ricevere tutte le metriche possibili come publisher, usa:

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

Puoi anche specificare le metriche all'interno di ciascun campo 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 per i publisher
      "wpn": ["subscriptions","unsubscriptions","sent"]
    }
}
```

L'unico campo che non consente una proiezione specifica delle metriche è "goals"

## Parametro limit

Il numero di record da restituire in questa risposta.

|                    |           |
| ------------------ | --------- |
| Proprietà          | limit     |
| Tipo               | opzionale |
| Tipo di variabile  | intero    |
| Valore predefinito | 50        |

#### Esempio:

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

## Parametro offset

La posizione da cui recuperare i record.

|                    |           |
| ------------------ | --------- |
| Proprietà          | offset    |
| Tipo               | opzionale |
| Tipo di variabile  | intero    |
| Valore predefinito | 0         |

#### Esempio

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

## Esempio 1

Statistica della campagna dell'inserzionista con filtro.

#### Richiesta:

```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
  }
```

#### Risposta:

```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
    }
  }
}
```

## Esempio 2

Statistica dell'inserzionista per data del mese corrente ordinata per impressioni.

#### Richiesta:

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

#### Risposta:

```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
      }
    }
  ]
}
```

## Esempio 3

Statistica del publisher per data e region\_id, ordinata per impressioni.

#### Richiesta:

```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
}
```

#### Risposta:

```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": "Stati Uniti d'America",
          "country_short_name": "Stati Uniti",
          "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": "Stati Uniti d'America",
          "country_short_name": "Stati Uniti",
          "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
      }
    }
  ]
}
```

## Esempio 4

Statistica del publisher per site\_id con proiezione.

#### Richiesta:

```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
}
```

#### Risposta

```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/it/api-pubblica-di-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.