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

# グローバル統計 API

このセクションでは、Global Statistics API のリクエストパラメータと結果データについて説明します。

{% hint style="info" %}
statistics API のルート名が変更されました:

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

{% hint style="info" %}
Global Statistics API では、Date、Sites、Zones、Countries、Regions、Sub IDs のスキップされた RTB クエリのみが表示されます。
{% endhint %}

| パラメータ      | 説明                                     | 備考     | 型  |
| ---------- | -------------------------------------- | ------ | -- |
| count      | 結果の合計のみを返します。                          | 整数     | 任意 |
| detailed   | 可能であれば、より詳細な情報を取得します。                  | 整数     | 任意 |
| timezone   | 'hour' フィルターと 'group\_by' のタイムゾーン設定    | 文字列    | 任意 |
| totals     | 応答に合計を追加するかどうかを示します。                   | 整数     | 任意 |
| filter     | 統計クエリの返却値を絞り込むためのフィルター                 | オブジェクト | 任意 |
| group\_by  | データに適用する group by 値の一覧。最大 4 件まで指定できます。 | 配列     | 必須 |
| order\_by  | 特定のフィールドによる結果の並び順。最大 2 件まで指定できます。      | 配列     | 任意 |
| projection | 応答で返却したい個々のサブ構造。                       | 配列     | 任意 |
| limit      | このレスポンスで返却するレコード数。                     | 整数     | 任意 |
| offset     | レコードを取得する開始位置。                         | 整数     | 任意 |

## パラメータ数

|        |               |
| ------ | ------------- |
| プロパティ  | count         |
| 型      | 任意            |
| 変数の型   | 整数            |
| デフォルト値 | 0             |
| 利用可能な値 | \[0, 1]       |
| 説明     | 結果の合計のみを返します。 |

#### 例:

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

## パラメータ detailed

|        |              |
| ------ | ------------ |
| プロパティ  | detailed     |
| 型      | 任意           |
| 変数の型   | 整数           |
| デフォルト値 | 0            |
| 利用可能な値 | \[0, 1]      |
| 説明     | 詳細情報を返すかどうか。 |

#### 例:

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

## パラメータ timezone

timezone のタイムゾーン設定 `hour` filter と `group_by`.

|        |                                                            |
| ------ | ---------------------------------------------------------- |
| プロパティ  | timezone                                                   |
| 型      | 任意                                                         |
| 変数の型   | 文字列                                                        |
| デフォルト値 | America/New\_york                                          |
| 利用可能な値 | /collections/timezones の timezone フィールドを設定します              |
| 説明     | 注意: タイムゾーンは、時間単位のデータに基づいてクエリする場合にのみ関連し、時間単位以外のデータでは何もしません。 |

#### 例:

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

## パラメータ totals

|        |                      |
| ------ | -------------------- |
| プロパティ  | totals               |
| 型      | 任意                   |
| 変数の型   | 整数                   |
| デフォルト値 | 0                    |
| 利用可能な値 | \[0,1]               |
| 説明     | 応答に合計を追加するかどうかを示します。 |

#### 例:

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

## パラメータ filter

|                      |                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| プロパティ                | filter                                                                                                                                                                                                                                                                                                                                                                                                         |
| 型                    | 任意                                                                                                                                                                                                                                                                                                                                                                                                             |
| 変数の型                 | オブジェクト                                                                                                                                                                                                                                                                                                                                                                                                         |
| 広告主向けの利用可能なオプション     | \[”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”] |
| パブリッシャー向けの利用可能なオプション | \[”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”]                                                                                                                      |
| 説明                   | 特定のパラメータでフィルターします。                                                                                                                                                                                                                                                                                                                                                                                             |

### フィルター: `country_iso`

|        |                                                     |
| ------ | --------------------------------------------------- |
| プロパティ  | country\_iso                                        |
| 型      | 任意                                                  |
| 変数の型   | 文字列                                                 |
| デフォルト値 | -                                                   |
| 利用可能な値 | /collections/countries エンドポイントの iso3 プロパティを参照してください |
| 説明     | ISO 3 コード一覧                                         |

#### 例:

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

### フィルター `date_from`, `date_to`

その `date_from` および `date_to` これらのパラメータは、統計情報を取得する期間を制御します。

* date\_from: 統計の開始日範囲（デフォルトは月初）,
* date\_to: 統計の終了日範囲（デフォルトは今日）

|        |                             |
| ------ | --------------------------- |
| プロパティ  | date\_from, date\_to        |
| 型      | 任意                          |
| 変数の型   | 文字列                         |
| デフォルト値 | 日付はデフォルトで当月になります。           |
| 利用可能な値 | YYYY-mm-dd                  |
| 説明     | 統計の開始日/終了日範囲。形式は YYYY-mm-dd |

#### 例:

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

タイムゾーンは、時間単位のデータに基づいてクエリする場合にのみ関連し、時間単位以外のデータでは何もしません。

### フィルター: 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

|        |                                                                                                                                                                                                                                                                                                                          |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| プロパティ  | 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 |
| 型      | 任意                                                                                                                                                                                                                                                                                                                       |
| 変数の型   | 配列                                                                                                                                                                                                                                                                                                                       |
| アイテムの型 | 整数                                                                                                                                                                                                                                                                                                                       |
| デフォルト値 | -                                                                                                                                                                                                                                                                                                                        |
| 利用可能な値 | 関連プロパティ または コレクション                                                                                                                                                                                                                                                                                                       |
| 説明     | エンティティ ID の一覧                                                                                                                                                                                                                                                                                                            |

#### 例:

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

### フィルター: `exclude_deleted`

|        |                      |
| ------ | -------------------- |
| プロパティ  | exclude\_deleted     |
| 型      | 任意                   |
| 変数の型   | 整数                   |
| デフォルト値 | 0                    |
| 利用可能な値 | \[0, 1]              |
| 説明     | 削除済みキャンペーンを除外するかどうか。 |

#### 例:

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

### フィルター: `adblock`

|        |                              |
| ------ | ---------------------------- |
| プロパティ  | adblock                      |
| 型      | 任意                           |
| 変数の型   | 文字列                          |
| デフォルト値 | "all"                        |
| 利用可能な値 | "adblock", "all", "standard" |
| 説明     | adblock ゾーンを含めるかどうか。         |

#### 例:

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

### フィルター: `site_hostname`

|        |                                                     |
| ------ | --------------------------------------------------- |
| プロパティ  | site\_hostname                                      |
| 型      | 任意                                                  |
| 変数の型   | 文字列                                                 |
| デフォルト値 | -                                                   |
| 利用可能な値 | ホスト名として有効な文字は、a から z までの英字、0 から 9 までの数字、ハイフン、ドットです。 |
| 説明     | サイトのホスト名でフィルターします。                                  |

#### 例:

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

### フィルター: `size`

|        |                                              |
| ------ | -------------------------------------------- |
| プロパティ  | size                                         |
| 型      | 任意                                           |
| 変数の型   | 文字列                                          |
| デフォルト値 | -                                            |
| 利用可能な値 | size に有効な文字は、0 から 9 までの数字と x 文字です。例: 300x100 |
| 説明     | size でフィルターします                               |

#### 例:

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

## パラメータ group\_by

|                  |                                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| プロパティ            | group\_by                                                                                                                                                                                                                                                                                                                                                                                                  |
| 型                | 必須                                                                                                                                                                                                                                                                                                                                                                                                         |
| 変数の型             | 配列                                                                                                                                                                                                                                                                                                                                                                                                         |
| アイテムの型           | 文字列                                                                                                                                                                                                                                                                                                                                                                                                        |
| デフォルト値           | -                                                                                                                                                                                                                                                                                                                                                                                                          |
| 広告主向けの利用可能な値     | \[”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”] |
| パブリッシャー向けの利用可能な値 | \[“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”]                                                                                                                   |
| 説明               | 追加データを応答に含めるためのサブリクエスト一覧。                                                                                                                                                                                                                                                                                                                                                                                  |

#### 例:

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

## パラメータ order\_by

| プロパティ                                  | order\_by                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 型                                      | 任意                                                                                                                                                                                                                                                                                                                                                               |
| 変数の型                                   | 配列                                                                                                                                                                                                                                                                                                                                                               |
| アイテムの型                                 | 文字列                                                                                                                                                                                                                                                                                                                                                              |
| デフォルト値                                 | -                                                                                                                                                                                                                                                                                                                                                                |
| 利用可能なメトリクス項目値                          | \[“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”]                                                  |
| 広告主向けの \`group\_by\` に依存する利用可能な項目値     | \[”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”] |
| パブリッシャー向けの \`group\_by\` に依存する利用可能な項目値 | \[“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”]                                                                                                          |
| 利用可能な order 値                          | \[“asc”, “desc”]                                                                                                                                                                                                                                                                                                                                                 |
| 説明                                     | 利用可能な order\_by オプション一覧                                                                                                                                                                                                                                                                                                                                          |

{% hint style="info" %}
**ヒント**:

* メトリクス項目は、常に order\_by フィールドとして使用できます。
* 特定の値（たとえば “browser\_id”）で並べ替えるには、“group\_by” パラメータに含める必要があります。
  {% endhint %}

“g1”, “ecpa1” の値は、ユーザーがコンバージョントラッキング（Goals）を有効にしている場合にのみ利用できます。シリアル番号（g1, g2, …gx）に関連付けられたすべての goals。eCPA 値はそれぞれ ecpa1, ecpa2, …ecpax です。

#### 例:

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

キャンペーン結果を時系列で並べるには、“date” を “group\_by” と “order\_by” の両方に含める必要があります:

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

## パラメータ projection

projection パラメータは、結果ペイロードに何が返されるかを示します。指定しない場合は、すべてのサブ構造が返されます。

| プロパティ              | projection                           |
| ------------------ | ------------------------------------ |
| 型                  | 任意                                   |
| 変数の型               | オブジェクト                               |
| アイテムの型             | 配列                                   |
| デフォルト値             | すべてのオプション、以下を参照                      |
| 広告主向けの利用可能な項目値     | \[“base”, “rtb”, “video”, “goals\*”] |
| パブリッシャー向けの利用可能な項目値 | \[“base”, “rtb”, “video”, “wpn”]     |

\*「profit」や「roi」のような一部の "goal" フィールドは、キャンペーンのコストに基づいて計算されるため、正しい "goals" メトリクスを受け取りたい場合は "base" フィールドも使用する必要があります。

#### 例:

広告主として可能なすべてのメトリクスを受け取るには、次を使用します:

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

パブリッシャーとして可能なすべてのメトリクスを受け取るには、次を使用します:

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

各 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"],
      //パブリッシャーのみ
      "wpn": ["subscriptions","unsubscriptions","sent"]
    }
}
```

個別のメトリクス projection を許可しない唯一のフィールドは "goals" です

## パラメータ limit

このレスポンスで返却するレコード数。

|        |       |
| ------ | ----- |
| プロパティ  | limit |
| 型      | 任意    |
| 変数の型   | 整数    |
| デフォルト値 | 50    |

#### 例:

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

## パラメータ offset

レコードを取得する開始位置。

|        |        |
| ------ | ------ |
| プロパティ  | offset |
| 型      | 任意     |
| 変数の型   | 整数     |
| デフォルト値 | 0      |

#### 例

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

## 例 1

フィルタリング付きの広告主キャンペーン統計。

#### リクエスト:

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

#### レスポンス:

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

## 例 2

当月の、impressions で並べ替えた日付別広告主統計。

#### リクエスト:

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

#### レスポンス:

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

## 例 3

date と region\_id によるパブリッシャー統計。インプレッション順。

#### リクエスト:

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

#### レスポンス:

```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": "アメリカ合衆国",
          "country_short_name": "アメリカ合衆国",
          "id": 5332921,
          "name": "カリフォルニア"
        }
      },
      "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": "アメリカ合衆国",
          "country_short_name": "アメリカ合衆国",
          "id": 5332921,
          "name": "カリフォルニア"
        }
      },
      "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
      }
    }
  ]
}
```

## 例 4

site\_id によるパブリッシャー統計。プロジェクション付き。

#### リクエスト:

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

#### レスポンス

```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/ja/exoclick-paburikku-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.