每个规则集都应采用以下结构:
{ "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 }
名称 | 描述 |
---|---|
类型:字符串 | 必要。 聚合函数的类型。
|
| 对于特定类型的聚合函数是必要项。 |
类型:字符串 | 可选。 设为 |
类型:字符串 | 除非 type 是 聚合函数应用的对象参数。 |
类型:字符串 | 必要。
|
类型:字符串 | 必要。 参数的预期值。 |
例如:
"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" } ] }, } ] } }
如要匹配过去 30 天内,商品价格大于或等于 100 美元的 ViewContent
事件,请考虑将此规则用于下列事件:
_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" } ] } ] } } ] } }
规则包含以下运算符和数据(或事件):
运算符 | 筛选条件类型 |
---|---|
| 包含子字符串,不区分大小写 |
| 不包含子字符串,不区分大小写 |
| 包含子字符串,区分大小写 |
| 不包含子字符串,区分大小写 |
| 等于子字符串,区分大小写 |
| 不等于子字符串,区分大小写 |
| 小于子字符串,仅限数字字段 |
| 小于或等于子字符串,仅限数字字段 |
| 大于子字符串,仅限数字字段 |
| 大于或等于子字符串,仅限数字字段 |
| 匹配正则表达式,例如 |
数据 | 要筛选的数据 |
---|---|
| 所访问站点的完全转义网址 |
| 所访问站点的网域 |
| 所访问站点的路径,不包含网域 |
| Pixel 像素代码 |
| 访问站点时所用的设备:
|
任何 | 针对 Pixel 像素代码触发而添加到 |
请以 JSON 编码字符串的形式提供每条规则。