API для разработчиков
С помощью API платформы можно автоматизировать все функции, которые доступны в панели администратора.
1. Что могут автоматизировать рекламодатели?
Кампании/группы, вариации, офферы и рекламные форматы
Таргетинг/блокировка параметров таргетинга, категорий
Цели
Получение статистики, включая данные пользователей adblock
Дневной бюджет, пополнение счёта, способы оплаты
Название лендинга, URL и алгоритм распределения трафика
2. Что могут автоматизировать паблишеры?
Рекламные форматы и рекламные зоны
Сайты, проверки URL
Блокировка типов рекламы и категорий продуктов
Получение всей статистики, включая данные пользователей adblock
Ставки по рекламному формату/GEO, модели ценообразования
Способы оплаты
3. Как использовать API
Интерфейс API быстрый и удобный в использовании
Просто выберите параметр и нажмите кнопку Попробовать «Попробовать» для автоматической генерации кода
Как использовать API платформы
Мы только что обновили API нашей платформы до версии 2. Эта последняя версия позволяет вам автоматизировать абсолютно все функции внутри панели администратора. Вы можете использовать API для простых процессов, например автоматизации повторяющихся задач, чтобы сэкономить время, а также для более сложных проектов, например изменения креативов баннеров на лету.
Функции
И у паблишеров, и у рекламодателей доступен огромный набор функций. Ниже приведено краткое описание того, что можно автоматизировать:
Рекламодатели
Отдельные/групповые кампании, вариации, офферы, рекламные форматы.
Таргетинг/блокировка параметров таргетинга, категорий, разделение по времени суток.
Цели.
Получение статистики, включая данные пользователей adblock.
Дневной бюджет, пополнение счёта, способы оплаты.
Название лендинга, URL и алгоритм распределения трафика.
Паблишеры
Рекламные форматы и рекламные зоны.
Сайты, проверки URL.
Блокировка типов рекламы и категорий продуктов.
Получение всей статистики, включая данные пользователей adblock.
Ставки по рекламному формату/GEO, модели ценообразования.
Способы оплаты.
Перед началом
Интерфейс API показывает список названий групп. Нажмите на группу, и раскроются все доступные параметры.
HTTP-методы
API поддерживает следующий набор HTTP-методов. Обратите внимание, что не все функции поддерживают все методы.
Давайте начнём!
Настройка
Чтобы получить доступ к защищённым API-запросам, должен быть установлен Session Token. Чтобы создать токен, у вас должен быть действующий аккаунт.
Создание API-токена доступно в вашем Мой профиль меню. Выберите API-токены.
Нажмите на Новый API-токен.
Введите имя токена; в этом руководстве мы назвали наш «testToken», затем нажмите Сохранить.
Идентификатор токена создан.
Вход в API
В интерфейсе API нажмите на Вход кнопку в правом верхнем углу экрана и введите имя пользователя и пароль либо предоставьте API-токен. Нажмите Отправить и в API будет отправлен запрос на вход для получения действительного session token. Затем этот токен будет использоваться для подтверждения всех API-запросов, которые вы захотите сделать в течение сессии.
Как отправить запрос в API
Давайте рассмотрим пример группы Campaigns: нажмите на неё, и группа раскроется, показывая доступные запросы:
Нажмите на запрос, который вы хотите автоматизировать; в этом примере мы запросим данные для CID 1923724, используя:
Нажмите на Получить кампанию после чего окно раскроется. Введите номер ID кампании в поле:
Затем нажмите на Попробовать сейчас кнопку. Тело ответа автоматически сгенерирует код.
Код ответа 200 означает, что всё в порядке и можно использовать.
Как приостановить кампанию
Вот ещё один пример. Сначала выберите нужную функцию из группы Campaigns:
Нажмите на Приостановить для одной или нескольких кампаний. После открытия нажмите Example Value, затем нажмите на жёлтое поле — это автоматически вставит JSON-структуру в поле body.
Теперь текущее значение равно нулю, поэтому замените ноль на CID, который вы хотите поставить на паузу. Затем нажмите Попробовать кнопку, чтобы сгенерировать нужный код.
Как обновить цену кампании
Выберите правильную функцию:
Нажмите на Обновить кампанию, чтобы открыть окно. Добавьте CID в поле ID кампании, затем нажмите Example Value, нажмите на жёлтое поле, которое скопирует JSON-структуру в поле body.
Этот код содержит несколько разных функций, но нам нужен код цены кампании, поэтому удалите ненужную часть кода, оставив в поле код цены кампании, как показано ниже:
Теперь нам нужно изменить два значения в поле body: model (ниже приведён список значений, соответствующих модели ценообразования).
Мы оставим CPC, поэтому оставим model равным 1
Теперь нам нужно изменить цену с нуля на нужную нам. Мы изменим её на 200, что означает, что новая цена будет 200 центов или два евро.
Затем просто нажмите Попробовать кнопку, чтобы сгенерировать код. Легко!
Как видите, API наполнен функциями для автоматизации; единственный предел — это ваше воображение, чтобы раскрыть силу автоматизации.
И наконец, обязательно подпишитесь на нашу API-рассылку, которую вы найдёте внизу интерфейса API, чтобы получать последние новости и обновления.
Это было полезно?