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

# Globale Statistik-API

Dieser Abschnitt beschreibt die Anfrageparameter und Ergebnisdaten der Global Statistics API.

{% hint style="info" %}
Die Routen der Statistik-API wurden umbenannt:

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

{% hint style="info" %}
Die Global Statistics API zeigt übersprungene RTB-Abfragen nur für Datum, Sites, Zonen, Länder, Regionen und Sub-IDs an.
{% endhint %}

| Parameter    | Beschreibung                                                                                             | Hinweise     | Typ          |
| ------------ | -------------------------------------------------------------------------------------------------------- | ------------ | ------------ |
| count        | Nur die Gesamtsumme der Ergebnisse zurückgeben.                                                          | Ganzzahl     | optional     |
| detailliert  | Falls möglich, mehr Details abrufen.                                                                     | Ganzzahl     | optional     |
| Zeitzone     | Zeitzoneneinstellung für den Filter 'hour' und 'group\_by'                                               | Zeichenfolge | optional     |
| Gesamtsummen | Gibt an, ob Gesamtsummen zur Antwort hinzugefügt werden sollen oder nicht.                               | Ganzzahl     | optional     |
| Filter       | Filter zur Einschränkung der zurückgegebenen Werte einer Statistikanfrage                                | Objekt       | optional     |
| group\_by    | Eine Liste von group\_by-Werten, die in den Daten angewendet werden sollen. Maximal vier sind erlaubt.   | Array        | erforderlich |
| order\_by    | Sortierung der Ergebnisse nach einem bestimmten Feld bzw. bestimmten Feldern. Maximal zwei sind erlaubt. | Array        | optional     |
| Projektion   | Einzelne Unterstrukturen, die ein Benutzer in der Antwort zurückerhalten möchte.                         | Array        | optional     |
| limit        | Die Anzahl der Datensätze, die in dieser Antwort zurückgegeben werden sollen.                            | Ganzzahl     | optional     |
| offset       | Die Position, ab der die Datensätze abgerufen werden sollen.                                             | Ganzzahl     | optional     |

## Parameter „count“

|                  |                                                 |
| ---------------- | ----------------------------------------------- |
| Eigenschaft      | count                                           |
| Typ              | optional                                        |
| Variablentyp     | Ganzzahl                                        |
| Standardwert     | 0                                               |
| Verfügbare Werte | \[0, 1]                                         |
| Beschreibung     | Nur die Gesamtsumme der Ergebnisse zurückgeben. |

#### Beispiel:

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

## Parameter „detailed“

|                  |                                                                       |
| ---------------- | --------------------------------------------------------------------- |
| Eigenschaft      | detailliert                                                           |
| Typ              | optional                                                              |
| Variablentyp     | Ganzzahl                                                              |
| Standardwert     | 0                                                                     |
| Verfügbare Werte | \[0, 1]                                                               |
| Beschreibung     | Ob detaillierte Informationen zurückgegeben werden sollen oder nicht. |

#### Beispiel:

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

## Parameter „timezone“

Zeitzoneneinstellung für `hour` Filter und `group_by`.

|                  |                                                                                                                                     |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Eigenschaft      | Zeitzone                                                                                                                            |
| Typ              | optional                                                                                                                            |
| Variablentyp     | Zeichenfolge                                                                                                                        |
| Standardwert     | America/New\_york                                                                                                                   |
| Verfügbare Werte | Zeitzonenfeld von /collections/timezones festlegen                                                                                  |
| Beschreibung     | HINWEIS: Zeitzonen sind nur relevant, wenn wir anhand stündlicher Daten abfragen; für nicht stündliche Daten ist dies ohne Wirkung. |

#### Beispiel:

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

## Parameter „totals“

|                  |                                                                            |
| ---------------- | -------------------------------------------------------------------------- |
| Eigenschaft      | Gesamtsummen                                                               |
| Typ              | optional                                                                   |
| Variablentyp     | Ganzzahl                                                                   |
| Standardwert     | 0                                                                          |
| Verfügbare Werte | \[0,1]                                                                     |
| Beschreibung     | Gibt an, ob Gesamtsummen zur Antwort hinzugefügt werden sollen oder nicht. |

#### Beispiel:

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

## Parameter „filter“

|                                      |                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Eigenschaft                          | Filter                                                                                                                                                                                                                                                                                                                                                                                                         |
| Typ                                  | optional                                                                                                                                                                                                                                                                                                                                                                                                       |
| Variablentyp                         | Objekt                                                                                                                                                                                                                                                                                                                                                                                                         |
| Verfügbare Option für Werbetreibende | \[”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”] |
| Verfügbare Option für 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”]                                                                                                                      |
| Beschreibung                         | Nach bestimmten Parametern filtern.                                                                                                                                                                                                                                                                                                                                                                            |

### Filter: `country_iso`

|                  |                                                                 |
| ---------------- | --------------------------------------------------------------- |
| Eigenschaft      | country\_iso                                                    |
| Typ              | optional                                                        |
| Variablentyp     | Zeichenfolge                                                    |
| Standardwert     | -                                                               |
| Verfügbare Werte | Siehe die Eigenschaft iso3 des Endpunkts /collections/countries |
| Beschreibung     | Liste der ISO-3-Codes                                           |

#### Beispiel:

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

### Filter `date_from`, `date_to`

Die `date_from` und `date_to` Die Parameter steuern das Zeitfenster, über das Sie Statistikinformationen abrufen möchten.

* date\_from: Datum ab Bereich für Statistiken, (Standard: Monatsanfang),
* date\_to: Datum bis Bereich für Statistiken, (Standard: heute)

|                  |                                                          |
| ---------------- | -------------------------------------------------------- |
| Eigenschaft      | date\_from, date\_to                                     |
| Typ              | optional                                                 |
| Variablentyp     | Zeichenfolge                                             |
| Standardwert     | Die Datumswerte sind standardmäßig der aktuelle Monat.   |
| Verfügbare Werte | YYYY-mm-dd                                               |
| Beschreibung     | Datumsbereich von/bis für Statistiken. Format YYYY-mm-dd |

#### Beispiel:

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

Zeitzonen sind nur relevant, wenn wir anhand stündlicher Daten abfragen; für nicht stündliche Daten ist dies ohne Wirkung.

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

|                  |                                                                                                                                                                                                                                                                                                                          |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Eigenschaft      | 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 |
| Typ              | optional                                                                                                                                                                                                                                                                                                                 |
| Variablentyp     | Array                                                                                                                                                                                                                                                                                                                    |
| Elementtyp       | Ganzzahl                                                                                                                                                                                                                                                                                                                 |
| Standardwert     | -                                                                                                                                                                                                                                                                                                                        |
| Verfügbare Werte | Relative Eigenschaften ODER Sammlungen                                                                                                                                                                                                                                                                                   |
| Beschreibung     | Liste der Entitäts-IDs                                                                                                                                                                                                                                                                                                   |

#### Beispiel:

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

### Filter: `exclude_deleted`

|                  |                                                                 |
| ---------------- | --------------------------------------------------------------- |
| Eigenschaft      | exclude\_deleted                                                |
| Typ              | optional                                                        |
| Variablentyp     | Ganzzahl                                                        |
| Standardwert     | 0                                                               |
| Verfügbare Werte | \[0, 1]                                                         |
| Beschreibung     | Ob gelöschte Kampagnen ausgeschlossen werden sollen oder nicht. |

#### Beispiel:

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

### Filter: `adblock`

|                  |                                                       |
| ---------------- | ----------------------------------------------------- |
| Eigenschaft      | adblock                                               |
| Typ              | optional                                              |
| Variablentyp     | Zeichenfolge                                          |
| Standardwert     | "all"                                                 |
| Verfügbare Werte | "adblock", "all", "standard"                          |
| Beschreibung     | Ob Adblock-Zonen einbezogen werden sollen oder nicht. |

#### Beispiel:

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

### Filter: `site_hostname`

|                  |                                                                                                        |
| ---------------- | ------------------------------------------------------------------------------------------------------ |
| Eigenschaft      | site\_hostname                                                                                         |
| Typ              | optional                                                                                               |
| Variablentyp     | Zeichenfolge                                                                                           |
| Standardwert     | -                                                                                                      |
| Verfügbare Werte | Gültige Zeichen für Hostnamen sind die Buchstaben a bis z, die Ziffern 0 bis 9, Bindestrich und Punkt. |
| Beschreibung     | Nach dem Site-Hostname filtern.                                                                        |

#### Beispiel:

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

### Filter: `size`

|                  |                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------ |
| Eigenschaft      | size                                                                                       |
| Typ              | optional                                                                                   |
| Variablentyp     | Zeichenfolge                                                                               |
| Standardwert     | -                                                                                          |
| Verfügbare Werte | Gültige Zeichen für die Größe sind die Ziffern 0 bis 9 und das Zeichen x. Beispiel 300x100 |
| Beschreibung     | Nach Größe filtern                                                                         |

#### Beispiel:

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

## Parameter „group\_by“

|                                     |                                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Eigenschaft                         | group\_by                                                                                                                                                                                                                                                                                                                                                                                                  |
| Typ                                 | erforderlich                                                                                                                                                                                                                                                                                                                                                                                               |
| Variablentyp                        | Array                                                                                                                                                                                                                                                                                                                                                                                                      |
| Elementtyp                          | Zeichenfolge                                                                                                                                                                                                                                                                                                                                                                                               |
| Standardwert                        | -                                                                                                                                                                                                                                                                                                                                                                                                          |
| Verfügbare Werte für Werbetreibende | \[”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”] |
| Verfügbare Werte für Publisher      | \[“adblock”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date”, “device\_id”, “device\_type\_id”, “hour”, “language\_id”, “operating\_system\_id”, “publisher\_ad\_type\_id” “region\_id”, “site\_id”, “size”, “sub”, “zone\_id”, “week”, “month”, “quarter”, “year”]                                                                                                                   |
| Beschreibung                        | Eine Liste von Unteranfragen, um zusätzliche Daten in die Antwort aufzunehmen.                                                                                                                                                                                                                                                                                                                             |

#### Beispiel:

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

## Parameter „order\_by“

| Eigenschaft                                                        | order\_by                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Typ                                                                | optional                                                                                                                                                                                                                                                                                                                                                         |
| Variablentyp                                                       | Array                                                                                                                                                                                                                                                                                                                                                            |
| Elementtyp                                                         | Zeichenfolge                                                                                                                                                                                                                                                                                                                                                     |
| Standardwert                                                       | -                                                                                                                                                                                                                                                                                                                                                                |
| Verfügbare Feldwerte für Metriken                                  | \[“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”]                                                  |
| Verfügbare Feldwerte abhängig von \`group\_by\` für Werbetreibende | \[”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”] |
| Verfügbare Feldwerte abhängig von \`group\_by\` für 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”]                                                                                                          |
| Verfügbare Sortierwerte                                            | \[“asc”, “desc”]                                                                                                                                                                                                                                                                                                                                                 |
| Beschreibung                                                       | Eine Liste verfügbarer Order-by-Optionen                                                                                                                                                                                                                                                                                                                         |

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

* Die Metrikfelder sind jederzeit verfügbar, um als Order-by-Feld verwendet zu werden.
* Um nach einem bestimmten Wert zu sortieren (zum Beispiel nach “browser\_id”), müssen Sie ihn im Parameter “group\_by” einschließen.
  {% endhint %}

Die Werte “g1” und “ecpa1” sind nur verfügbar, wenn der Benutzer Conversion Tracking (Goals) hat. Alle Ziele sind mit einer Seriennummer (g1, g2, …gx) verknüpft. Die eCPA-Werte sind entsprechend ecpa1, ecpa2, …ecpax.

#### Beispiel:

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

Beispiel zur chronologischen Sortierung der Kampagnenergebnisse muss „date“ sowohl in „group\_by“ als auch in „order\_by“ enthalten sein:

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

## Parameter „projection“

Der Parameter projection gibt an, was in der resultierenden Nutzlast zurückgegeben wird. Wenn nicht angegeben, werden alle Unterstrukturen zurückgegeben.

| Eigenschaft                             | Projektion                           |
| --------------------------------------- | ------------------------------------ |
| Typ                                     | optional                             |
| Variablentyp                            | Objekt                               |
| Elementtyp                              | Array                                |
| Standardwert                            | alle Optionen, siehe unten           |
| Verfügbare Feldwerte für Werbetreibende | \[“base”, “rtb”, “video”, “goals\*”] |
| Verfügbare Feldwerte für Publisher      | \[“base”, “rtb”, “video”, “wpn”]     |

Einige „goal“-Felder, wie „profit“ und „roi“, werden auf Basis der Kampagnenkosten berechnet. Daher müssen Sie auch das Feld „base“ verwenden, wenn Sie die korrekten „goals“-Metriken erhalten möchten.

#### Beispiele:

Um als Werbetreibender alle möglichen Metriken zu erhalten, verwenden Sie:

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

Um als Publisher alle möglichen Metriken zu erhalten, verwenden Sie:

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

Sie können die Metriken auch innerhalb jedes Projection-Feldes angeben:

```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"],
      //nur für Publisher
      "wpn": ["subscriptions","unsubscriptions","sent"]
    }
}
```

Das einzige Feld, das keine spezifische Metrikprojektion zulässt, ist "goals"

## Parameter „limit“

Die Anzahl der Datensätze, die in dieser Antwort zurückgegeben werden sollen.

|              |          |
| ------------ | -------- |
| Eigenschaft  | limit    |
| Typ          | optional |
| Variablentyp | Ganzzahl |
| Standardwert | 50       |

#### Beispiel:

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

## Parameter „offset“

Die Position, ab der die Datensätze abgerufen werden sollen.

|              |          |
| ------------ | -------- |
| Eigenschaft  | offset   |
| Typ          | optional |
| Variablentyp | Ganzzahl |
| Standardwert | 0        |

#### Beispiel

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

## Beispiel 1

Kampagnenstatistik des Werbetreibenden mit Filterung.

#### Anfrage:

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

#### Antwort:

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

## Beispiel 2

Werbetreibendenstatistik nach Datum für den aktuellen Monat, sortiert nach Impressionen.

#### Anfrage:

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

#### Antwort:

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

## Beispiel 3

Publisher-Statistik nach date und region\_id, sortiert nach impressions.

#### Anfrage:

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

#### Antwort:

```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": "Vereinigte Staaten von Amerika",
          "country_short_name": "Vereinigte Staaten",
          "id": 5332921,
          "name": "Kalifornien"
        }
      },
      "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": "Vereinigte Staaten von Amerika",
          "country_short_name": "Vereinigte Staaten",
          "id": 5332921,
          "name": "Kalifornien"
        }
      },
      "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
      }
    }
  ]
}
```

## Beispiel 4

Publisher-Statistik nach site\_id mit Projektion.

#### Anfrage:

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

#### Antwort

```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/de/exoclick-public-api/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.