Быстрый старт
Стартовая настройка аккаунта
Стартовая настройка аккаунта может быть произведена как с помощью веб-интерфейса, так и через API.
При настройке аккаунта посредством API выполните действия:
-
Добавьте пользователя с типом «рекламодатель».
Пользователь с типом «рекламодатель» необходим для создания рекламных кампаний.
Тот логин рекламодателя, который приписан к кампании, получает доступ к отчетам по открутке кампании.
Если не планируется выдавать рекламодателям или агентствам доступ к рекламным кампаниям в 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
-
Для каждой области на сайте (площадки), где будет размещаться рекламный баннер, создайте отдельный тип баннера.
Каждый тип баннера содержит список шаблонов баннеров. Шаблон баннера — это код баннера с набором переменных, который отвечает за внешний вид баннера и его функциональность на сайте. Управлять шаблонами можно только через веб-интерфейс системы.
Тип баннера определяет, на каких площадках может быть размещен баннер.
Связь работает следующим образом:
- При создании площадки указывается ее тип баннера.
- При создании баннеров в рекламных кампаниях необходимо выбрать тип баннера. Баннер сможет разместиться только на тех площадках, которые имеют этот же тип баннера.
- Код вставки, который устанавливается на сайт, также содержит информацию о типе баннера площадки и для показа по этому коду будут выбраны только баннеры, размещенные на данной площадке, то есть имеющие тот же тип баннера, что и площадка.
Пример запроса на добавление типа баннера:
https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=account&action=add&actionObject=bannerType&name=topline&presentationTypeID=4
-
В интерфейсе 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
-
Получите код вставки для установки на сайт.
Подробнее о типах кодов.
Пример запроса на получение кода вставки:
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
Основные действия в аккаунте
Когда аккаунт настроен, можно производить основные действия по работе с рекламными кампаниями:
- Добавлять и редактировать рекламные кампании.
- Добавлять и редактировать баннеры.
- Настраивать таргетирование:
- баннера (banner-target);
- размещения кампании на сайте (campaign-targetWebsite), разделе (campaign-targetZone) или площадке (campaign-targetPlace);
- рекламной кампании (campaign-target);
- Формировать отчеты.