> 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/fr/api-publique-exoclick/api-manual-global-stats.md).

# API de statistiques globales

Cette section décrit les paramètres de requête et les données de résultat de l’API Global Statistics.

{% hint style="info" %}
Les routes de l’API des statistiques ont été renommées :

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

{% hint style="info" %}
L’API Global Statistics n’affiche les requêtes RTB ignorées que pour Date, Sites, Zones, Pays, Régions et Sub IDs.
{% endhint %}

| Paramètre  | Description                                                                                    | Remarques | Type        |
| ---------- | ---------------------------------------------------------------------------------------------- | --------- | ----------- |
| count      | Ne retourner que le total des résultats.                                                       | entier    | facultatif  |
| détaillé   | Obtenir plus de détails si possible.                                                           | entier    | facultatif  |
| timezone   | Paramètre de fuseau horaire pour le filtre 'hour' et 'group\_by'                               | chaîne    | facultatif  |
| totals     | Indique s’il faut ajouter les totaux à la réponse ou non.                                      | entier    | facultatif  |
| filter     | Filtres permettant de restreindre les valeurs renvoyées par une requête de statistiques        | objet     | facultatif  |
| group\_by  | Liste des valeurs de group by à appliquer dans les données. Quatre au maximum sont autorisées. | tableau   | obligatoire |
| order\_by  | Ordre des résultats selon un ou plusieurs champs spécifiques. Deux au maximum sont autorisés.  | tableau   | facultatif  |
| projection | Sous-structures individuelles que l’utilisateur souhaite voir renvoyées dans la réponse.       | tableau   | facultatif  |
| limit      | Nombre d’enregistrements à renvoyer dans cette réponse.                                        | entier    | facultatif  |
| offset     | Position à partir de laquelle récupérer les enregistrements.                                   | entier    | facultatif  |

## Nombre de paramètres

|                     |                                          |
| ------------------- | ---------------------------------------- |
| Propriété           | count                                    |
| Type                | facultatif                               |
| Type de variable    | entier                                   |
| Valeur par défaut   | 0                                        |
| Valeurs disponibles | \[0, 1]                                  |
| Description         | Ne retourner que le total des résultats. |

#### Exemple :

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

## Paramètre detailed

|                     |                                                                |
| ------------------- | -------------------------------------------------------------- |
| Propriété           | détaillé                                                       |
| Type                | facultatif                                                     |
| Type de variable    | entier                                                         |
| Valeur par défaut   | 0                                                              |
| Valeurs disponibles | \[0, 1]                                                        |
| Description         | Indique s’il faut renvoyer des informations détaillées ou non. |

#### Exemple :

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

## Paramètre timezone

Paramètre de fuseau horaire pour `hour` le filtre et `group_by`.

|                     |                                                                                                                                                              |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Propriété           | timezone                                                                                                                                                     |
| Type                | facultatif                                                                                                                                                   |
| Type de variable    | chaîne                                                                                                                                                       |
| Valeur par défaut   | America/New\_york                                                                                                                                            |
| Valeurs disponibles | Définir le champ de fuseau horaire de / collections / timezones                                                                                              |
| Description         | REMARQUE : les fuseaux horaires ne sont pertinents que lorsque nous interrogeons des données horaires ; pour les données non horaires, cela n’a aucun effet. |

#### Exemple :

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

## Paramètre totals

|                     |                                                           |
| ------------------- | --------------------------------------------------------- |
| Propriété           | totals                                                    |
| Type                | facultatif                                                |
| Type de variable    | entier                                                    |
| Valeur par défaut   | 0                                                         |
| Valeurs disponibles | \[0,1]                                                    |
| Description         | Indique s’il faut ajouter les totaux à la réponse ou non. |

#### Exemple :

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

## Paramètre filter

|                                       |                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Propriété                             | filter                                                                                                                                                                                                                                                                                                                                                                                                         |
| Type                                  | facultatif                                                                                                                                                                                                                                                                                                                                                                                                     |
| Type de variable                      | objet                                                                                                                                                                                                                                                                                                                                                                                                          |
| Option disponible pour les annonceurs | \[”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”] |
| Option disponible pour les éditeurs   | \[”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”]                                                                                                                      |
| Description                           | Filtrer selon certains paramètres.                                                                                                                                                                                                                                                                                                                                                                             |

### Filtre : `country_iso`

|                     |                                                                       |
| ------------------- | --------------------------------------------------------------------- |
| Propriété           | country\_iso                                                          |
| Type                | facultatif                                                            |
| Type de variable    | chaîne                                                                |
| Valeur par défaut   | -                                                                     |
| Valeurs disponibles | Voir la propriété iso3 du point de terminaison /collections/countries |
| Description         | Liste des codes ISO 3                                                 |

#### Exemple :

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

### Filtre `date_from`, `date_to`

Le `date_from` et `date_to` ces paramètres contrôlent la période sur laquelle vous souhaitez récupérer les informations de statistiques.

* date\_from : date de début de la plage pour les statistiques, (début du mois par défaut),
* date\_to : date de fin de la plage pour les statistiques, (aujourd’hui par défaut)

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| Propriété           | date\_from, date\_to                                               |
| Type                | facultatif                                                         |
| Type de variable    | chaîne                                                             |
| Valeur par défaut   | Les dates utilisent par défaut le mois en cours.                   |
| Valeurs disponibles | YYYY-mm-dd                                                         |
| Description         | Plage date\_from/date\_to pour les statistiques. Format YYYY-mm-dd |

#### Exemple :

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

Les fuseaux horaires ne sont pertinents que lorsque nous interrogeons des données horaires ; pour les données non horaires, cela n’a aucun effet.

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

|                     |                                                                                                                                                                                                                                                                                                                          |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Propriété           | 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 |
| Type                | facultatif                                                                                                                                                                                                                                                                                                               |
| Type de variable    | tableau                                                                                                                                                                                                                                                                                                                  |
| Type d’éléments     | entier                                                                                                                                                                                                                                                                                                                   |
| Valeur par défaut   | -                                                                                                                                                                                                                                                                                                                        |
| Valeurs disponibles | Propriétés relatives OU collections                                                                                                                                                                                                                                                                                      |
| Description         | Liste des identifiants d’entité                                                                                                                                                                                                                                                                                          |

#### Exemple :

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

### Filtre : `exclude_deleted`

|                     |                                                            |
| ------------------- | ---------------------------------------------------------- |
| Propriété           | exclude\_deleted                                           |
| Type                | facultatif                                                 |
| Type de variable    | entier                                                     |
| Valeur par défaut   | 0                                                          |
| Valeurs disponibles | \[0, 1]                                                    |
| Description         | Indique s’il faut exclure les campagnes supprimées ou non. |

#### Exemple :

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

### Filtre : `adblock`

|                     |                                                     |
| ------------------- | --------------------------------------------------- |
| Propriété           | adblock                                             |
| Type                | facultatif                                          |
| Type de variable    | chaîne                                              |
| Valeur par défaut   | "all"                                               |
| Valeurs disponibles | "adblock", "all", "standard"                        |
| Description         | Indique s’il faut inclure ou non les zones adblock. |

#### Exemple :

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

### Filtre : `site_hostname`

|                     |                                                                                                                     |
| ------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Propriété           | site\_hostname                                                                                                      |
| Type                | facultatif                                                                                                          |
| Type de variable    | chaîne                                                                                                              |
| Valeur par défaut   | -                                                                                                                   |
| Valeurs disponibles | Les caractères valides pour les noms d’hôte sont les lettres de a à z, les chiffres de 0 à 9, le tiret et le point. |
| Description         | Filtrer par nom d’hôte du site.                                                                                     |

#### Exemple :

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

### Filtre : `size`

|                     |                                                                                                |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| Propriété           | size                                                                                           |
| Type                | facultatif                                                                                     |
| Type de variable    | chaîne                                                                                         |
| Valeur par défaut   | -                                                                                              |
| Valeurs disponibles | Les caractères valides pour size sont les chiffres de 0 à 9 et le caractère x. Exemple 300x100 |
| Description         | Filtrer par taille                                                                             |

#### Exemple :

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

## Paramètre group\_by

|                                         |                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Propriété                               | group\_by                                                                                                                                                                                                                                                                                                                                                                                                  |
| Type                                    | obligatoire                                                                                                                                                                                                                                                                                                                                                                                                |
| Type de variable                        | tableau                                                                                                                                                                                                                                                                                                                                                                                                    |
| Type d’éléments                         | chaîne                                                                                                                                                                                                                                                                                                                                                                                                     |
| Valeur par défaut                       | -                                                                                                                                                                                                                                                                                                                                                                                                          |
| Valeurs disponibles pour les annonceurs | \[”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”] |
| Valeurs disponibles pour les éditeurs   | \[“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”, “size”, “sub”, “zone\_id”, “week”, “month”, “quarter”, “year”]                                                                                                                        |
| Description                             | Liste des sous-requêtes à inclure pour ajouter des données supplémentaires dans la réponse.                                                                                                                                                                                                                                                                                                                |

#### Exemple :

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

## Paramètre order\_by

| Propriété                                                                      | order\_by                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type                                                                           | facultatif                                                                                                                                                                                                                                                                                                                                                       |
| Type de variable                                                               | tableau                                                                                                                                                                                                                                                                                                                                                          |
| Type d’éléments                                                                | chaîne                                                                                                                                                                                                                                                                                                                                                           |
| Valeur par défaut                                                              | -                                                                                                                                                                                                                                                                                                                                                                |
| Valeurs des champs de métriques 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”]                                                  |
| Valeurs de champs disponibles en fonction de \`group\_by\` pour les annonceurs | \[”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”] |
| Valeurs de champs disponibles en fonction de \`group\_by\` pour les éditeurs   | \[“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”]                                                                                                          |
| Valeurs d’ordre disponibles                                                    | \[“asc”, “desc”]                                                                                                                                                                                                                                                                                                                                                 |
| Description                                                                    | Liste des options de tri disponibles                                                                                                                                                                                                                                                                                                                             |

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

* Les champs de métriques sont toujours disponibles pour être utilisés comme champ de tri.
* Pour trier selon une valeur spécifique (par exemple par “browser\_id”), vous devez l’inclure dans le paramètre “group\_by”.
  {% endhint %}

Les valeurs “g1”, “ecpa1” ne sont disponibles que lorsque l’utilisateur dispose du suivi des conversions (Goals). Tous les objectifs sont associés à un numéro de série (g1, g2, …gx). Les valeurs eCPA sont donc ecpa1, ecpa2, …ecpax.

#### Exemple :

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

Exemple d’organisation chronologique des résultats de campagne ; la valeur “date” doit être incluse à la fois dans “group\_by” et “order\_by” :

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

## Paramètre projection

Le paramètre projection indique ce qui sera renvoyé dans la charge utile résultante. S’il n’est pas spécifié, toutes les sous-structures seront renvoyées.

| Propriété                                         | projection                           |
| ------------------------------------------------- | ------------------------------------ |
| Type                                              | facultatif                           |
| Type de variable                                  | objet                                |
| Type d’éléments                                   | tableau                              |
| Valeur par défaut                                 | toutes les options, voir ci-dessous  |
| Valeurs de champs disponibles pour les annonceurs | \[“base”, “rtb”, “video”, “goals\*”] |
| Valeurs de champs disponibles pour les éditeurs   | \[“base”, “rtb”, “video”, “wpn”]     |

\*Certains champs "goal", comme "profit" et "roi", sont calculés à partir du coût de la campagne, vous devez donc également utiliser le champ "base" si vous souhaitez recevoir les métriques "goals" correctes.

#### Exemples :

Afin de recevoir toutes les métriques possibles en tant qu’annonceur, utilisez :

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

Afin de recevoir toutes les métriques possibles en tant qu’éditeur, utilisez :

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

Vous pouvez également préciser les métriques dans chaque champ 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"],
      //uniquement pour les éditeurs
      "wpn": ["subscriptions","unsubscriptions","sent"]
    }
}
```

Le seul champ qui ne permet pas de projection de métriques spécifique est "goals"

## Paramètre limit

Nombre d’enregistrements à renvoyer dans cette réponse.

|                   |            |
| ----------------- | ---------- |
| Propriété         | limit      |
| Type              | facultatif |
| Type de variable  | entier     |
| Valeur par défaut | 50         |

#### Exemple :

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

## Paramètre offset

Position à partir de laquelle récupérer les enregistrements.

|                   |            |
| ----------------- | ---------- |
| Propriété         | offset     |
| Type              | facultatif |
| Type de variable  | entier     |
| Valeur par défaut | 0          |

#### Exemple

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

## Exemple 1

Statistique de campagne annonceur avec filtrage.

#### Requête :

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

#### Réponse :

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

## Exemple 2

Statistique de l’annonceur par date pour le mois en cours, triée par impressions.

#### Requête :

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

#### Réponse :

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

## Exemple 3

Statistique de l'éditeur par date et region\_id, triée par impressions.

#### Requête :

```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": ["subscriptions","unsubscriptions","sent"],
    "rtb": ["*"]
  }
  "limit": 30,
  "offset": 0
}
```

#### Réponse :

```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": "États-Unis d'Amérique",
          "country_short_name": "États-Unis",
          "id": 5332921,
          "name": "Californie"
        }
      },
      "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": "États-Unis d'Amérique",
          "country_short_name": "États-Unis",
          "id": 5332921,
          "name": "Californie"
        }
      },
      "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
      }
    }
  ]
}
```

## Exemple 4

Statistique de l'éditeur par site\_id avec projection.

#### Requête :

```json
{
  "detailed": true,
  "projection": {
    "base": ["*"],
    "video": ["*"],
    "wpn": ["subscriptions","unsubscriptions","sent"],
    "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
}
```

#### Réponse

```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/fr/api-publique-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.