История изменений
Версия 2.5.0 от 06.10.2023
Добавлена валидация значения для стороннего токена.
Версия 2.4.0 от 07.07.2023
Изменился способ авторизации: теперь авторизоваться в API Adfox можно с помощью OAuth-токена Яндекса.
Версия 2.3.0 от 05.07.2023
Добавлена возможность указания стороннего токена при создании или редактировании баннера.
Версия 2.2.0 от 24.11.2022
Добавлены методы API для работы с маркировкой рекламы:
-
создание, редактирование, получение списка, удаление контрагентов;
-
создание, редактирование, получение списка, удаление договоров;
-
создание, получение списка сайтов (добавлены параметры для маркировки);
-
получение списка шаблонов (добавлены параметры для маркировки);
-
создание, редактирование, получение списка кампаний (добавлены параметры для маркировки);
-
создание, редактирование, получение списка баннеров (добавлены параметры для маркировки).
Версия 2.1.0 от 15.04.2022
Изменено:
- добавлена возможность таргетирования по URL на уровне кампании, размещения кампании на сайте, разделе и площадке, а также на баннере.
Версия 2.0.0 от 02.02.2022
Изменено:
- прекращена поддержка Adfox.nets, запросы для рекламных сетей с объектами adNetwork и adNetworkWebsite больше не поддерживаются.
Версия 1.9.0 от 10.12.2021
Изменено:
-
скрыты устаревшие методы таргетирования по географии targetingGeo, рекомендуем использовать метод targetingGeobase.
-
удалили упоминание передачи
account
иpassword
в параметрах запроса после перехода на авторизацию через OAuth-токен и регистрацию пользователей через Яндекс ID, а также обязательность передачиpassword
при создании нового пользователя или изменении существующего. -
при добавлении типа баннера параметр
presentationTypeID
стал обязательным и больше не принимает на вход значение 0 (стандартный тип баннера). -
при добавлении баннера, если не указан id шаблона баннера, то в параметре
contentType
может быть передано значение толькоxml
. Остальные значения (graphics
— Графический баннер;flash
— Flash-баннер;HTML
— HTML-баннер;floatingJS
— JavaScript код (Безразмерный);floatingHTML
— HTML код (Безразмерный);floatingFlash2
— Flash без заглушки;FloatingImage
— Изображение) не поддерживаются.
Версия 1.8.0 от 23.11.2017
Добавлено:
- новый вид пользователей — ассистенты API с разным набором прав доступа к методам API.
Версия 1.7.0 от 14.09.2017
Добавлено:
-
логическое таргетирование для баннера, кампании, размещения кампании на сайте, разделе, площадке.
-
в таргетировании баннера и кампании по возрасту для параметра
ageValue
добавлены значения 6 (возраст от 45 до 54) и 7 (старше 55). Значение 5 (старше 45) устарело, при его использовании автоматически будут включены значения 6 и 7.
Версия 1.6.0 от 15.08.2017
Добавлено:
- возможность устанавливать и редактировать параметры «тип кода» (pct) и «ограничение по частоте показов» (plp, pli, pop) для площадки.
Версия 1.5.0 от 22.05.2017
Добавлено:
-
новый метод получения данных о шаблоне.
-
редактирование параметра CPM для кампаний с видом «Динамическая монетизация».
Версия 1.4.0 от 12.04.2017
Изменено:
-
добавлено описание ошибок при загрузке .zip-архивов в параметры баннера.
-
добавлено значение
1001
- "Видимый показ" для параметраimpressionMethodID
при добавлении кампании. -
исправлено описание указания версии при формировании запроса API.
-
добавлен новый метод клонирования баннеров.
Версия 1.3.0 от 24.12.2016
Изменено:
- метод code не поддерживается, используйте метод placement для получения кода вставки.
Версия 1.2.0 от 05.08.2016
Добавлено:
- параметр showMode для account-list-campaign-show=targetingUser. Позволяет вывести список разрешенных и/или запрещенных значений пользовательской характеристики.
Версия 1.1.0 от 18.07.2016
Добавлено:
- параметр resetProfile для установки режима «только чтение» в таргетировании по географии для campaign и banner.
Версия 1.0.5 от 01.06.2016
Исправлено по тексту документации:
- для настройки таргетирования targetingUser — v{id значения характеристики}, где id указывается без фигурных скобок, например: v534.
Версия 1.0.4 от 26.05.2016
Добавлено:
- получение сводной информации для кампании по таргетированию по географии.
Версия 1.0.3 от 25.05.2016
Добавлено:
-
получение справочника по географии NEW;
-
настройка таргетирования по географии NEW на уровне campaign и banner;
-
получение сводной информации по объектам, старгетированным по географии NEW;
-
получение сводной информации по таргетированию у конкретной РК.
Версия 1.0.2 от 26.10.15
Добавлено:
- возможность просмотра настроек таргетирования на уровне кампании по targetingGender, targetingAge, targetingRevenue.
Версия 1.0.1 от 28.03.2015
Добавлено таргетирование на уровне кампании:
Добавлено таргетирование на уровне баннера:
Исправлено по тексту документации:
-
примечание о формате записи даты и времени.
-
описание про передачу параметров в xml файле.
Версия 0.0.13.3 и Версия 1.0.0 от 27.03.2015
Разработана новая версия 1.0.0 с хостом запроса https://api.adfox.ru/v1/API.php?.
В версии 1.0.0 добавлена новая возможность пагинации.
Версия 0.0.13.3 от 21.06.2014
Добавлено:
-
получение справочников:
- по браузерам;
- по производителям мобильных устройств;
- по операторам сотовых сетей;
- по операционным системам;
- по отраслям.
Версия 0.0.13.2 от 19.06.2014
В связи с усилением требований безопасности паролей, Adfox вводит изменения в процедуру авторизации через API. Пароль в открытом виде можно передавать до 14-00 24.06.2014, после 14-00 все запросы по API будут проходить авторизацию корректно, только если пароль передан в закрытом виде с использованием функции хэш sha256 от пароля.
Версия 0.0.13.1 от 28.04.2014
Добавлено таргетирование на уровне баннера:
Версия 0.0.13 от 22.04.2014
Добавлено таргетирование по полу и возрасту на уровне кампании.
Версия 0.0.12 от 25.03.2014
-
Добавлена возможность просмотра сводной информации по таргетированию на уровне кампании и баннера.
-
Добавлено значение short для параметра show (просмотр списка кампаний, суперкампаний, баннеров).
Версия 0.0.11 от 11.03.2014
Добавлено усиление сложности пароля при создании пользователей и смене паролей.
Версия 0.0.10 от 20.12.2013
-
Добавлена возможность дополнительного таргетирования на уровне баннера.
-
Добавлена возможность в рекламных сетях включения и выключения шаблона referer по URL.
-
Добавлена возможность таргетирования по географии на уровне баннера.
Версия 0.0.9.5 от 01.10.2013
-
Выключены типы баннеров PopUp и PopUnder.
-
Доступ к API Adfox разрешен только по протоколу https. При запросе по http вернется ошибка -999.
Версия 0.0.9.4 от 29.04.2013
Добавлена возможность указания ссылки на промерочный пиксель
Версия 0.0.9.3 о 15.03.2013
Добавлено переопределение метода ротации на уровне размещения.
Версия 0.0.9.2 от 20.02.2013
Добавлено таргетирование по ключевым словам/фразам.
Версия 0.0.9.1 от 31.01.2013
При modify кампании/флайта параметр priority необязателен.
Версия 0.0.9 от 16.01.2013
-
Получение геобазы для работы с API.
-
Указание метода ротации (по приоритетности (уровень, приоритет), по % от трафика (% трафика)) для кампании/флайта. При modify кампании/флайта параметр priority стал обязательным.
-
Пользовательское таргетирование.
-
Переопределение таргетирования на уровне размещения (сайта, раздела, площадки).
Версия 0.0.8 от 28.12.2012
Добавление/редактирование отрасли для кампании/флайта.
Версия 0.0.7 от 14.08.2012
Добавлено описание поля impressionsMethodID (Методика подсчета показов) для вызовов account-add-campaign и account-add-supercampaign.
Версия 0.0.6 от 23.04.2012
-
Добавлен вызов account-list-bannerPlaceReport — выгрузка данных по кампаниям/баннерам/площадкам за день.
-
Информация по установке пользовательского таргетирования для кампании.
-
Добавлен параметр encoding.
-
Добавлены вызовы для установки дополнительных ассистентов и рекламодателей.
-
Добавлен вызов advertiser-availableReports, поле availableReports в вызов account-list-advertiser; добавлено автоматическое продление для полей impressionsSmoothTypeID и clicksSmoothTypeID.
-
Исправлена ошибка в pricingModel.
-
В суперкампании, флайты и кампании добавлены поля pricingModel, itemCost и itemQty.
-
Добавлены вызовы: account-add-superCampaign, account-list-superCampaign, account-delete-superCampaign, superCampaign-modify, account-list-activeBanners. Модифицированы вызовы: account-add-campaign, account-list-campaign, campaign-modify.
-
Добавлен вызов account-list-tracingPoint2.
-
Модифицированы вызовы: account-user-userCriterias, userCriteria-modify, campaign-target-targetingTime, campaign-placing-website, campaign-placing-zone, campaign-placing-place и campaign-info-placement2.
-
Добавлены вызовы по пользовательскому таргетингу.
-
Добавлен вывод настроек таргетирования; откорректированы: правка настроек гео-таргетирования, вывод настроек кампании и баннера.
-
Добавлено описание вызова таргетирования по ключевым словам, уточнено описание вызовов работы с категориями.
Версия 0.0.5 от 27.05.2011
-
Добавлено описание вызовов таргетирования по времени, частоте, поведению и географии.
-
Для кампаний добавлены поля impressionsSmoothTypeID и clicksSmoothTypeID.
-
Добавлен параметр campaignID для команды account-list-tracingPoint.
-
Список доступных шаблонов для типа баннера и точки учета действий.
-
Баннер по умолчанию для площадок.
-
Отчет показы/переходы по дням по активным кампаниям за период.
-
Листинг списка разделов, с фильтрацией по сайту.
Версия 0.0.4 от 26.07.2010
-
Получение отчета за сутки: все баннеры на всех площадках.
-
Изменение шаблонов страниц у разделов.
-
Обновлена информация о полях imageURL и getURL в добавлении баннеров.
-
Получение списка системных площадок для типов баннеров у сайтов рекламных сетей.
-
Отчет по сайту рекламной сети: по часам за сутки.
-
Отчет по кампании по часам за указанную дату.
-
Получение кода вставки с типом кода.
-
Удаление площадок.
-
Шаблон запроса.
-
Отчет по показам, переходам на всех площадках.
Версия 0.0.3 от 29.01.2010
-
Добавлено получение кодов вставки.
-
Добавлено получение отчетов.
-
Отчет по площадкам: по дням.