評估規格
規則的 evaluation_spec 主要用途為決定此規則應針對哪些物件執行其動作。evaluation_type 可決定評估方法的類型，其選項如下：
evaluation_spec 含有 filters 陣列，可讓您進一步縮小相符物件清單的範圍。例如，您可以針對廣告、廣告組合和廣告行銷活動中繼資料以及洞察報告指標建構篩選條件。所有篩選條件都使用 AND 運算子一起評估。
filters 陣列包含篩選條件物件的清單。這些物件是含有 field、value，和 operator 索引鍵的字典：
| 篩選條件物件索引鍵 | 說明 |
|---|---|
| 必要項目。 篩選欄位，例如洞察報告資料或中繼資料 |
| 必要項目。 欄位的靜態篩選值 |
| 必要項目。 欄位的邏輯運算子 |
每個篩選條件都有一個支援的邏輯運算子清單。以下是 SCHEDULE 和 TRIGGER 規則所支援的邏輯運算子：
| 邏輯運算子 | 值（範例） |
|---|---|
| 數值（100） |
| 數值（100） |
| 數值（100） |
| 數值（100） |
| 元組（[100, 200]） |
| 元組（[100, 200]） |
| 清單（["1", "2", "3"]） |
| 清單（["1", "2", "3"]） |
| 字串（"ABC"） |
| 字串（"ABC"） |
| 清單（[1, 2, 3]） |
| 清單（[1, 2, 3]） |
| 清單（[1, 2, 3]） |
TRIGGER 評估類型的 evaluation_spec 需要有 trigger。觸發範圍包含一個類型和一個基礎篩選規格。條件規格可以是 field、value 和 operator。
觸發範圍可以動態方式決定我們是否該評估規則，而且您只能有一個觸發範圍。如需更多資訊，請參閱觸發型規則。
以下定義一些特殊的篩選條件，以及您可以使用的一般篩選條件群組。
特殊篩選條件
time_preset
time_preset 篩選條件可決定我們彙整洞察報告指標的時間範圍。目前，我們只允許一個 time_preset。其適用於規則中的所有統計篩選條件，包括用於觸發範圍的篩選條件（如果有的話）。
time_preset 唯一支援的運算子是 EQUAL，只要有任何洞察報告篩選條件或觸發範圍，就需要有此運算子。觸發型規則僅支援含有 TODAY 的時間預設，因為其執行即時評估。
規則的時間預設運作方式可能與其他介面不同。此處的部分時間預設包括今天的資料。這是因為對於比日常運作更頻繁的規則，今天的資料至關重要。至於其他介面，LAST_N_DAYS 的預設值一般不包含今天的資料。請參閱以下說明以瞭解詳情。
{
"field": "time_preset",
"value": "TODAY",
"operator": "EQUAL"
}| 時間預設值 | 說明 |
|---|---|
| 物件的生命週期 |
| 從廣告帳號時區午夜開始的當天 |
|
|
| 最後 2 個全天和 |
| 最後 6 個全天和 |
| 最後 13 個全天和 |
| 最後 27 個全天和 |
| 最後 29 個全天和 |
| 本月，包含 |
| 本週，以星期一為每週的第一天，包含 |
| 本週，以星期日為每週的第一天，包含 |
| 前一個全天，不含 |
| 最後 2 個全天，不含 |
| 最後 3 個全天，不含 |
| 最後 7 個全天，不含 |
| 最後 14 個全天，不含 |
| 最後 28 個全天，不含 |
| 最後 30 個全天，不含 |
| 最後 14 天到最後 7 天，適用於 ROAS |
| 最後 30 天到最後 7 天，適用於 ROAS |
| 最後 60 天到最後 7 天，適用於 ROAS |
| 最後 120 天到最後 7 天，適用於 ROAS |
| 最後 180 天到最後 7 天，適用於 ROAS |
| 終身到最後 7 天，適用於 ROAS |
| 最後 60 天到最後 28 天，適用於 ROAS |
| 最後 120 天到最後 28 天，適用於 ROAS |
| 最後 180 天到最後 28 天，適用於 ROAS |
| 終身到最後 28 天，適用於 ROAS |
attribution_window
attribution_window 篩選條件可決定彙整洞察報告指標的回顧期間。如需更多資訊，請參閱歸因期間上的洞察報告文件。
目前，我們只允許一個 attribution_window，而且其會套用套規則中的所有統計篩選條件。attribution_window 唯一支援的運算子是 EQUAL，而且只有排程型規則支援此運算子。
無論是否指定，attribution_window 唯一允許的 value 是 ACCOUNT_DEFAULT。
{
"field": "attribution_window",
"value": "ACCOUNT_DEFAULT",
"operator": "EQUAL"
}| 歸因期間值 | 說明 |
|---|---|
| 使用帳號層級的歸因期間設定 |
中繼資料篩選條件
您可以使用中繼資料篩選條件，根據其中繼資料欄位的目前狀態來篩選物件。此功能也支援多層級篩選，亦即，您可以對物件的父項或祖項使用前綴來套用中繼資料篩選條件。這不影響其他篩選條件。洞察報告篩選條件仍然適用於一般物件。
排程型規則支援所有中繼資料篩選條件，但觸發型規則僅支援其中一部分。
例如，如果您想要將規則套用到其目標為 WEBSITE_CLICKS 的廣告行銷活動之廣告組合，則可以包含兩個篩選條件：
"filters" : [
{
"field": "entity_type",
"value": "ADSET",
"operator": "EQUAL",
},
{
"field": "campaign.objective",
"value": "WEBSITE_CLICKS",
"operator": "EQUAL"
}
]觸發型和排程型規則支援的中繼資料篩選條件
| 中繼資料欄位 | 說明 |
|---|---|
| 套用規則的特定靜態物件。 支援的前綴：廣告、廣告組合、廣告行銷活動 支援的值： 支援的運算子： |
| 套用規則的物件層級。 支援的前綴：無 支援的值： 支援的運算子： |
| 部分相符或完全相符之物件的名稱。 支援的前綴：廣告、廣告組合、廣告行銷活動 支援的值： 支援的運算子： |
| 物件的廣告標籤編號。 支援的前綴：廣告、廣告組合、廣告行銷活動 支援的值： 支援的運算子： |
| 物件的廣告行銷活動目標。 支援的前綴：廣告行銷活動 支援的值： 支援的運算子： |
| 物件的 epoch 開始時間。 支援的前綴：廣告組合、廣告行銷活動 支援的值： 支援的運算子： |
| 物件的 epoch 停止時間。 支援的前綴：廣告組合、廣告行銷活動 支援的值： 支援的運算子： |
| 物件的廣告行銷活動購買類型。 支援的前綴：廣告行銷活動 支援的值： 支援的運算子： |
| 物件的廣告組合計費事件。 支援的前綴：廣告組合 支援的值： 支援的運算子： |
| 物件的廣告組合最佳化目標。 支援的前綴：廣告組合 支援的值： 支援的運算子： |
| 物件的廣告組合自動出價狀態。 支援的前綴：廣告組合 支援的值： 支援的運算子： |
| 物件的廣告組合單日預算。 支援的前綴：廣告組合 支援的值： 支援的運算子： |
| 物件的廣告組合總經費。 支援的前綴：廣告組合 支援的值： 支援的運算子： |
| 物件的廣告行銷活動花費上限。 支援的前綴：廣告行銷活動 支援的值： 支援的運算子： |
| 物件的出價金額。 支援的前綴：廣告、廣告組合 支援的值： 支援的運算子： |
| 物件的 epoch 建立時間。 支援的前綴：廣告、廣告組合、廣告行銷活動 支援的值： 支援的運算子： |
| 物件的 epoch 更新時間。 支援的前綴：廣告、廣告組合、廣告行銷活動 支援的值： 支援的運算子： |
僅受排程型規則支援的中繼資料篩選條件
| 中繼資料欄位 | 說明 |
|---|---|
| 物件的有效狀態。 支援的前綴：廣告、廣告組合、廣告行銷活動 支援的值： 支援的運算子： |
| 物件的廣告組合版位頁面類型。 支援的前綴：廣告組合 支援的值： 支援的運算子： |
| 物件的廣告組合預算重設期。 支援的前綴：廣告組合 支援的值： 支援的運算子： |
| 自物件 支援的前綴：廣告、廣告組合、廣告行銷活動 支援的值： 支援的運算子： |
| 廣告組合結束刊登前，預算花費的預估百分比。此條件的運作機制與廣告組合預算重調功能相同，因此適用於任何預算類型，但每天需要 10 小時的投遞時間。 支援的前綴：廣告組合 支援的值： 支援的運算子： |
| 廣告組合針對各廣告受眾規模的預估觸及率。 支援的前綴：廣告組合 支援的值： 支援的運算子： |
| 自物件處於 支援的前綴：廣告、廣告組合、廣告行銷活動 支援的值： 支援的運算子： |
| epoch 目前時間。 支援的前綴：無 支援的值： 支援的運算子： |
entity_type 和 id
對於 SCHEDULE 或 TRIGGER 評估類型的每個規則，您必須指定 entity_type 或 id 篩選條件。
當您指定 entity_type 篩選條件時，可決定要套用規則的動態物件層級。例如，如果 entity_type 為 AD，則該規則會自動評估新增至廣告帳號的每個新廣告。無論您何時建立規則，都會如此進行。指定 id 篩選條件後，規則只會套用到物件的靜態清單。
當您指定不含前綴的 id 篩選條件時，我們會自動計算要套用規則的物件層級。例如，如果您想要對 [123, 456] 廣告套用規則，則只需要一個篩選欄位 id，值 [123, 456]以及運算子 IN。在此情況下，entity_type 並非必要，因為您已提供物件的初始靜態清單，我們可以根據這些物件計算物件層級。
您可以將 entity_type 和 id 與多層級篩選一起使用。例如，如果您希望將規則套用到某些指定廣告組合下的所有廣告，則可以使用 AD 的 entity_type 篩選條件，以及具有指定廣告組合的 adset.id 篩選條件。
預設情況下，如果您未指定 effective_status 篩選條件，我們會在評估規則時，以隱含的方式新增 effective_status 篩選條件。
對於作用於正常使用中物件的所有執行類型，此預設篩選條件的運算子為 IN，且值為 ['ACTIVE', 'PENDING_REVIEW']。這表示此規則僅評估已具有或將具有正常使用中投遞的物件。對於未作用於正常使用中物件的執行類型（UNPAUSE），我們會在此篩選條件加上 NOT_IN 運算子和 ['DELETED', 'ARCHIVED'] 值。預設篩選條件是針對我們執行類型的內部最佳化結果。
洞察報告篩選條件
我們會根據特定 time_preset 從洞察報告 API 傳回的目前值來評估洞察報告篩選條件。這些篩選條件會直接套用到物件清單或物件層級，且不支援多層級篩選。所有洞察報告篩選條件都支援以下運算子：GREATER_THAN、LESS_THAN、EQUAL、IN_RANGE、NOT_IN_RANGE。
此處表示的單位是根據行銷 API 的貨幣基礎。例如，美元的基本單位是分，亦即，值為 1000 時，花費相當於 10.00 美元。
有關以下每個欄位的說明，請參閱洞察報告 API 文件。排程型規則支援以下所有篩選條件。
以下為洞察報告篩選條件的清單，及其是否受觸發型規則支援：
| 洞察報告欄位 | 是否可供觸發型規則使用？ |
|---|---|
| 否 |
| 否 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 否 |
| 是 |
| 是 |
| 是 |
| 是 |
| 是 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
| 否 |
進階篩選條件
您可以根據以上的洞察報告和中繼資料篩選條件，自訂和衍生進階欄位。如需更多資訊，請參閱進階評估規格篩選條件。
進階篩選條件支援以下運算子：GREATER_THAN、LESS_THAN、EQUAL、IN_RANGE、NOT_IN_RANGE。僅受排程型規則支援。
對於一些最常用的進階篩選條件，我們支援篩選條件別名功能：
| 進階欄位別名 | 衍生來源 |
|---|---|
|
|
|
|