- 資源:CustomBiddingAlgorithm
- CustomBiddingAlgorithmType
- CustomBiddingModelReadinessState
- ReadinessState
- 狀態
- 方法
資源:CustomBiddingAlgorithm
單一自訂出價演算法。
JSON 表示法 |
---|
{ "name": string, "customBiddingAlgorithmId": string, "displayName": string, "entityStatus": enum ( |
欄位 | |
---|---|
name |
僅供輸出。自訂出價演算法的資源名稱。 |
customBiddingAlgorithmId |
僅供輸出。自訂出價演算法的專屬 ID。由系統指派。 |
displayName |
必要欄位。自訂出價演算法的顯示名稱。 必須採用 UTF-8 編碼,且大小不得超過 240 個位元組。 |
entityStatus |
控管自訂出價演算法是否能做為出價策略使用。 可接受的值如下:
|
customBiddingAlgorithmType |
必要欄位。無法變更。自訂出價演算法的類型。 |
sharedAdvertiserIds[] |
有權存取這個演算法的廣告客戶 ID。如果已設定 |
modelReadiness[] |
僅供輸出。每個具有存取權的廣告客戶自訂出價模型完備性的狀態。 |
customBiddingAlgorithmState |
僅供輸出。自訂出價演算法的狀態。 |
聯集欄位 owner 。指出擁有自訂出價演算法的 DV360 實體。可以是合作夥伴或廣告客戶。owner 只能是下列其中一項: |
|
partnerId |
無法變更。擁有自訂出價演算法的合作夥伴專屬 ID。 |
advertiserId |
無法變更。擁有自訂出價演算法的廣告客戶專屬 ID。 |
CustomBiddingAlgorithmType
可能的自訂出價演算法類型。
列舉 | |
---|---|
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED |
未指定演算法類型,或這個版本中的不明演算法類型。 |
SCRIPT_BASED |
透過客戶上傳的自訂出價指令碼檔案產生的演算法。 |
ADS_DATA_HUB_BASED |
透過廣告資料中心產品建立的演算法。 |
GOAL_BUILDER_BASED |
透過 DV3 UI 目標建立工具建立的演算法。 |
CustomBiddingModelReadinessState
單一共用廣告主的自訂出價演算法模型完備性狀態。
JSON 表示法 |
---|
{
"advertiserId": string,
"readinessState": enum ( |
欄位 | |
---|---|
advertiserId |
相關廣告客戶的專屬 ID。 |
readinessState |
自訂出價模型的完備性狀態。 |
ReadinessState
模型完備性的可能狀態。
列舉 | |
---|---|
READINESS_STATE_UNSPECIFIED |
未指定狀態,或這個版本不明。 |
READINESS_STATE_ACTIVE |
模型已訓練並準備就緒,可以開始提供服務。 |
READINESS_STATE_INSUFFICIENT_DATA |
資料不足,無法訓練提供模型。 |
READINESS_STATE_TRAINING |
模型正在訓練中,尚未準備好提供服務。 |
READINESS_STATE_NO_VALID_SCRIPT |
尚未提供用來訓練模型的有效自訂出價指令碼。此狀態只會套用至 為 SCRIPT_BASED 的演算法。 |
狀態
自訂出價演算法的可能狀態。
列舉 | |
---|---|
STATE_UNSPECIFIED |
未指定狀態,或這個版本不明。 |
ENABLED |
演算法已啟用 (最近使用、目前使用或已排定使用)。演算法正在主動計算曝光。 |
DORMANT |
最近未使用。雖然演算法仍然是 ENABLED ,但如果未使用,最終會遭到停權。 |
SUSPENDED |
演算法會使用評分曝光,並未訓練放送模型。如果演算法已指派給委刊項或以其他方式更新,則演算法會切換回 ENABLED 狀態,需要一段時間才能再次準備放送模型。 |
方法 |
|
---|---|
|
建立新的自訂出價演算法。 |
|
取得自訂出價演算法。 |
|
列出目前使用者能存取的自訂出價演算法,可在出價策略中使用。 |
|
更新現有的自訂出價演算法。 |
|
為指令碼檔案建立自訂出價指令碼參照物件。 |