廣告受眾規則可判斷是否將某人新增為您的自訂廣告受眾。此規則會套用於轉介網址或特定事件和資料。
以 JSON 編碼字串提供您的規則,結構如下:
將廣告受眾規則用於不同類型的自訂廣告受眾,包括網站自訂廣告受眾、行動應用程式自訂廣告受眾和離線自訂廣告受眾。關於互動廣告受眾規則,請參閱互動自訂廣告受眾。
inclusions
或 exclusions
中的 rules
數量。針對每個規則集,請遵循此架構:
{ "operator" : <BOOLEAN_OPERATOR>, "rules" : <JSON_RULE>, }
名稱 | 說明 |
---|---|
類型:字串 | 必要項目。
|
類型:字串 | 必要項目。 規則的 JSON 字串(規則陣列)。請參閱包含和排除規則語法。 |
針對每個包含或排除規則,請遵循此結構:
{ "event_sources" : <EVENT_SOURCE_DEFINITION>, "retention_seconds" : <SECONDS>, "filter" : <FILTER>, "aggregation" : <AGGREGATION>, }
aggregation
和 retention_seconds
是可編輯的欄位。不過,編輯 aggregation
和 retention_seconds
並不會清除廣告受眾。只符合舊規則/彙總資料的用戶,會繼續列入廣告受眾,直到過期為止。
篩選遵循下列一般格式:
"filter" : { "operator": <BOOLEAN_OPERATOR>, "filters": <FILTER_SET>, }
名稱 | 說明 |
---|---|
類型:字串 | 必要項目。
|
類型:字串 | 必要項目。 篩選規則的 JSON 物件陣列。請參閱篩選規則語法。 |
{ "field": <FIELD>, "operator": <COMPARISON_OPERATOR>, "value": <VALUE>, }
名稱 | 說明 |
---|---|
類型:字串 | 必要項目。
|
類型:字串 | 必要項目。
如果 |
類型:字串 | 必要項目。 如果 |
使用廣告受眾規則欄位中的 aggregation
,根據行為的頻率和強度來建立自訂廣告受眾。您可以藉由此方式來定義彙總函式,例如:
"aggregation" : { "type":"count", "operator":">", "value":1 }
名稱 | 說明 |
---|---|
類型:字串 | 必要項目。 彙總函式類型。
|
| 特定彙總函式類型的必要項目。 |
類型:字串 | 選用。
|
類型:字串 | 必要項目。除非類型為 套用彙總函式的參數。 |
類型:字串 | 必要項目。
|
類型:字串 | 必要項目。 預期的參數值。 |
例如:
"aggregation" : { "type":"count", "operator":">", "value":1 }
運算子 | 說明 |
---|---|
| 若事件的參數值大於指定值,則為 true。 |
| 若事件的參數值大於或等於指定值,則為 true。 |
| 若事件的參數值小於指定值,則為 true。 |
| 若事件的參數值小於或等於指定值,則為 true。 |
| 若事件的參數值等於指定值,則為 true。注意:這相當於完全不指定任何運算子;也就是「'x' : { 'eq' : 'y' }」與「'x' : 'y'」相同。 |
| 若事件的參數值不等於指定值,則為 true。 |
| 若事件的參數值(字串形式)包含指定字串,則為 true。若指定值為「shoe」,則「shoe12345」值符合「contains」規則。 |
| 若事件的參數值(字串形式)不包含指定字串,則為 true。若指定值為「purse」,則「shoe12345」值符合「not_contains」規則。 |
| 包含,不區分大小寫 |
| 不包含,不區分大小寫 |
| 若事件的參數值符合指定陣列中的任何字串,則為 true。 |
| 若事件的參數值不符合指定陣列中的任何字串,則為 true。 |
| 「is_any」,不區分大小寫。 |
| 「is_not_any」,不區分大小寫 |
| 若事件的參數值以指定字串開頭,則為 true |
| 「starts_with」,不區分大小寫 |
| 符合規則運算式,例如 \"example\.com.*purchase$\"。支援完整的 PCRE 語法 |
符合過去 30 天內所有包含字串「shoes」的引用網址:
{ "inclusions": { "operator": "or", "rules": [ { "event_sources": [ { "type": "pixel", "id": "<PIXEL_ID>", } ], "retention_seconds": 2592000, "filter": { "operator": "and", "filters": [ { "field": "url", "operator": "i_contains", "value": "shoes" } ] }, } ] } }
符合 ViewContent
事件,其中過去 30 天內的商品價格高於或等於 100 美元。考慮將此規則用於以下事件:
_fbq.push([ 'track', 'ViewContent', { productId: 1234, category: 'Men > Shoes', price: 199 } ]);
{ "inclusions": { "operator": "or", "rules": [ { "event_sources": [ { "type": "pixel", "id": "<PIXEL_ID>" } ], "retention_seconds": 2592000, "filter": { "operator": "and", "filters": [ { "field": "event", "operator": "eq", "value": "ViewContent" }, { "operator": "or", "filters": [ { "field": "price", "operator": ">=", "value": "100" } ] } ] } } ] } }
規則具有下列運算子和資料或事件:
運算子 | 篩選條件的類型 |
---|---|
| 包含子字串,不區分大小寫 |
| 不包含子字串,不區分大小寫 |
| 包含子字串,區分大小寫 |
| 不包含子字串,區分大小寫 |
| 等於,區分大小寫 |
| 不等於,區分大小寫 |
| 小於,僅限數值欄位 |
| 小於或等於,僅限數值欄位 |
| 大於,僅限數值欄位 |
| 大於或等於,僅限數值欄位 |
| 符合規則運算式,例如 |
資料 | 所篩選的資料 |
---|---|
| 所造訪網站的完全逸出網址 |
| 所造訪網站的網域 |
| 所造訪網站的路徑,不包括網域 |
| 像素 |
| 存取網站的裝置:
|
任何 | 任何為觸發像素而新增至 |
以 JSON 編碼字串提供每個規則。