廣告受眾規則

廣告受眾規則可判斷是否將某人新增為您的自訂廣告受眾。此規則會套用於轉介網址或特定事件和資料。

以 JSON 編碼字串提供您的規則,結構如下:

將廣告受眾規則用於不同類型的自訂廣告受眾,包括網站自訂廣告受眾行動應用程式自訂廣告受眾離線自訂廣告受眾。關於互動廣告受眾規則,請參閱互動自訂廣告受眾

限制

  • 每個廣告受眾可在廣告受眾規則中指定最多 10 個規則,包括 inclusionsexclusions 中的 rules 數量。
  • 每個規則可指定最多 100 個篩選條件(稱為葉節點)。

廣告受眾規則語法

若要定義廣告受眾規則,必須遵循以下架構:

rule: {
   "inclusions": <RULE_SET>,
   "exclusions": <RULE_SET>,
}

可用欄位

名稱 說明

inclusions

類型:字串

必要項目。

用來定義包含項目的規則集 JSON 字串。請參閱規則集語法

exclusions

類型:字串

必要項目。

用來定義排除項目的規則集 JSON 字串。請參閱規則集語法

規則集語法

針對每個規則集,請遵循此架構:

{
  "operator" : <BOOLEAN_OPERATOR>,
  "rules" : <JSON_RULE>,
}

可用欄位

名稱 說明

operator

類型:字串

必要項目。

andor

rules

類型:字串

必要項目。

規則的 JSON 字串(規則陣列)。請參閱包含和排除規則語法

包含和排除規則語法

針對每個包含或排除規則,請遵循此結構:

{
  "event_sources" : <EVENT_SOURCE_DEFINITION>, 
  "retention_seconds" : <SECONDS>,
  "filter" : <FILTER>,
  "aggregation" : <AGGREGATION>, 
}

aggregationretention_seconds 是可編輯的欄位。不過,編輯 aggregationretention_seconds 並不會清除廣告受眾。只符合舊規則/彙總資料的用戶,會繼續列入廣告受眾,直到過期為止。

可用欄位

名稱 說明

event_sources

類型:字串

必要項目。

包含 idtype 的 JSON 物件。


您可以使用逗號分隔清單 "store_visits,pixel,app",新增更多事件來源至 type

retention_seconds

類型:整數

必要項目。

廣告受眾的留存期間整數(以秒為單位)應小於 retention_days。最小值=1;最大值=365 天

filter

類型:字串

必要項目。

篩選規則的 JSON 字串。請參閱篩選條件

aggregation

類型:整數

選用。

彙總函式的 JSON 字串。請參閱彙總函式

篩選條件

篩選遵循下列一般格式:

"filter" : {
  "operator": <BOOLEAN_OPERATOR>,
  "filters": <FILTER_SET>,
  }

可用欄位

名稱 說明

operator

類型:字串

必要項目。

andor

filters

類型:字串

必要項目。

篩選規則的 JSON 物件陣列。請參閱篩選規則語法

篩選規則語法

{
    "field": <FIELD>,
    "operator": <COMPARISON_OPERATOR>,
    "value": <VALUE>,
}

可用欄位

名稱 說明

field

類型:字串

必要項目。


  • 針對網站自訂廣告受眾,如果篩選條件是要指定事件,則使用 'event'。符合像素傳送之事件的參數(例如 'ViewContent''Purchase')。
  • 針對行動應用程式自訂廣告受眾,如果篩選條件是要指定事件,則使用 'event'。符合應用程式傳送之應用程式事件的參數,例如「_appVersion」和「_value」等。

operator

類型:字串

必要項目。

  • =
  • !=
  • >=
  • >
  • <=
  • <
  • i_contains
  • i_not_contains
  • contains
  • not_contains
  • is_any
  • is_not_any
  • i_is_any
  • i_is_not_any
  • i_starts_with
  • starts_with
  • "regex_match"[INFO]

如果 field 設為 event,則必須使用 =

value

類型:字串

必要項目。

如果 field 屬性設為 "event",則 value 必須設為事件名稱。使用應用程式事件 API 來查看應用程式回報的應用程式事件和參數。

彙總函式

使用廣告受眾規則欄位中的 aggregation,根據行為的頻率和強度來建立自訂廣告受眾。您可以藉由此方式來定義彙總函式,例如:

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

可用欄位

名稱 說明

type

類型:字串

必要項目。

彙總函式類型。

  • 針對網站自訂廣告受眾,可使用的函式如下:'count''sum''avg''min''max''time_spent''last_event_time_field'
  • 針對行動應用程式自訂廣告受眾,可使用的函式如下:"count""sum""avg""min""max"

config

特定彙總函式類型的必要項目。

method

類型:字串

選用。

"absolute" 表示新增在指定範圍內記錄事件的用戶,或 "percentile" 表示新增來自指定百分比範圍的用戶。如果您選擇 percentile,運算子應該只能是 in_rangenot_in_range

field

類型:字串

必要項目。除非類型為 count

套用彙總函式的參數。

operator

類型:字串

必要項目。

=!=>=><=<in_rangenot_in_range

value

類型:字串

必要項目。

預期的參數值。

例如:

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

比較運算子

運算子 說明

>gt

若事件的參數值大於指定值,則為 true。

>=gte

若事件的參數值大於或等於指定值,則為 true。

<lt

若事件的參數值小於指定值,則為 true。

<=lte

若事件的參數值小於或等於指定值,則為 true。

=eq

若事件的參數值等於指定值,則為 true。注意:這相當於完全不指定任何運算子;也就是「'x' : { 'eq' : 'y' }」與「'x' : 'y'」相同。

!=neq

若事件的參數值不等於指定值,則為 true。

contains

若事件的參數值(字串形式)包含指定字串,則為 true。若指定值為「shoe」,則「shoe12345」值符合「contains」規則。

not_contains

若事件的參數值(字串形式)不包含指定字串,則為 true。若指定值為「purse」,則「shoe12345」值符合「not_contains」規則。

i_contains

包含,不區分大小寫

i_not_contains

不包含,不區分大小寫

is_any

若事件的參數值符合指定陣列中的任何字串,則為 true。

is_not_any

若事件的參數值不符合指定陣列中的任何字串,則為 true。

i_is_any

「is_any」,不區分大小寫。

i_is_not_any

「is_not_any」,不區分大小寫

starts_with

若事件的參數值以指定字串開頭,則為 true

i_starts_with

「starts_with」,不區分大小寫

regex_match

符合規則運算式,例如 \"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"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

行動應用程式自訂廣告受眾

請參閱行動應用程式自訂廣告受眾:自訂廣告受眾規則範例

運算子和資料或事件

規則具有下列運算子和資料或事件:

運算子 篩選條件的類型

i_contains

包含子字串,不區分大小寫

i_not_contains

不包含子字串,不區分大小寫

contains

包含子字串,區分大小寫

not_contains

不包含子字串,區分大小寫

eq

等於,區分大小寫

neq

不等於,區分大小寫

lt

小於,僅限數值欄位

lte

小於或等於,僅限數值欄位

gt

大於,僅限數值欄位

gte

大於或等於,僅限數值欄位

regex_match

符合規則運算式,例如 \"example\\.com.*purchase$\"。支援完整的 PCRE 語法

資料 所篩選的資料

url

所造訪網站的完全逸出網址

domain

所造訪網站的網域

path

所造訪網站的路徑,不包括網域

event

像素 event 的名稱,如 'ViewContent'

device_type

存取網站的裝置:

desktop

mobile_android_phone

mobile_android_tablet

mobile_ipad

mobile_ipod

mobile_iphone

mobile_tablet

mobile_windows_phone

任何 customData 欄位

任何為觸發像素而新增至 customData 的欄位,如 productIdcategoryprice

以 JSON 編碼字串提供每個規則。