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

# API de Estatísticas Globais

Esta secção descreve os parâmetros de pedido e os dados de resultado da API de Estatísticas Globais.

{% hint style="info" %}
As rotas da API de estatísticas foram renomeadas:

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

{% hint style="info" %}
A API de Estatísticas Globais só mostra consultas RTB ignoradas para Data, Sites, Zonas, Países, Regiões e Sub IDs.
{% endhint %}

| Parâmetro    | Descrição                                                                           | Notas                | Tipo        |
| ------------ | ----------------------------------------------------------------------------------- | -------------------- | ----------- |
| contagem     | Devolver apenas o total dos resultados.                                             | inteiro              | opcional    |
| detalhado    | Obter mais detalhes, se possível.                                                   | inteiro              | opcional    |
| fuso horário | Configuração de fuso horário para o filtro 'hour' e 'group\_by'                     | cadeia de caracteres | opcional    |
| totais       | Indica se devem ser adicionados totais à resposta ou não.                           | inteiro              | opcional    |
| filtro       | Filtros para restringir os valores devolvidos de uma consulta de estatísticas       | objeto               | opcional    |
| group\_by    | Uma lista de valores group by a aplicar nos dados. São permitidos no máximo quatro. | array                | obrigatório |
| order\_by    | Ordenação dos resultados por campo(s) específico(s). São permitidos no máximo dois. | array                | opcional    |
| projection   | Subestruturas individuais que o utilizador deseja receber na resposta.              | array                | opcional    |
| limit        | O número de registos a devolver nesta resposta.                                     | inteiro              | opcional    |
| offset       | A posição a partir da qual recuperar os registos.                                   | inteiro              | opcional    |

## Contagem do parâmetro

|                     |                                         |
| ------------------- | --------------------------------------- |
| Propriedade         | contagem                                |
| Tipo                | opcional                                |
| Tipo de variável    | inteiro                                 |
| Valor predefinido   | 0                                       |
| Valores disponíveis | \[0, 1]                                 |
| Descrição           | Devolver apenas o total dos resultados. |

#### Exemplo:

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

## Parâmetro detailed

|                     |                                               |
| ------------------- | --------------------------------------------- |
| Propriedade         | detalhado                                     |
| Tipo                | opcional                                      |
| Tipo de variável    | inteiro                                       |
| Valor predefinido   | 0                                             |
| Valores disponíveis | \[0, 1]                                       |
| Descrição           | Se deve ou não devolver informação detalhada. |

#### Exemplo:

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

## Parâmetro timezone

Configuração de fuso horário para `hour` filter e `group_by`.

|                     |                                                                                                                                                |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Propriedade         | fuso horário                                                                                                                                   |
| Tipo                | opcional                                                                                                                                       |
| Tipo de variável    | cadeia de caracteres                                                                                                                           |
| Valor predefinido   | America/New\_york                                                                                                                              |
| Valores disponíveis | Defina o campo de fuso horário de / collections / timezones                                                                                    |
| Descrição           | NOTA: Os fusos horários só são relevantes quando estamos a consultar com base em dados horários; para dados não horários, isto não tem efeito. |

#### Exemplo:

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

## Parâmetro totals

|                     |                                                           |
| ------------------- | --------------------------------------------------------- |
| Propriedade         | totais                                                    |
| Tipo                | opcional                                                  |
| Tipo de variável    | inteiro                                                   |
| Valor predefinido   | 0                                                         |
| Valores disponíveis | \[0,1]                                                    |
| Descrição           | Indica se devem ser adicionados totais à resposta ou não. |

#### Exemplo:

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

## Parâmetro filter

|                                   |                                                                                                                                                                                                                                                                                                                                                                                                                |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Propriedade                       | filtro                                                                                                                                                                                                                                                                                                                                                                                                         |
| Tipo                              | opcional                                                                                                                                                                                                                                                                                                                                                                                                       |
| Tipo de variável                  | objeto                                                                                                                                                                                                                                                                                                                                                                                                         |
| Opção disponível para anunciantes | \[”adblock”, ”advertiser\_ad\_type\_id”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date\_from”, “date\_to”, “device\_id”, “device\_type\_id”, hour”, “language\_id”, “operating\_system\_id”, “region\_id”, “site\_hostname”, “site\_id”, “size”, “sub”, “zone\_id”, “campaign\_group\_id”, “campaign\_id”, “exclude\_deleted”, “offer\_id”, “offer\_landing\_page\_id”, “variation\_id”] |
| Opção disponível para editores    | \[”adblock”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date\_from”, “date\_to”, “device\_id”, “device\_type\_id”, “hour”, “language\_id”, “operating\_system\_id”, “region\_id”, “site\_hostname”, “site\_id”, “zone\_id”, “publisher\_ad\_type\_id”, “size”, “sub”]                                                                                                                      |
| Descrição                         | Filtre por determinados parâmetros.                                                                                                                                                                                                                                                                                                                                                                            |

### Filtro: `country_iso`

|                     |                                                            |
| ------------------- | ---------------------------------------------------------- |
| Propriedade         | country\_iso                                               |
| Tipo                | opcional                                                   |
| Tipo de variável    | cadeia de caracteres                                       |
| Valor predefinido   | -                                                          |
| Valores disponíveis | Veja a propriedade iso3 do endpoint /collections/countries |
| Descrição           | Lista de códigos ISO 3                                     |

#### Exemplo:

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

### Filtro `date_from`, `date_to`

O `date_from` e `date_to` os parâmetros controlam a janela temporal sobre a qual pretende obter informações estatísticas.

* date\_from: data inicial do intervalo para estatísticas (início do mês por defeito),
* date\_to: data final do intervalo para estatísticas (hoje por defeito)

|                     |                                                                        |
| ------------------- | ---------------------------------------------------------------------- |
| Propriedade         | date\_from, date\_to                                                   |
| Tipo                | opcional                                                               |
| Tipo de variável    | cadeia de caracteres                                                   |
| Valor predefinido   | As datas, por defeito, correspondem ao mês atual.                      |
| Valores disponíveis | YYYY-mm-dd                                                             |
| Descrição           | Intervalo de datas inicial/final para estatísticas. Formato YYYY-mm-dd |

#### Exemplo:

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

Os fusos horários só são relevantes quando estamos a consultar com base em dados horários; para dados não horários, isto não tem efeito.

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

|                     |                                                                                                                                                                                                                                                                                                                          |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Propriedade         | advertiser\_ad\_type\_id, campaign\_group\_id, campaign\_id, browser\_id, carrier\_id, category\_id, device\_id, device\_type\_id, language\_id, offer\_id, offer\_landing\_page\_id, operating\_system\_id, hour, region\_id, site\_id, sub, variation\_id, zone\_id, advertiser\_ad\_type\_id, publisher\_ad\_type\_id |
| Tipo                | opcional                                                                                                                                                                                                                                                                                                                 |
| Tipo de variável    | array                                                                                                                                                                                                                                                                                                                    |
| Tipo de itens       | inteiro                                                                                                                                                                                                                                                                                                                  |
| Valor predefinido   | -                                                                                                                                                                                                                                                                                                                        |
| Valores disponíveis | Propriedades relativas OU coleções                                                                                                                                                                                                                                                                                       |
| Descrição           | Lista de IDs das entidades                                                                                                                                                                                                                                                                                               |

#### Exemplo:

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

### Filtro: `exclude_deleted`

|                     |                                              |
| ------------------- | -------------------------------------------- |
| Propriedade         | exclude\_deleted                             |
| Tipo                | opcional                                     |
| Tipo de variável    | inteiro                                      |
| Valor predefinido   | 0                                            |
| Valores disponíveis | \[0, 1]                                      |
| Descrição           | Se deve excluir campanhas eliminadas ou não. |

#### Exemplo:

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

### Filtro: `adblock`

|                     |                                          |
| ------------------- | ---------------------------------------- |
| Propriedade         | adblock                                  |
| Tipo                | opcional                                 |
| Tipo de variável    | cadeia de caracteres                     |
| Valor predefinido   | "all"                                    |
| Valores disponíveis | "adblock", "all", "standard"             |
| Descrição           | Se deve incluir zonas de adblock ou não. |

#### Exemplo:

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

### Filtro: `site_hostname`

|                     |                                                                                               |
| ------------------- | --------------------------------------------------------------------------------------------- |
| Propriedade         | site\_hostname                                                                                |
| Tipo                | opcional                                                                                      |
| Tipo de variável    | cadeia de caracteres                                                                          |
| Valor predefinido   | -                                                                                             |
| Valores disponíveis | Os caracteres válidos para hostnames são letras de a a z, os dígitos de 0 a 9, hífen e ponto. |
| Descrição           | Filtrar pelo hostname do site.                                                                |

#### Exemplo:

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

### Filtro: `size`

|                     |                                                                                          |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Propriedade         | size                                                                                     |
| Tipo                | opcional                                                                                 |
| Tipo de variável    | cadeia de caracteres                                                                     |
| Valor predefinido   | -                                                                                        |
| Valores disponíveis | Os caracteres válidos para size são os dígitos de 0 a 9 e o caractere x. Exemplo 300x100 |
| Descrição           | Filtrar por tamanho                                                                      |

#### Exemplo:

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

## Parâmetro group\_by

|                                      |                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Propriedade                          | group\_by                                                                                                                                                                                                                                                                                                                                                                                                  |
| Tipo                                 | obrigatório                                                                                                                                                                                                                                                                                                                                                                                                |
| Tipo de variável                     | array                                                                                                                                                                                                                                                                                                                                                                                                      |
| Tipo de itens                        | cadeia de caracteres                                                                                                                                                                                                                                                                                                                                                                                       |
| Valor predefinido                    | -                                                                                                                                                                                                                                                                                                                                                                                                          |
| Valores disponíveis para anunciantes | \[”adblock”, “advertiser\_ad\_type\_id”, browser\_id”, “idcampaign\_group“, “campaign\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date”, “hour”, “device\_id”, “device\_type\_id”, “language\_id”, “operating\_system\_id”, “region\_id”, “site\_id”, “sub”, “zone\_id”, “week”, “month”, “quarter”, “year”, “offer\_id”, “offer\_landing\_page\_id”, “site\_hostname”, “size”, “variation\_id”] |
| Valores disponíveis para editores    | \[“adblock”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “device\_id”, “date”, “device\_type\_id” , “hour”, “language\_id”, “month”, “operating\_system\_id”, “quarter”, “region\_id”, “site\_id”, “sub”, “week”, “year”, “zone\_id”]                                                                                                                                                    |
| Descrição                            | Uma lista de subpedidos para incluir dados adicionais na resposta.                                                                                                                                                                                                                                                                                                                                         |

#### Exemplo:

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

## Parâmetro order\_by

| Propriedade                                                                | order\_by                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo                                                                       | opcional                                                                                                                                                                                                                                                                                                                                                         |
| Tipo de variável                                                           | array                                                                                                                                                                                                                                                                                                                                                            |
| Tipo de itens                                                              | cadeia de caracteres                                                                                                                                                                                                                                                                                                                                             |
| Valor predefinido                                                          | -                                                                                                                                                                                                                                                                                                                                                                |
| Valores disponíveis dos campos de métricas                                 | \[“cpc”, “cpc”, “cpm”, “cpv”, “ctr”, “clicks”, “impressions”, “video\_impressions”, “video\_views”, “vtr”, “rtb\_win\_ratio”, “rtb\_avg\_total\_time”, “rtb\_skipped”, “rtb\_bid\_response\_ratio”, “rtb\_avg\_cpm”, “rtb\_timeouts\_ratio”, “rt\_errors\_ratio”, “rtb\_no\_bid\_ratio”, “rtb\_skipped\_ratio”]                                                  |
| Valores de campo disponíveis dependentes de \`group\_by\` para anunciantes | \[”adblock”, “browser\_id”, “campaign\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “device\_id”, “date”, “device\_type\_id”, “hour”, “ecpa1”, “g1”,“language\_id”, “month”, “offer\_id”, “offer\_landing\_page\_id”, “operating\_system\_id”, “quarter”, “region\_id”, “site\_hostname”, “site\_id”, “sub”, “variation\_id”, “week”, “year” ,“zone\_id”] |
| Valores de campo disponíveis dependentes de \`group\_by\` para editores    | \[“adblock”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “device\_id”, “date”, “device\_type\_id” , “hour”, “language\_id”, “month”, “operating\_system\_id”, “quarter”, “region\_id”, “site\_id”, “sub”, “week”, “year”, “zone\_id”]                                                                                                          |
| Valores de ordenação disponíveis                                           | \[“asc”, “desc”]                                                                                                                                                                                                                                                                                                                                                 |
| Descrição                                                                  | Uma lista das opções de order by disponíveis                                                                                                                                                                                                                                                                                                                     |

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

* Os campos de métricas estão sempre disponíveis para serem usados como campo de ordenação.
* Para ordenar por um valor específico (por exemplo, por “browser\_id”), é necessário incluí-lo no parâmetro “group\_by”.
  {% endhint %}

Os valores “g1” e “ecpa1” só estão disponíveis quando o utilizador tem Conversion Tracking (Goals). Todos os goals associados a um número de série (g1, g2, …gx). Os valores de eCPA são, respetivamente, ecpa1, ecpa2, …ecpax.

#### Exemplo:

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

Exemplo para organizar os resultados da campanha cronologicamente; a “date” precisa de ser incluída tanto em “group\_by” como em “order\_by”:

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

## Parâmetro projection

O parâmetro projection reflete o que será devolvido no payload resultante. Se não for especificado, todas as subestruturas serão devolvidas.

| Propriedade                                   | projection                           |
| --------------------------------------------- | ------------------------------------ |
| Tipo                                          | opcional                             |
| Tipo de variável                              | objeto                               |
| Tipo de itens                                 | array                                |
| Valor predefinido                             | todas as opções, veja abaixo         |
| Valores de campo disponíveis para anunciantes | \[“base”, “rtb”, “video”, “goals\*”] |
| Valores de campo disponíveis para editores    | \[“base”, “rtb”, “video”, “wpn”]     |

\*Alguns campos "goal", como "profit" e "roi", são calculados com base no custo da campanha, por isso também deve usar o campo "base" se quiser receber as métricas "goals" corretas.

#### Exemplos:

Para receber todas as métricas possíveis como anunciante, use:

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

Para receber todas as métricas possíveis como editor, use:

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

Também pode especificar as métricas dentro de cada campo de projeção:

```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"],
      //apenas para editores
      "wpn": ["subscriptions","unsubscriptions","sent"]
    }
}
```

O único campo que não permite projeção específica de métricas é "goals"

## Parâmetro limit

O número de registos a devolver nesta resposta.

|                   |          |
| ----------------- | -------- |
| Propriedade       | limit    |
| Tipo              | opcional |
| Tipo de variável  | inteiro  |
| Valor predefinido | 50       |

#### Exemplo:

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

## Parâmetro offset

A posição a partir da qual recuperar os registos.

|                   |          |
| ----------------- | -------- |
| Propriedade       | offset   |
| Tipo              | opcional |
| Tipo de variável  | inteiro  |
| Valor predefinido | 0        |

#### Exemplo

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

## Exemplo 1

Estatística da campanha do anunciante com filtragem.

#### Pedido:

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

#### Resposta:

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

## Exemplo 2

Estatística do anunciante por data para o mês atual, ordenada por impressões.

#### Pedido:

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

#### Resposta:

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

## Exemplo 3

Estatística do publicador por date e region\_id, ordenada por impressões.

#### Pedido:

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

#### Resposta:

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

## Exemplo 4

Estatística do publicador por site\_id com projeção.

#### Pedido:

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

#### Resposta

```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/pt/api-publica-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.