---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.1
alternate:
  - https://yandex.com/dev/adfox/doc/en/v.1/description.md
  - https://yandex.com/dev/adfox/doc/ru/v.1/description.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/adfox/doc/ru/llms.txt

# Быстрый старт

## Стартовая настройка аккаунта {#start-min}

Стартовая настройка аккаунта может быть произведена как с помощью веб-интерфейса, так и через API.

При настройке аккаунта посредством API выполните действия:

1. [Добавьте пользователя с типом «рекламодатель»](https://yandex.com/dev/adfox/doc/ru/v.1/account/account-add-advertiser.md).
       
   Пользователь с типом «рекламодатель» необходим для создания рекламных кампаний.
   
   Тот логин рекламодателя, который приписан к кампании, получает доступ к отчетам по открутке кампании.
   
   Если не планируется выдавать рекламодателям или агентствам доступ к рекламным кампаниям в Adfox, то необходимо создать одного пользователя с типом «рекламодатель» и присваивать его логин к рекламным кампаниям без выдачи логина и пароля клиентам.
   
   Пример запроса на добавление пользователя с типом «рекламодатель»:
   
   ```css
   https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=advertiser
   ```

1. [Добавьте типы баннеров](https://yandex.com/dev/adfox/doc/ru/v.1/account/account-add-bannerType.md).
   
   Для каждой области на сайте (площадки), где будет размещаться рекламный баннер, создайте отдельный тип баннера.
   
   Каждый тип баннера содержит список шаблонов баннеров. Шаблон баннера — это код баннера с набором переменных, который отвечает за внешний вид баннера и его функциональность на сайте. Управлять шаблонами можно только через веб-интерфейс системы.
   
   Тип баннера определяет, на каких площадках может быть размещен баннер.
   
   Связь работает следующим образом:
   
   - При создании площадки указывается ее тип баннера.
   - При создании баннеров в рекламных кампаниях необходимо выбрать тип баннера. Баннер сможет разместиться только на тех площадках, которые имеют этот же тип баннера.
   - Код вставки, который устанавливается на сайт, также содержит информацию о типе баннера площадки и для показа по этому коду будут выбраны только баннеры, размещенные на данной площадке, то есть имеющие тот же тип баннера, что и площадка.
   
   ![](_images/bannerType.png)
   
   Пример запроса на добавление типа баннера:
 
   ```no-highlight
   https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=bannerType&name=topline&presentationTypeID=4
   ```
    
1. [Добавьте структуру сайта](https://yandex.com/dev/adfox/doc/ru/v.1/account/account-add-website.md).
   
   В интерфейсе Adfox предусмотрена трехуровневая структура для добавления сайта:
   
   - [первый уровень](https://yandex.com/dev/adfox/doc/ru/v.1/account/account-add-website.md) — название сайта.
   - [второй уровень](https://yandex.com/dev/adfox/doc/ru/v.1/account/account-add-zone.md) — разделы сайта, обычно представляющие собой отдельные пункты меню сайта. Разделы сайта могут быть выделены по маске URL, например:
   
      - раздел «Новости»: `http://example.com/news`;
      - раздел «Автомобили»: `http://example.com/auto`;
      - раздел «Бизнес»: `http://example.com/business`.
      
      При необходимости выделить разделы сайта другим способом, обращайтесь в [службу техподдержки](https://yandex.ru/support/adfox-sites/feedback.html?lang=ru).

   - [третий уровень](https://yandex.com/dev/adfox/doc/ru/v.1/account/account-add-place.md) — площадки.
   
   Пример запроса добавления сайта:
 
   ```no-highlight
   https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=website&name=site.ru
   ```
 
   Пример запроса добавления раздела:
 
   ```no-highlight
   https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=zone&name=news&siteID=39939
   ```
 
   Пример запроса на добавление площадки:
 
   ```no-highlight
   https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=place&name=site.ru&siteID=39939&zoneID=84438&bannerTypeID=22&positionID=2
   ```

1. [Получите код вставки для установки на сайт](https://yandex.com/dev/adfox/doc/ru/v.1/placement/placement.md).
   
   Подробнее о [типах кодов](https://yandex.ru/support/adfox-sites/codes/code-loader.html?lang=ru).
   
   Пример запроса на получение кода вставки:
 
   ```
   https://adfox.yandex.ru/api/v1?object=placement&action=info&mode=website&websiteID=3453&bannerTypeID=123&positionID=3
   ```

## Основные действия в аккаунте {#start-work}

Когда аккаунт настроен, можно производить основные действия по работе с рекламными кампаниями:

- [Добавлять](https://yandex.com/dev/adfox/doc/ru/v.1/account/account-add-campaign.md) и [редактировать](https://yandex.com/dev/adfox/doc/ru/v.1/campaign/campaign-modify.md) рекламные кампании.

- [Добавлять](https://yandex.com/dev/adfox/doc/ru/v.1/account/account-add-banner.md) и [редактировать](https://yandex.com/dev/adfox/doc/ru/v.1/banner/banner-modify-banner.md) баннеры.

- Настраивать таргетирование:

  - баннера (banner-target);
  - размещения кампании на сайте (campaign-targetWebsite), разделе (campaign-targetZone) или площадке (campaign-targetPlace);
  - рекламной кампании (campaign-target).
  
- Формировать [отчеты](https://yandex.com/dev/adfox/doc/ru/statistics/about.md).