История изменений

Версия 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

Добавлено:

Версия 1.7.0 от 14.09.2017

Добавлено:

  • логическое таргетирование для баннера, кампании, размещения кампании на сайте, разделе, площадке.

  • в таргетировании баннера и кампании по возрасту для параметра ageValue добавлены значения 6 (возраст от 45 до 54) и 7 (старше 55). Значение 5 (старше 45) устарело, при его использовании автоматически будут включены значения 6 и 7.

Версия 1.6.0 от 15.08.2017

Добавлено:

Версия 1.5.0 от 22.05.2017

Добавлено:

Версия 1.4.0 от 12.04.2017

Изменено:

Версия 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

  • Добавлено получение кодов вставки.

  • Добавлено получение отчетов.

  • Отчет по площадкам: по дням.