AdPump — Keywords, Bids и KeywordBids в API Яндекс Директа

Keywords, Bids и KeywordBids — управление ключевыми фразами и ставками через API v5.

Коротко: keywords, bids, keywordbids.

← Каталог API Директа · Введение · Версии API · OAuth и доступ · Сервисы v5 · Лимиты и баллы · Ограничения · Кампании · Группы и объявления · Минус-фразы и площадки · Отчёты · Песочница · Агентства · Примеры JSON · Ошибки · Автоматизация · Документация Яндекса

Содержание

keywords
bids
keywordbids
bidmodifiers
Советы

keywords — ключевые фразы

{

  "method": "add",

  "params": {

    "Keywords": [

      {"AdGroupId": 200001, "Keyword": "доставка цветов москва", "Bid": 15000000},

      {"AdGroupId": 200001, "Keyword": "!купить розы", "Bid": 12000000},

      {"AdGroupId": 200001, "Keyword": ""букет роз"", "Bid": 10000000}

    ]

  }

}

Операторы: ! — фиксированная фраза, "..." — фразовое совпадение. Ставка в микрорублях. До 1000 фраз в одном add.

bids — ставки на уровне группы

{"method":"set","params":{"Bids":[{"CampaignId":123,"AdGroupId":200001,"Bid":8000000}]}}

Устанавливает базовую ставку для всех ключей группы. bids.setAuto — автоставка.

keywordbids — точечные ставки

{"method":"set","params":{"KeywordBids":[{"KeywordId":300001,"Bid":20000000,"ContextBid":5000000}]}}

Для точечной настройки по каждому KeywordId. Bid — поиск, ContextBid — РСЯ.

bidmodifiers — корректировки

Тип	Type	Применение
Демография	DEMOGRAPHICS_ADJUSTMENT	Пол, возраст
Устройства	MOBILE_ADJUSTMENT	Мобильные
Площадки РСЯ	PLACEMENT	Исключение площадок
Регион	REGIONAL_ADJUSTMENT	Корректировка по региону

Метод BidModifiers.toggle устарел — используйте set / delete. Чистка площадок: Минус-фразы и площадки.

Советы по ставкам

Перед массовым изменением ставок — keywordbids.get для текущих значений.
Автостратегии настраиваются на уровне кампании (campaigns.add).
Для автоправил ставок используйте отчёты + keywordbids.set по cron.

Перейти в инструмент