REST Resource: customBiddingAlgorithms

Ресурс: CustomBiddingAlgorithm

Единый специальный алгоритм назначения ставок.

JSON-представление
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "customBiddingAlgorithmType": enum (CustomBiddingAlgorithmType),
  "sharedAdvertiserIds": [
    string
  ],
  "modelReadiness": [
    {
      object (CustomBiddingModelReadinessState)
    }
  ],
  "customBiddingAlgorithmState": enum (State),

  // Union field owner can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field owner.
}
Поля
name

string

Только вывод. Имя ресурса специального алгоритма назначения ставок.

customBiddingAlgorithmId

string ( int64 format)

Только вывод. Уникальный идентификатор специального алгоритма назначения ставок. Назначается системой.

displayName

string

Необходимый. Отображаемое название специального алгоритма назначения ставок.

Должен быть в кодировке UTF-8 с максимальным размером 240 байт.

entityStatus

enum ( EntityStatus )

Определяет, можно ли использовать специальный алгоритм назначения ставок в качестве стратегии назначения ставок.

Принятые значения:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum ( CustomBiddingAlgorithmType )

Необходимый. Неизменяемый. Тип специального алгоритма назначения ставок.

sharedAdvertiserIds[]

string ( int64 format)

Идентификаторы рекламодателей, имеющих доступ к этому алгоритму. Если задан advertiserId , это поле будет состоять только из этого значения.

Это поле не будет задано, если owner алгоритма является партнером и извлекается с помощью accessor рекламодателя.

modelReadiness[]

object ( CustomBiddingModelReadinessState )

Только вывод. Состояние готовности модели специального назначения ставок для каждого рекламодателя, имеющего доступ.

Это поле может включать состояние запрашиваемого рекламодателя только в том случае, если owner алгоритма является партнером и извлекается с помощью accessor рекламодателя.

customBiddingAlgorithmState

enum ( State )

Только вывод. Статус специального алгоритма назначения ставок.

owner поля Союза. Идентифицирует объект DV360, которому принадлежит специальный алгоритм назначения ставок. Это может быть как партнер, так и рекламодатель. owner может быть только один из следующих:
partnerId

string ( int64 format)

Неизменяемый. Уникальный идентификатор партнера, которому принадлежит специальный алгоритм назначения ставок.

advertiserId

string ( int64 format)

Неизменяемый. Уникальный идентификатор рекламодателя, которому принадлежит специальный алгоритм назначения ставок.

CustomBiddingAlgorithmType

Возможные типы пользовательских алгоритмов назначения ставок.

Перечисления
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED В этой версии тип алгоритма не указан или неизвестен.
SCRIPT_BASED Алгоритм генерируется на основе файлов сценариев специального назначения ставок, загруженных клиентом.
ADS_DATA_HUB_BASED Алгоритм, созданный с помощью продукта Ads Data Hub.
GOAL_BUILDER_BASED Алгоритм создан с помощью конструктора целей в пользовательском интерфейсе DV3.

CustomBiddingModelReadinessState

Состояние готовности модели алгоритма специального назначения ставок для одного общего рекламодателя.

JSON-представление
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState)
}
Поля
advertiserId

string ( int64 format)

Уникальный идентификатор соответствующего рекламодателя.

readinessState

enum ( ReadinessState )

Состояние готовности специальной модели назначения ставок.

Состояние готовности

Возможные состояния готовности модели.

Перечисления
READINESS_STATE_UNSPECIFIED В этой версии состояние не указано или неизвестно.
READINESS_STATE_ACTIVE Модель обучена и готова к обслуживанию.
READINESS_STATE_INSUFFICIENT_DATA Недостаточно данных для обучения модели обслуживания.
READINESS_STATE_TRAINING Модель обучается и не готова к обслуживанию.
READINESS_STATE_NO_VALID_SCRIPT Не предоставлен действительный специальный сценарий назначения ставок для обучения модели. Это состояние будет применяться только к алгоритмам, у которых customBiddingAlgorithmType имеет SCRIPT_BASED .

Состояние

Возможные состояния алгоритмов специального назначения ставок.

Перечисления
STATE_UNSPECIFIED В этой версии состояние не указано или неизвестно.
ENABLED Алгоритм включен: он используется недавно, используется в настоящее время или запланирован к использованию. Алгоритм активно подсчитывает показы.
DORMANT Алгоритм в последнее время не использовался. Хотя алгоритм по-прежнему действует как ENABLED , в конечном итоге он будет приостановлен, если не будет использоваться.
SUSPENDED Алгоритм отстранен от оценки показов и не имеет обученной модели обслуживания. Если алгоритм назначен позиции или иным образом обновлен, он снова перейдет в состояние ENABLED и потребуется время для повторной подготовки модели показа.

Методы

create

Создает новый специальный алгоритм назначения ставок.

get

Получает собственный алгоритм назначения ставок.

list

Перечисляет специальные алгоритмы назначения ставок, которые доступны текущему пользователю и могут использоваться в стратегиях назначения ставок.

patch

Обновляет существующий алгоритм специального назначения ставок.

uploadScript

Создает объект ссылки на сценарий специального назначения ставок для файла сценария.