通过规则创建受众

您可以通过指定规则，创建广告互动受众、应用活动受众、网站访客受众、线索事件受众、商店活动受众或企业号受众。例如： - 最近7天有点击广告行为的受众； - 最近14天有加入购物车行为但没有购买行为的受众。

在调用/dmp/custom_audience/rule/create/时，您需要指定一组包含规则（必填）和一组排除规则（选填）。若调用成功，系统将返回custom_audience_id，供您更新、获取或删除受众。规则（rule_spec）结构如下： - 每个受众规则包含两个规则集合。 - 每个规则集合包含一组规则和一个操作符。 - 每个规则包含一组筛选集合和受众留存天数。 - 每个筛选集合包含一组筛选条件和一个操作符。

注意
在您创建受众群体后，系统需要大约1个小时进行分析处理，请耐心等候。
您可以通过/dmp/custom_audience/get/查看当前的受众状态。当受众状态变为is_valid（生效）后，您才可以使用该受众群体进行后续操作。

受众规则格式

|字段|类型|描述|
|---|---|---|
| inclusion_rule_set {必填}|object|包含的定向规则集合。数量范围：1-5且无重复。格式见下方的“规则集合格式”。|
| exclusion_rule_set{选填}|object|排除的定向规则集合。数量范围：0-5且无重复。格式见下方的“规则集合格式”。|

(code)
AudienceRule = {  
  "inclusion_rule_set": RULE_SET,
  "exclusion_rule_set": RULE_SET
  }
  (/code)

规则集合格式

|字段|类型|描述|
|---|---|---|
|operator {必填}|object|规则之间的操作符。`AND` 代表同时满足， `OR` 代表任意一项满足，目前仅支持 `OR`。|
|rules {必填}|object[]|规则列表，格式见下方的“规则格式”。|

(code)
RULE_SET = {
  "operator": BOOLEAN_OPERATOR,
  "rules": [RULE, ...]
}
(/code)

规则格式

|字段|类型|描述|
|---|---|---|
| event_source_ids  {选填}|string[]|规则的事件源ID列表。当`audience_type`不为`ENGAGEMENT`或`LEAD_GENERATION`时，该字段为必填。<ul><li>对于广告互动受众，需要填入广告组ID。不填默认使用所有事件源ID。<li>对于网站访客受众，需要填入Pixel ID。<li>对于应用事件受众，需要填入App ID。<li>对于线索生成受众，不能填入该字段，否则会出错。不填默认使用所有事件源ID。<li>对于商店活动受众，填入店铺ID。（您可以使用 [/store/list/](1752267762718722.html)接口获取店铺ID。）<li>对于企业号受众，需要填入广告主的核心用户ID。（您可以使用 [/user/info/](1739665513181185.html) 接口获取核心用户ID。）<li>对于自然流量互动受众，使用TikTok视频ID作为事件源ID。（您可以使用[/identity/video/get/](1740218475032577.html) 接口获取TikTok视频ID。）最多填入10个TikTok视频ID。<li> 对于直播互动受众，使用直播视频ID作为事件源ID。 (您可以使用[/identity/video/get/](1740218475032577.html)接口获取直播视频ID。）最多填入10个直播视频ID。<li>对于线下活动受众，使用线下事件组ID作为事件源ID。（您可以使用[/offline/get/](1765596808589313.html) 获取线下事件组ID。）|
| retention_days  {必填}|number|受众留存天数。 枚举值详情可查看[枚举值 - 回溯期](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-回溯期%EF%BC%88retention_days%EF%BC%89)。 <br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>如果`audience_type`为`BUSINESS_ACCOUNT`，且`filters`对象中的`value`不为`BUSINESS ACCOUNT PROFILE FOLLOW`，则`retention_days`必须为`7`，`14`或`30`。<li>如果`audience_type`为`ENGAGEMENT_LIVE_VIDEO` 或`ENGAGEMENT_ORGANIC_VIDEO`，`retention_days`必须为`7`，`14`或`30`。|
|filter_set {必填}|object|筛选集合列表。格式见下方的“筛选集合格式”。 |

(code)
Rule = {
    "event_sources": [EVENT_SOURCE],
    "retention": RETENTION,
    "filter_set": FILTER_SET
}
(/code)

筛选集合格式

|字段|类型|描述|
|---|---|---|
|operator {必填}|string|筛选条件间的操作符，`AND` 代表同时满足筛选关系， `OR` 代表任意一项满足，目前仅支持 `OR`。|
|filters {必填}|object[]|筛选条件列表。目前仅支持传入单个值，格式见下方的“筛选格式”。 |

(code)
FilterSet = {
    "operator": BOOLEAN_OPERATOR,
    "filters": [FILTER]
}
(/code)

筛选格式

|字段|类型|描述|
|---|---|---|
|field {必填}|string|筛选字段。目前仅支持`EVENT`。|
|operator {必填}|string|连接筛选字段和筛选字段值的筛选操作符。枚举值: `EQ`（等于），`GT`（大于），`LT`（小于）。目前仅支持`EQ`。|
|value {必填}|string|筛选字段值。获得枚举值，可参阅[枚举值-筛选字段值](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|

(code)
Filter = {
    "field": FILTER_FIELD,
    "operator": FILTER_OPERATION,
    "value": FILTER_VALUE
}
(/code)

示例

Inclusions
- "login" in the last 14 days or
- "create a role" in the last 7 days
Exclusion
- "complete the tutorial" in the last 14 days

(code)
curl --location 'https://business-api.tiktok.com/open_api/v1.3/dmp/custom_audience/rule/create/' \
--header 'Content-Type: application/json' \
--header 'Access-Token: {{Access-Token}}' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "custom_audience_name": "{{custom_audience_name}}",
    "audience_type": "OFFLINE",
    "rule_spec": {
        "inclusion_rule_set": {
            "operator": "OR",
            "rules": [
                {
                    "event_source_ids": [
                        "{{event_source_ids}}"
                    ],
                    "retention_days": 7,
                    "filter_set": {
                        "operator": "AND",
                        "filters": [
                            {
                                "field": "EVENT",
                                "operator": "EQ",
                                "value": "OFFLINE COMPLETE PAYMENT"
                            }
                        ]
                    }
                }
            ]
        }
    }
}'
(/code)