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

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

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

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

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

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

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

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

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

    https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=account&action=add&actionObject=advertiser&account=otrpc&password=7ykzjhsgdv8768sdhfgjsgf6s75fyusjhfgkwj3lkjl&eMail=pochta@yandex.ru&company=otrpc&phone=84996357636
  2. Добавьте типы баннеров.

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

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

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

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

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

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

    https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&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. При необходимости выделить разделы сайта другим способом, обращайтесь в службу техподдержки.
    • третий уровень — площадки.
    Примечание.

    В документе по умолчанию рассматривается вариант настройки аккаунта для продукта ADFOX.Sites.

    Настройка аккаунта для продукта ADFOX.Nets отличается тем, что вместо структуры сайта добавляется структура рекламной сети:

    • первый уровень — рекламная сети;
    • второй уровень — категория рекламной сети;
    • третий уровень — сайт рекламной сети.

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

    https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=account&action=add&actionObject=website&name=site.ru

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

    https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=account&action=add&actionObject=zone&name=news&siteID=39939

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

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

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

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

    https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=placement&action=info&mode=website&websiteID=3453&bannerTypeID=123&positionID=3

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

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