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