- Tài nguyên: CustomBiddingAlgorithm
- CustomBiddingAlgorithmType
- CustomBiddingModelDetails
- ReadinessState
- SuspensionState
- Phương thức
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 ( |
Các trường | |
---|---|
name |
Chỉ có đầu ra. Tên tài nguyên của thuật toán đặt giá thầu tuỳ chỉnh. |
customBiddingAlgorithmId |
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 |
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 |
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à:
|
customBiddingAlgorithmType |
Bắt buộc. Không thể thay đổi. Loại thuật toán đặt giá thầu tuỳ chỉnh. |
sharedAdvertiserIds[] |
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 Trường này sẽ không được đặt nếu thuật toán |
modelDetails[] |
Chỉ có đầu ra. Thông tin chi tiết về các 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 thông tin chi tiết về nhà quảng cáo được truy vấn nếu thuật toán |
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 |
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 |
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. |
RULE_BASED |
Thuật toán dựa trên các quy tắc đã xác định. Các quy tắc này được xác định trong API bằng cách sử dụng đối tượng Loại thuật toán này chỉ dành cho những khách hàng trong danh sách cho phép. Những khách hàng khác cố gắng sử dụng loại này sẽ gặp lỗi. |
CustomBiddingModelDetails
Thông tin chi tiết về 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 ( |
Các trường | |
---|---|
advertiserId |
Mã nhận dạng duy nhất của nhà quảng cáo có liên quan. |
readinessState |
Trạng thái sẵn sàng của mô hình đặt giá thầu tuỳ chỉnh. |
suspensionState |
Chỉ có đầu ra. Trạng thái tạm ngư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ó là SCRIPT_BASED . |
READINESS_STATE_EVALUATION_FAILURE |
Bạn đã cung cấp một tập lệnh hợp lệ nhưng không đánh giá được. Điều này áp dụng cho các tập lệnh không thể đánh giá trong thời gian phân bổ. |
SuspensionState
Các trạng thái có thể bị tạm ngưng của mô hình đặt giá thầu tuỳ chỉnh.
Enum | |
---|---|
SUSPENSION_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. |
SUSPENSION_STATE_ENABLED |
Mô hình đã được bật. Đã sử dụng gần đây, hiện đã đượ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ị cho nhà quảng cáo này. |
SUSPENSION_STATE_DORMANT |
Mô hình không được sử dụng gần đây. Mặc dù mô hình này vẫn hoạt động dưới dạng ENABLED , nhưng sau cùng sẽ bị tạm ngưng nếu không được sử dụng. |
SUSPENSION_STATE_SUSPENDED |
Mô hình bị tạm ngưng do tính lượt hiển thị và không thể phân phát. Nếu được chỉ định cho một mục hàng của nhà quảng cáo này hoặc được cập nhật cho một mục hàng, 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 |
|
---|---|
|
Tạo thuật toán đặt giá thầu tuỳ chỉnh mới. |
|
Nhận thuật toán đặt giá thầu tuỳ chỉnh. |
|
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. |
|
Cập nhật một thuật toán đặt giá thầu tuỳ chỉnh hiện có. |
|
Tạo đối tượng tham chiếu quy tắc cho tệp AlgorithmRules . |
|
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. |