> 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/ru/api-razmesheniya-reklamy/ad-plac-request.md).

# Запрос

API размещения рекламы можно вызывать либо с **клиентской** стороны или **серверной** стороны.

При использовании **клиентской** реализации со стороны, браузер может выполнить **pre-flight** запрос. Если вы хотите избежать этого, в заголовке запроса используйте `Content-Type: text/plain`. Это гарантирует, что браузер классифицирует запрос как «простой» и, следовательно, пропустит pre-flight-запрос.

Также при вызове API на **клиентской** стороны, **IP-адреса на самом деле не требуются** так как обнаружить IP с помощью фронтенда и Javascript бывает сложно. Вместо этого наш API определяет IP по соединению в момент отправки запроса.

При использовании **серверной** реализации со стороны, чтобы обеспечить корректный таргетинг, **правильный IP пользователя следует передавать явно**. В противном случае реклама будет таргетироваться по местоположению сервера, и впоследствии это может привести к аннулированию показов из-за несовпадения IP.

Независимо от того, используется клиент или сервер, если передан IP, он будет иметь приоритет над тем, который мы определяем.

Чтобы выполнить запрос к API размещения рекламы, необходимо передать два объекта: **пользователь** и **зоны**. Запрос выполняется в JSON с использованием HTTP POST.

## пользователь

| Параметр            | Обязательно?  | Описание                                                                                                                                                                                                                                 |
| ------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                  | Нет           | ID пользователя                                                                                                                                                                                                                          |
| ip                  | Рекомендуется | IP-адрес пользователя.                                                                                                                                                                                                                   |
| ua                  | Да            | User Agent: строка, содержащая браузер/приложение пользователя и его устройство/ОС.                                                                                                                                                      |
| language            | Нет           | Задает язык запроса с использованием [стандартного двухсимвольного кода ISO](https://www.andiamo.co.uk/resources/iso-language-codes/) плюс необязательного двухсимвольного кода региона, например `en-us` для американского английского. |
| referer             | Нет           | Адрес сайта, где будет показана реклама.                                                                                                                                                                                                 |
| el                  | Нет           | Электронная почта пользователя, закодированная в Base64.                                                                                                                                                                                 |
| screen\_resolution  | Нет           | Разрешение экрана устройства, используемого пользователем                                                                                                                                                                                |
| window\_orientation | Нет           | Здесь должно быть "portrait", если у сайта мобильная верстка, и "landscape", если это десктопная версия.                                                                                                                                 |
| gdpr                | Нет           | Расширения, рекомендованные для конфиденциальности (объект).                                                                                                                                                                             |

### user.gdpr

| Параметр | Описание                                                                                                                                       |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| gdpr     | Здесь должно быть **0** если вызывающая сторона считает, что пользователь не подпадает под GDPR, и **1** если пользователь подпадает под GDPR. |
| consent  | Это строка согласия, требуемая стандартами IAB.                                                                                                |

## зоны

| Параметр          | Обязательно? | Описание                                                                                                                                                                                                                                                                       |
| ----------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| id                | Да           | ID рекламной зоны                                                                                                                                                                                                                                                              |
| sub               | Нет          | Sub ID рекламной зоны                                                                                                                                                                                                                                                          |
| sub2              | Нет          | Дополнительный Sub ID (необязательный). См. [Использование дополнительных Sub ID](https://docs.exoclick.com/publishers/ru/saity-i-zony/additional-subids.md).                                                                                                                  |
| sub3              | Нет          | Дополнительный Sub ID (необязательный). См. [Использование дополнительных Sub ID](https://docs.exoclick.com/publishers/ru/saity-i-zony/additional-subids.md).                                                                                                                  |
| keywords          | Нет          | Любые [keywords](https://docs.exoclick.com/advertisers/ru/kampanii/sozdanie-kampanii/create-campaign-step3.md#keywords) связанные с трафиком, которые могут соответствовать конкретному типу рекламы. Если ключевых слов нет, для сопоставления будет использоваться URL сайта |
| block\_ad\_types  | Нет          | Список типов рекламы, разделённых запятыми, которые нужно заблокировать для этого запроса.                                                                                                                                                                                     |
| custom\_targeting | Нет          | Пользовательские значения зоны (объект)                                                                                                                                                                                                                                        |

### zones.custom\_targeting

| Параметр | Описание                                                                                                       |
| -------- | -------------------------------------------------------------------------------------------------------------- |
| ex\_av   | Здесь должно быть **0** если не определено, **1** если возраст подтверждён и **2** если возраст не подтверждён |

## Пример

Можно запросить множество рекламных зон одним запросом. У каждой зоны будет свой ID, как вы можете увидеть в примере ниже.

```json
{
  "user": {
    "id": "abdef8u9",
    "ip": "10.42.0.1",
    "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
    "language": "en-US",
    "referer": "https://blabla.com",
    "gdpr": {
      "gdpr": 1,
      "consent": "CPAoZRHPArq3hBcADBENBJCgAAAAAAAAAAqIHKQAAOUgAAAA"
    }
  },
  "zones": [
    {
      "id": 4031007,
      "sub": 111,
      "keywords": "humour, general"
    },
    {
      "id": 4031015,
      "sub": 222
    },
    {
      "id": 4031019,
      "sub": 222
    }
  ]
}
```


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.exoclick.com/api/ru/api-razmesheniya-reklamy/ad-plac-request.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
