受众规则

受众规则确定是否将特定用户添加到您的自定义受众当中。这些规则应用于来源网址或特定事件和数据。

请采用 JSON 编码字符串的形式并按如下结构提供规则：

• 一条受众规则包含两个规则集。
• 每个规则集可包含一条包含规则或排除规则。
• 每条包含规则或排除规则可包含筛选条件和聚合函数。
• 每个筛选条件包含一个筛选条件集。

受众规则可用于不同的自定义受众类型，包括网站自定义受众、移动应用自定义受众和线下自定义受众。如需了解互动受众规则，请参阅互动自定义受众。

限制

• 对于每个受众，受众规则中最多可指定 10 条规则，其中包括 inclusions 或 exclusions 中的 rules 数量。
• 每条规则最多可指定 100 个筛选条件（称为叶节点）。

受众规则语法

如要定义受众规则，必须采用以下结构：

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

可用字段

规则集语法

每个规则集都应采用以下结构：

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

可用字段

包含规则和排除规则语法

每条包含规则或排除规则都应采用以下结构：

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

可用字段

筛选条件

筛选条件采用以下通用格式：

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

可用字段

筛选条件集语法

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

可用字段

聚合函数

在受众规则字段中使用 aggregation，根据行为的频率和强度创建自定义受众。这样您便可以定义一个聚合函数，例如：

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

可用字段

例如：

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

比较运算符

示例

网站自定义受众

如要匹配过去 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"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

移动应用自定义受众

请参阅移动应用自定义受众 > 自定义受众规则示例。

运算符和数据（或事件）

规则包含以下运算符和数据（或事件）：

请以 JSON 编码字符串的形式提供每条规则。