item_idsОбязательныйbody · строка
ID элемента(ов), разделённые запятыми; обычно используйте schema=0 для одного элемента и schema=3 для нескольких элементов
POSTЦена уточняется
Получить оценку эффективности продвижения
Получить расчётные результаты показа DOU+
Конечная точка
POST https://getvibeapi.com/v1/social/douyin/douplus/fetch_delivery_effect_estimateПример
curl -sS "https://getvibeapi.com/v1/social/douyin/douplus/fetch_delivery_effect_estimate" \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"item_ids":"value"}'Передавайте свой ключ в заголовке Authorization: Bearer. Вы платите только за запросы, которые принимает поставщик данных. Отклоненные им запросы (ошибки, тайм-ауты, недопустимые параметры) не тарифицируются. Действительный запрос, который возвращает от платформы пустой результат или результат «не найдено», тарифицируется.
Параметры
external_actionbody · целое число
Код действия оптимизации; должен соответствовать target_id, значение по умолчанию — 44 (NativeAction). Распространённые значения: 45=отметка «Нравится», 46=подписка, 47=комментарий, 51=переход по ссылке, 102=несколько нативных действий, 181=посещение главной страницы
target_idbody · целое число
Идентификатор цели продвижения, по умолчанию 31 (лайки и комментарии). Распространённые значения: 32 = подписчики, 33 = посещения главной страницы, 37 = просмотры видео, 40 = популярность трансляции, 45 = клики по ссылке в комментарии, 63 = показ подписчикам, 78 = естественное продвижение, 81 = высокая частота взаимодействия
schemabody · целое число
Схема размещения: 0=одиночный элемент по умолчанию, 3=многоэлементная BatchDelivery; официальный клиент выбирает её на основе количества элементов
is_max_cvbody · логическое значение
Оценивать ли в режиме MaxCV (maximum-conversion-volume); официальный клиент выводит это значение на основе целевых возможностей, количества элементов, бюджета и состояния ручной ставки, значение по умолчанию — true
pay_typebody · целое число
Канал оплаты: 0=CashDesk, 1=IAP, 2=Caijing, 3=CgTradeCash; официальный запрос оценки использует 1
cost_intbody · целое число
Бюджет размещения в li (CNY 1/1000), по умолчанию 30000 (CNY 30)
duration_secondsbody · целое число
Продолжительность размещения в секундах, по умолчанию 21600 (6 часов)
| Название | В | Тип | Обязательный | Описание |
|---|---|---|---|---|
| item_ids | body | string | Да | ID элемента(ов), разделённые запятыми; обычно используйте schema=0 для одного элемента и schema=3 для нескольких элементов |
| external_action | body | integer | Нет | Код действия оптимизации; должен соответствовать target_id, значение по умолчанию — 44 (NativeAction). Распространённые значения: 45=отметка «Нравится», 46=подписка, 47=комментарий, 51=переход по ссылке, 102=несколько нативных действий, 181=посещение главной страницы |
| target_id | body | integer | Нет | Идентификатор цели продвижения, по умолчанию 31 (лайки и комментарии). Распространённые значения: 32 = подписчики, 33 = посещения главной страницы, 37 = просмотры видео, 40 = популярность трансляции, 45 = клики по ссылке в комментарии, 63 = показ подписчикам, 78 = естественное продвижение, 81 = высокая частота взаимодействия |
| schema | body | integer | Нет | Схема размещения: 0=одиночный элемент по умолчанию, 3=многоэлементная BatchDelivery; официальный клиент выбирает её на основе количества элементов |
| is_max_cv | body | boolean | Нет | Оценивать ли в режиме MaxCV (maximum-conversion-volume); официальный клиент выводит это значение на основе целевых возможностей, количества элементов, бюджета и состояния ручной ставки, значение по умолчанию — true |
| pay_type | body | integer | Нет | Канал оплаты: 0=CashDesk, 1=IAP, 2=Caijing, 3=CgTradeCash; официальный запрос оценки использует 1 |
| cost_int | body | integer | Нет | Бюджет размещения в li (CNY 1/1000), по умолчанию 30000 (CNY 30) |
| duration_seconds | body | integer | Нет | Продолжительность размещения в секундах, по умолчанию 21600 (6 часов) |