REST Resource: customBiddingAlgorithms

資源：CustomBiddingAlgorithm

單一自訂出價演算法。

JSON 表示法 
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "customBiddingAlgorithmType": enum (CustomBiddingAlgorithmType),
  "sharedAdvertiserIds": [
    string
  ],
  "modelDetails": [
    {
      object (CustomBiddingModelDetails)
    }
  ],

  // 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)

僅供輸出。自訂出價演算法的專屬 ID。由系統指派。
displayName

string

必要欄位。自訂出價演算法的顯示名稱。

必須採用 UTF-8 編碼，大小上限為 240 個位元組。
entityStatus

enum (EntityStatus)

控管自訂出價演算法是否可做為出價策略。

可接受的值如下：

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum (CustomBiddingAlgorithmType)

必要欄位。不可變更。自訂出價演算法的類型。
sharedAdvertiserIds[]

string (int64 format)

可存取這項演算法的廣告主 ID。如果已設定 advertiserId，這個欄位只會包含該值。

如果演算法 owner 是合作夥伴，且是使用廣告主 accessor 擷取，則不會設定這個欄位。
modelDetails[]

object (CustomBiddingModelDetails)

僅供輸出。有權存取自訂出價模式的每個廣告主，其模式詳細資料。

只有在演算法 owner 是合作夥伴，且是使用廣告主 accessor 擷取時，這個欄位才可能包含所查詢廣告主的詳細資料。
聯集欄位 owner。用來識別擁有自訂出價演算法的 DV360 實體。可以是合作夥伴或廣告主。owner 只能是下列其中一項：
partnerId

string (int64 format)

不可變更。擁有自訂出價演算法的合作夥伴專屬 ID。
advertiserId

string (int64 format)

不可變更。擁有自訂出價演算法的廣告主專屬 ID。

CustomBiddingAlgorithmType

自訂出價演算法的可能類型。

列舉
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED 這個版本未指定或不明演算法類型。
SCRIPT_BASED 透過客戶上傳的自訂出價指令碼檔案產生的演算法。
ADS_DATA_HUB_BASED

已淘汰：ADS_DATA_HUB_BASED 已淘汰。透過廣告資料中心產品建立的演算法。
GOAL_BUILDER_BASED

已淘汰：系統已淘汰 GOAL_BUILDER_BASED，不再提供支援，並以 RULE_BASED 取代。透過 DV3 使用者介面的目標建立工具建立的演算法。

這類型的現有演算法已遷移至 RULE_BASED。
RULE_BASED

演算法會根據定義的規則運作。這些規則是在 API 中使用 AlgorithmRules 物件定義。

這類演算法僅適用於許可清單中的客戶。其他嘗試使用這類型的顧客會收到錯誤訊息。

CustomBiddingModelDetails

單一共用廣告主的自訂出價演算法模型詳細資料。

JSON 表示法 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState),
  "suspensionState": enum (SuspensionState)
}
欄位
advertiserId

string (int64 format)

相關廣告主的專屬 ID。
readinessState

enum (ReadinessState)

自訂出價模型的完備狀態。
suspensionState

enum (SuspensionState)

僅供輸出。自訂出價模型的停用狀態。

ReadinessState

模型完備程度的可能狀態。

列舉
READINESS_STATE_UNSPECIFIED 這個版本未指定狀態或狀態不明。
READINESS_STATE_ACTIVE 模型已訓練完畢，可供使用。
READINESS_STATE_INSUFFICIENT_DATA 資料不足，無法訓練服務模型。
READINESS_STATE_TRAINING 模型正在訓練中，尚未準備好提供服務。
READINESS_STATE_NO_VALID_SCRIPT 您未提供有效的自訂出價指令碼，因此無法訓練模型。這項狀態只會套用至 customBiddingAlgorithmType 為 SCRIPT_BASED 的演算法。
READINESS_STATE_EVALUATION_FAILURE 系統已提供有效指令碼，但評估失敗。如果系統無法在指定時間內評估指令碼，就會顯示這項訊息。

SuspensionState

自訂出價模型可能處於的停用狀態。

列舉
SUSPENSION_STATE_UNSPECIFIED 這個版本未指定狀態或狀態不明。
SUSPENSION_STATE_ENABLED 模型已啟用，可能是最近使用過、目前正在使用，或已排定使用時間。演算法正在為這個廣告主計算曝光次數。
SUSPENSION_STATE_DORMANT 模型最近未使用。雖然模型仍會做為 ENABLED，但如果沒有使用，最終會遭到停用。
SUSPENSION_STATE_SUSPENDED 模型已暫停計算曝光次數，因此無法放送。如果演算法指派給這個廣告主底下的委刊項，或以其他方式更新，演算法就會切換回 ENABLED 狀態，並需要時間再次準備放送模型。

方法

create

 建立新的自訂出價演算法。

get

 取得自訂出價演算法。

list

 列出目前使用者可存取且可用於出價策略的自訂出價演算法。

patch

 更新現有的自訂出價演算法。

uploadRules

 為 AlgorithmRules 檔案建立規則參照物件。

uploadScript

 為指令碼檔案建立自訂出價指令碼參照物件。