- Ресурс: CustomBiddingAlgorithm
- CustomBiddingAlgorithmType
- CustomBiddingModelDetails
- Состояние готовности
- Состояние приостановки
- Методы
Ресурс: CustomBiddingAlgorithm
Единый специальный алгоритм назначения ставок.
JSON-представление |
---|
{ "name": string, "customBiddingAlgorithmId": string, "displayName": string, "entityStatus": enum ( |
Поля | |
---|---|
name | Только вывод. Имя ресурса специального алгоритма назначения ставок. |
customBiddingAlgorithmId | Только вывод. Уникальный идентификатор специального алгоритма назначения ставок. Назначается системой. |
displayName | Необходимый. Отображаемое название специального алгоритма назначения ставок. Должен быть в кодировке UTF-8 с максимальным размером 240 байт. |
entityStatus | Определяет, можно ли использовать специальный алгоритм назначения ставок в качестве стратегии назначения ставок. Принятые значения:
|
customBiddingAlgorithmType | Необходимый. Неизменяемый. Тип специального алгоритма назначения ставок. |
sharedAdvertiserIds[] | Идентификаторы рекламодателей, имеющих доступ к этому алгоритму. Если задан Это поле не будет задано, если |
modelDetails[] | Только вывод. Подробная информация о моделях специального назначения ставок для каждого рекламодателя, у которого есть доступ. Это поле может включать сведения о запрашиваемом рекламодателе только в том случае, если |
owner поля Союза. Идентифицирует объект DV360, которому принадлежит специальный алгоритм назначения ставок. Это может быть как партнер, так и рекламодатель. owner может быть только один из следующих: | |
partnerId | Неизменяемый. Уникальный идентификатор партнера, которому принадлежит специальный алгоритм назначения ставок. |
advertiserId | Неизменяемый. Уникальный идентификатор рекламодателя, которому принадлежит специальный алгоритм назначения ставок. |
CustomBiddingAlgorithmType
Возможные типы пользовательских алгоритмов назначения ставок.
Перечисления | |
---|---|
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED | В этой версии тип алгоритма не указан или неизвестен. |
SCRIPT_BASED | Алгоритм генерируется на основе загруженных клиентом файлов сценариев специального назначения ставок. |
ADS_DATA_HUB_BASED | Алгоритм, созданный с помощью продукта Ads Data Hub. |
GOAL_BUILDER_BASED | Алгоритм создан с помощью конструктора целей в пользовательском интерфейсе DV3. |
CustomBiddingModelDetails
Подробные сведения о модели специального алгоритма назначения ставок для одного общего рекламодателя.
JSON-представление |
---|
{ "advertiserId": string, "readinessState": enum ( |
Поля | |
---|---|
advertiserId | Уникальный идентификатор соответствующего рекламодателя. |
readinessState | Состояние готовности специальной модели назначения ставок. |
suspensionState | Только вывод. Состояние приостановки специальной модели назначения ставок. |
Состояние готовности
Возможные состояния готовности модели.
Перечисления | |
---|---|
READINESS_STATE_UNSPECIFIED | В этой версии состояние не указано или неизвестно. |
READINESS_STATE_ACTIVE | Модель обучена и готова к обслуживанию. |
READINESS_STATE_INSUFFICIENT_DATA | Недостаточно данных для обучения модели обслуживания. |
READINESS_STATE_TRAINING | Модель обучается и не готова к обслуживанию. |
READINESS_STATE_NO_VALID_SCRIPT | Не предоставлен действительный специальный сценарий назначения ставок для обучения модели. Это состояние будет применяться только к алгоритмам, у которых имеет SCRIPT_BASED . |
Состояние приостановки
Возможные состояния приостановки моделей специальных ставок.
Перечисления | |
---|---|
SUSPENSION_STATE_UNSPECIFIED | В этой версии состояние не указано или неизвестно. |
SUSPENSION_STATE_ENABLED | Модель включена: она либо недавно использовалась, либо используется в настоящее время, либо запланирована к использованию. Алгоритм активно подсчитывает показы для этого рекламодателя. |
SUSPENSION_STATE_DORMANT | Модель в последнее время не использовалась. Хотя модель по-прежнему действует как ENABLED , в конечном итоге она будет приостановлена, если не будет использоваться. |
SUSPENSION_STATE_SUSPENDED | Модель отстранена от подсчета показов и не может обслуживаться. Если алгоритм назначен позиции этого рекламодателя или иным образом обновлен, он снова перейдет в состояние ENABLED и потребуется время для повторной подготовки модели показа. |
Методы | |
---|---|
| Создает новый специальный алгоритм назначения ставок. |
| Получает собственный алгоритм назначения ставок. |
| Перечисляет специальные алгоритмы назначения ставок, которые доступны текущему пользователю и могут использоваться в стратегиях назначения ставок. |
| Обновляет существующий алгоритм специального назначения ставок. |
| Создает объект ссылки на сценарий специального назначения ставок для файла сценария. |