Алгоритм бота

Какую цену ставит бот и когда проверяет снова

Без чёрного ящика: что происходит на каждой проверке, как учитываются бонусы Kaspi Gold и пороги доставки, как складывается интервал проверки и когда помогает ночной подъём.

Принцип

Решаете вы, Jebe исполняет

Границы цены, канал (Турбо, Обычная или XML), города и то, можно ли тратить лимит Kaspi на добор, выбираете вы. Jebe не решает за вас, каким позициям нужен турбо, и сам не переставляет их между полосами: кончились места турбо — позиция ждёт, а не уезжает в другую полосу. Чужие для бота товары в режиме API он не трогает. Всё ниже — о том, как он исполняет ваш выбор.

Единица работы

Позиция — товар в одном городе

Своя цена в каждом городе без абонентской платы за регион
В каждом городе у товара свои конкуренты, свой остаток и свои границы цены — бот ничего не усредняет. Все города Казахстана открыты сразу, докупать города отдельно не нужно.
Место тратится только там, где включён демпинг
Если товар продаётся на Kaspi в 10 городах, но демпинг вы включили только в двух — он занимает 2 позиции, а в остальных 8 городах продаётся по вашей обычной цене и мест в тарифе не занимает. Если нужно вести 100 товаров во всех 10 городах — это 1 000 позиций (14 990 ₸ в XML).
Кончился остаток — место сразу свободно
Позиция занимает место только тогда, когда у неё включён демпинг, заданы минимальная и максимальная цена и есть остаток в этом городе. Как только остаток дошёл до нуля, слот автоматически освобождается для другого товара.

Одна проверка

Что бот делает за один цикл

  1. 01Свежие цены конкурентов по товару в этом городе. Jebe собирает их с Kaspi сам; данные старше 90 минут бот не использует.
  2. 02Фильтры. Из списка уходят конкуренты, которых вы исключили: Express, самовывоз, межгород, низкий рейтинг, долгий предзаказ, доставка дольше вашей на заданное число дней и магазины из вашего списка исключений.
  3. 03Учёт бонусов Kaspi Gold (если включено «Учитывать бонусы»). Бот переводит цены конкурентов и вашу цену в фактическую цену для покупателя за вычетом бонуса Kaspi Gold.
  4. 04Лидер — самый дешёвый из оставшихся конкурентов.
  5. 05Новая цена по правилу ниже, с вашим шагом и переключателями «Снижение» и «Повышение» (при включённом учёте бонусов эффективная цена переводится обратно в витринную с защитой порога 5 000 ₸).
  6. 06Границы и пороги доставки. Цена не выходит за ваш минимум и максимум, а с «Автообходом доставки» уходит из убыточных зон у порогов 1 000, 3 000, 5 000 и 10 000 ₸.
  7. 07Отправка. Через API — сразу в очередь (в пределах 250 обновлений за 30 минут). Через XML — следующим файлом (или сразу через свободный API, если включён добор).
  8. 08Следующая проверка — через адаптивный интервал, который бот рассчитывает для этой позиции.

Правило цены

Какую цену ставит бот

Ситуация в городеЧто делает бот
Вы дороже лидераЦена на шаг ниже лидера. Нужно «Снижение».
Вы дешевле всехЦена поднимается до шага под 2-м местом. Нужно «Повышение».
Конкурентов в городе нетВаша максимальная цена. Нужно «Повышение».
Включено «Учитывать бонусы»Сравнение и шаг идут по ценам за вычетом бонуса Kaspi Gold (с учётом чужого и вашего бонуса).
Включён «Автообход доставки»Попав в невыгодную зону за порогом 1 000, 3 000, 5 000 или 10 000 ₸, цена сдвигается к 999 / 2 999 / 4 999 / 9 999 ₸ (если позволяет минимум) или за конец зоны.
Включено «Быть 2-м»Цена держится на шаг выше лидера, а не ниже — без бесконечной ценовой войны с другим ботом.
Нужная цена ниже минимумаБот держит минимум. Ниже он не опускается никогда.
Нужная цена выше максимумаБот держит максимум.
Текущая цена вне ваших границБот возвращает её в границы.
Нет свежих данных о конкурентахЦену не трогает, пока сбор не восстановится.

Подробный разбор учёта бонусов Kaspi Gold, таблицы порогов доставки и фильтров конкурентов — на странице «Защита чистой прибыли».

Интервал проверки

Когда бот проверит позицию снова

Скорость задаёт полоса: Турбо — от 20 секунд до 1 минуты, Обычная — от 1 до 15 минут, XML — раз в 15 минут (раз в час, если цена упёрлась в границу, см. «Особые случаи»). У Турбо и Обычной это диапазон, а не расписание: точное число бот выбирает сам, для каждой позиции и на каждой проверке, по двум вещам:

Как часто меняется цена
Проверка, которая нашла повод сменить цену, сразу ускоряет позицию: её «нужность» поднимается на полпути к максимуму. Проверка без изменений замедляет: нужность падает на 20%. Новая позиция начинает с самой частой проверки.
Сколько осталось лимита Kaspi
Чем меньше осталось из 250 обновлений в текущем окне, тем сильнее замедляются спокойные позиции. Позиции, где цена меняется постоянно, держат скорость дольше всех.

Пример: обычная полоса

  • Цена менялась на каждой проверке, или позиция только включенаЛимит свободен1 минПоловина лимита1 мин
  • Три смены цены подряд после тишиныЛимит свободен2 мин 45 сПоловина лимита3 мин 37 с
  • Две смены подряд после тишиныЛимит свободен4 мин 30 сПоловина лимита6 мин 15 с
  • Одна смена после тишиныЛимит свободен8 минПоловина лимита11 мин 30 с
  • Десять проверок без измененийЛимит свободен≈ 13,5 минПоловина лимита15 мин
  • Давно без измененийЛимит свободен15 минПоловина лимита15 мин

В турбо всё так же, только в пределах 20–60 секунд: например, одна смена цены после тишины — 40 секунд. Сколько мест вы купили, на интервал не влияет.

Особые случаи

Цена упёрлась в границу
Лидер ниже минимума или нужная цена выше максимума — реагировать не на что. Проверка реже: турбо раз в 15 минут, обычная раз в 30, XML раз в час. Как только упора нет, позиция возвращается к своей скорости.
Лимит Kaspi кончился
До нового окна все позиции идут по верхней границе полосы: турбо раз в минуту, обычная раз в 15 минут. Новые цены ждут, когда Kaspi снова начнёт принимать обновления.
Ночное окно
С включённым ночным подъёмом позиции магазина с 02:00 до 06:00 не проверяются вовсе — подробно ниже.

Как Jebe расходует 250 обновлений за 30 минут — на странице о лимите Kaspi.

XML

Фиксированные 15 минут и отправка файлом

API и XML — два способа доставить цену в Kaspi, и скорость следует из способа, а не из тарифа. API быстрый, но ограничен лимитом Kaspi; XML несёт любой объём, но Kaspi принимает файл не чаще раза в 15 минут:

  • Как часто проверяетсяAPI:От 1 до 15 минут (в Турбо 20–60 сек) — бот подстраивает сам: чаще там, где цена меняетсяXML:Раз в 15 минут, у всех позиций одинаково. Реже: раз в час, если цена упёрлась в границу, и ночью при включённом ночном подъёме
  • Что значат 15 минутAPI:Потолок: так редко проверяются только позиции, где давно тихоXML:Фиксированный шаг проверки
  • Когда новая цена в KaspiAPI:Сразу после проверки, если не кончился лимит KaspiXML:Со следующим файлом (15–50 минут разбора на стороне Kaspi). С добором через API срочные цены уходят сразу
  • Лимит Kaspi 250 / 30 минAPI:ТратитXML:Файл не тратит; добор через API использует только свободный остаток квоты
  • ОбъёмAPI:До 150 местXML:От 200 позиций до безлимита
Проверка
Позиции в XML проверяются раз в 15 минут по тем же правилам цены, фильтров, бонусов и порогов доставки. Реже бывает в двух случаях: цена упёрлась в ваш минимум или максимум (тогда раз в час, пока упор не исчезнет) и ночное окно при включённом ночном подъёме (с 02:00 до 06:00 проверок нет).
Отправка и сборка файла
Файл собирается в момент отправки (не чаще раза в 15 минут, когда Kaspi закончил разбирать предыдущий файл). В Kaspi уходят самые свежие цены и остатки на эту минуту.
Бесплатный добор через API
Если включить «Добирать через API, пока Kaspi занят файлом», Jebe каждые две минуты проверяет свободный остаток вашего лимита Kaspi (250 обновлений) и сразу отправляет через API карточки, где изменилось больше всего позиций. Покупать тариф API для этого не нужно.
Синхронизация новинок
Поскольку XML-файл задаёт весь прайс магазина, перед каждой отправкой файла Jebe сверяет с Kaspi число товаров и список точек и, если вы добавили товар или вернули карточку из архива, сам запускает синхронизацию. Чтобы не ждать следующего файла, можно нажать «Синхронизировать» сразу.

Ночной подъём

Помогает в дуэли двух ботов

02:00
Цены магазина разово поднимаются на 20%, но не выше максимума каждой позиции.
02:00 – 06:00
Бот позиции магазина не пересчитывает: цена стоит поднятой.
05:40 – 05:55
Сбор цен конкурентов просыпается постепенно, чтобы к 06:00 данные были свежими.
06:00
В течение пяти минут все позиции пересчитываются по обычному правилу.

Когда помогает

На позиции вы и ещё один бот с автоповышением. Он видит, что вы подорожали, и поднимается до шага под вами. В 06:00 вы снова встаёте на шаг ниже него — но уже с более высокой цены.

Когда почти не помогает

Есть третий продавец, который цену не поднимает. Второй бот поднимется только до шага под ним, а в 06:00 ваша цена вернётся туда же, где была. Пока идёт окно, вы дороже лидера, и ночные покупатели первым видят его.

Ночной подъём включён по умолчанию и действует на весь магазин. Выключается в карточке магазина: «Расширенные настройки» → «Бот» → «Поднимать цены ночью».

Без изменений

Когда бот сознательно ничего не делает

Позиция не готова
Нет минимальной или максимальной цены, нет остатка, выключен демпинг. Причину покажет статус в таблице, и место в тарифе такая позиция не занимает.
Данные старше 90 минут
Бот не ставит цену вслепую и ждёт свежего сбора цен конкурентов.
Цена уже на границе
Лидер ниже вашего минимума — бот держит минимум. Вы дешевле всех и стоите на максимуме — выше некуда.
Направление выключено
Без «Снижения» бот не опускает цену, без «Повышения» — не поднимает.
Ночное окно
С 02:00 до 06:00, если включён ночной подъём.

Ответы на частые вопросы — в инструкции «Как работает бот», цены и места — в тарифах.

Посмотрите свои цены по городам — на своём каталоге

7 дней полного доступа: 150 мест в API и 20 турбо. Товары и остатки подтянутся из Каспи сами.

Подключить магазинСпросить в WhatsApp

Без привязки карты. Отключается в один клик.