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