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

Стартовая настройка аккаунта

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

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

  1. Добавьте пользователя с типом «рекламодатель».

    Пользователь с типом «рекламодатель» необходим для создания рекламных кампаний.

    Тот логин рекламодателя, который приписан к кампании, получает доступ к отчетам по открутке кампании.

    Если не планируется выдавать рекламодателям или агентствам доступ к рекламным кампаниям в Adfox, то необходимо создать одного пользователя с типом «рекламодатель» и присваивать его логин к рекламным кампаниям без выдачи логина и пароля клиентам.

    Пример запроса на добавление пользователя с типом «рекламодатель»:

    https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=advertiser
    
  2. Добавьте типы баннеров.

    Для каждой области на сайте (площадки), где будет размещаться рекламный баннер, создайте отдельный тип баннера.

    Каждый тип баннера содержит список шаблонов баннеров. Шаблон баннера — это код баннера с набором переменных, который отвечает за внешний вид баннера и его функциональность на сайте. Управлять шаблонами можно только через веб-интерфейс системы.

    Тип баннера определяет, на каких площадках может быть размещен баннер.

    Связь работает следующим образом:

    • При создании площадки указывается ее тип баннера.
    • При создании баннеров в рекламных кампаниях необходимо выбрать тип баннера. Баннер сможет разместиться только на тех площадках, которые имеют этот же тип баннера.
    • Код вставки, который устанавливается на сайт, также содержит информацию о типе баннера площадки и для показа по этому коду будут выбраны только баннеры, размещенные на данной площадке, то есть имеющие тот же тип баннера, что и площадка.

    Пример запроса на добавление типа баннера:

    https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=bannerType&name=topline&presentationTypeID=4
    
  3. Добавьте структуру сайта.

    В интерфейсе Adfox предусмотрена трехуровневая структура для добавления сайта:

    • первый уровень — название сайта.
    • второй уровень — разделы сайта, обычно представляющие собой отдельные пункты меню сайта. Разделы сайта могут быть выделены по маске URL, например: раздел «Новости»: http://example.com/news, раздел «Автомобили»: http://example.com/auto, раздел «Бизнес»: http://example.com/business. При необходимости выделить разделы сайта другим способом, обращайтесь в службу техподдержки.
    • третий уровень — площадки.

    Пример запроса добавления сайта:

    https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=website&name=site.ru
    

    Пример запроса добавления раздела:

    https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=zone&name=news&siteID=39939
    

    Пример запроса на добавление площадки:

    https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=place&name=site.ru&siteID=39939&zoneID=84438&bannerTypeID=22&positionID=2
    
  4. Получите код вставки для установки на сайт.

    Подробнее о типах кодов.

    Пример запроса на получение кода вставки:

    https://adfox.yandex.ru/api/v1?object=placement&action=info&mode=website&websiteID=3453&bannerTypeID=123&positionID=3
    

Основные действия в аккаунте

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