執行規格

規則的 execution_spec 決定套用於所有通過評估物件的動作。Schedule 和 Trigger Based Rules 支援不同的動作。動作列在 execution_type 底下。

執行類型	說明
`NOTIFICATION`	將圖示通知傳送給此規則的建立者或 `user_ids` 中指定用戶的清單（如果有提供此選項）。支援的評估類型：`SCHEDULE`、`TRIGGER`
`PAUSE`	暫停物件。支援的評估類型：`SCHEDULE`、`TRIGGER`
`UNPAUSE`	取消暫停物件。支援的評估類型：`SCHEDULE`、`TRIGGER`
`CHANGE_BUDGET`	根據定義的 `change_spec`，變更預算。這僅適用於廣告組合。支援的評估類型：`SCHEDULE`
`CHANGE_CAMPAIGN_BUDGET`	根據定義的 `change_spec`，變更預算。這僅適用於廣告行銷活動。支援的評估類型：`SCHEDULE`
`CHANGE_BID`	根據定義的 `change_spec`，變更出價。這僅適用於廣告組合。支援的評估類型：`SCHEDULE`
`ROTATE`	暫停目前刊登中的廣告，並根據廣告組合中的 ID 啟用下一個廣告。需要使用廣告組合的 `id` 篩選條件以及廣告的 `entity_type` 篩選條件。支援的評估類型：`SCHEDULE`
`REBALANCE_BUDGET`	暫停符合評估條件的物件，並根據定義的 `rebalance_spec`，針對其餘物件重新平衡其預算。這僅適用於廣告組合。支援的評估類型：`SCHEDULE`
`PING_ENDPOINT`	透過 Webhooks，將 Ping 傳送到應用程式的訂閱。若要深入瞭解如何設定，請參閱觸發型規則。支援的評估類型：`TRIGGER`

`execution_options`

您可能需要提供其他資訊，才能執行其中部分動作。execution_spec 提供選用的 execution_options 陣列，以指定這些額外的參數。此陣列包含 execution_option 物件的清單，這些物件是具有 field、value 和 operator 索引鍵的字典，如同評估規格的 filter 物件。

觸發型規則不需要任何執行選項。

以下，請參閱支援的執行選項、這些選項支援的 execution_type 值，以及如何架構這些值。目前，所有選項唯一支援的運算子為 EQUAL。

執行選項欄位	說明
`user_ids`*	`NOTIFICATION` 的圖示通知收件人或每個 `execution_type` 之排程型規則摘要電子郵件的收件人。支援的執行類型：排程型規則支援的所有 `execution_type` 值（範例）：`array ([123, 456])`
`change_spec`	指定 `amount`、`limit`、`unit` 和 `target_field`。受支援類型的字典時所需。如果 `target_field` 存在，則出價或預算比例是基於目標欄位的目前值與 `amount` 中指定的目標值之間的差異。`target_field` 必須是有效的洞察報告篩選條件。支援的執行類型：`CHANGE_BUDGET`、`CHANGE_BID` 值（範例）：廣告規則變更規格範例
`rebalance_spec`	支援可決定如何重新平衡預算的不同選項。如需詳細資訊，請參閱範例。支援的執行類型：`REBALANCE_BUDGET` 值（範例）：重新平衡預算廣告規則
`execution_count_limit`	指定對規則的每個個別廣告物件採取預算/出價變更動作的次數上限。若未指定，其預設為無限制。支援的執行類型：`CHANGE_BUDGET`、`CHANGE_BID` 值（範例）：int (123)
`action_frequency`	指定規則可以對物件採取相同動作之前間隔的最短分鐘數。例如，如果 `CHANGE_BUDGET` 規則的值為 `10080`，且該規則僅提高了物件 A 的預算，則該規則至少在一週內不會提高物件 A 的預算，即使物件 A 在該週通過了規則評估亦是如此。支援的執行類型：`CHANGE_BUDGET`、`CHANGE_BID` 值（範例）：int (123)

`user_ids`

如果針對排程型規則提供 user_ids：

我們會每天產生一封電子郵件，總結您的規則在過去 24 小時內執行的動作
我們會將資訊傳送到在 user_ids 底下指定的用戶清單
我們會使用廣告帳號的時區，在中午 12:30 發送電子郵件

此摘要電子郵件會針對每個用戶訂閱的所有規則，彙總其通知。如果任何已訂閱的規則未執行任何動作，則用戶當天不會收到電子郵件。