REST Resource: customBiddingAlgorithms

Tài nguyên: Thuật toán đặt giá thầu tuỳ chỉnh

Một thuật toán đặt giá thầu tuỳ chỉnh.

Biểu diễn dưới dạng 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.
}
Các trường
name

string

Chỉ có đầu ra. Tên tài nguyên của thuật toán đặt giá thầu tuỳ chỉnh.
customBiddingAlgorithmId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của thuật toán đặt giá thầu tuỳ chỉnh. Do hệ thống chỉ định.
displayName

string

Bắt buộc. Tên hiển thị của thuật toán đặt giá thầu tuỳ chỉnh.

Phải là mã UTF-8 với kích thước tối đa là 240 byte.
entityStatus

enum (EntityStatus)

Kiểm soát việc có thể sử dụng thuật toán đặt giá thầu tuỳ chỉnh làm chiến lược đặt giá thầu hay không.

Các giá trị được chấp nhận là:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum (CustomBiddingAlgorithmType)

Bắt buộc. Không thể thay đổi. Loại thuật toán đặt giá thầu tuỳ chỉnh.
sharedAdvertiserIds[]

string (int64 format)

Mã nhận dạng của các nhà quảng cáo có quyền sử dụng thuật toán này. Nếu bạn đặt advertiserId, trường này sẽ chỉ bao gồm giá trị đó.

Trường này sẽ không được đặt nếu thuật toán owner là một đối tác và đang được truy xuất bằng cách sử dụng nhà quảng cáo accessor.
modelReadiness[]

object (CustomBiddingModelReadinessState)

Chỉ có đầu ra. Trạng thái sẵn sàng của mô hình đặt giá thầu tuỳ chỉnh cho mỗi nhà quảng cáo có quyền truy cập.

Trường này chỉ có thể bao gồm trạng thái của nhà quảng cáo được truy vấn nếu thuật toán owner là một đối tác và đang được truy xuất bằng cách sử dụng nhà quảng cáo accessor.
customBiddingAlgorithmState

enum (State)

Chỉ có đầu ra. Trạng thái của thuật toán đặt giá thầu tuỳ chỉnh.
Trường nhóm owner. Xác định pháp nhân DV360 sở hữu thuật toán đặt giá thầu tuỳ chỉnh. Đó có thể là đối tác hoặc nhà quảng cáo. owner chỉ có thể là một trong những trạng thái sau đây:
partnerId

string (int64 format)

Không thể thay đổi. Mã nhận dạng duy nhất của đối tác sở hữu thuật toán đặt giá thầu tuỳ chỉnh.
advertiserId

string (int64 format)

Không thể thay đổi. Mã nhận dạng duy nhất của nhà quảng cáo sở hữu thuật toán đặt giá thầu tuỳ chỉnh.

CustomBiddingAlgorithmType

Các loại thuật toán đặt giá thầu tuỳ chỉnh có thể có.

Enum
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED Loại thuật toán chưa được chỉ định hoặc chưa xác định trong phiên bản này.
SCRIPT_BASED Thuật toán được tạo thông qua các tệp tập lệnh đặt giá thầu tuỳ chỉnh do khách hàng tải lên.
ADS_DATA_HUB_BASED Thuật toán được tạo thông qua sản phẩm Ads Data Hub.
GOAL_BUILDER_BASED Thuật toán được tạo thông qua trình tạo mục tiêu trong giao diện người dùng DV3.

CustomBiddingModelReadinessState

Trạng thái sẵn sàng của mô hình thuật toán đặt giá thầu tuỳ chỉnh cho một nhà quảng cáo được chia sẻ.

Biểu diễn dưới dạng JSON 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState)
}
Các trường
advertiserId

string (int64 format)

Mã nhận dạng duy nhất của nhà quảng cáo có liên quan.
readinessState

enum (ReadinessState)

Trạng thái sẵn sàng của mô hình đặt giá thầu tuỳ chỉnh.

ReadinessState

Các trạng thái sẵn sàng của mô hình có thể xảy ra.

Enum
READINESS_STATE_UNSPECIFIED Trạng thái không được chỉ định hoặc không xác định trong phiên bản này.
READINESS_STATE_ACTIVE Mô hình đã được huấn luyện và sẵn sàng phân phát.
READINESS_STATE_INSUFFICIENT_DATA Không có đủ dữ liệu để huấn luyện mô hình phân phát.
READINESS_STATE_TRAINING Mô hình đang được huấn luyện và chưa sẵn sàng để phân phát.
READINESS_STATE_NO_VALID_SCRIPT Bạn chưa cung cấp tập lệnh đặt giá thầu tuỳ chỉnh hợp lệ để huấn luyện mô hình. Trạng thái này sẽ chỉ được áp dụng cho các thuật toán có customBiddingAlgorithmType là SCRIPT_BASED.

Tiểu bang

Các trạng thái có thể có của thuật toán đặt giá thầu tuỳ chỉnh.

Enum
STATE_UNSPECIFIED Trạng thái không được chỉ định hoặc không xác định trong phiên bản này.
ENABLED Đã bật thuật toán (đã sử dụng gần đây), đang được sử dụng hoặc đã lên lịch sử dụng. Thuật toán đang tích cực tính điểm lượt hiển thị.
DORMANT Thuật toán không được sử dụng gần đây. Mặc dù thuật toán vẫn hoạt động như ENABLED nhưng cuối cùng sẽ bị tạm ngưng nếu bạn không sử dụng.
SUSPENDED Thuật toán được sử dụng từ việc tính điểm lượt hiển thị và chưa huấn luyện mô hình phân phát. Nếu được chỉ định cho một mục hàng hoặc được cập nhật thì thuật toán sẽ chuyển về trạng thái ENABLED và cần thời gian để chuẩn bị lại mô hình phân phát.

Phương thức

create

 Tạo thuật toán đặt giá thầu tuỳ chỉnh mới.

get

 Nhận thuật toán đặt giá thầu tuỳ chỉnh.

list

 Liệt kê các thuật toán đặt giá thầu tuỳ chỉnh mà người dùng hiện tại có thể truy cập và có thể dùng trong các chiến lược đặt giá thầu.

patch

 Cập nhật một thuật toán đặt giá thầu tuỳ chỉnh hiện có.

uploadScript

 Tạo đối tượng tham chiếu tập lệnh đặt giá thầu tuỳ chỉnh cho tệp tập lệnh.