创建已保存受众

您可以使用本接口创建已保存受众。单个广告账户下最多创建 400 个已保存受众。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/dmp/saved_audience/create/

方法 POST

Header

|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

| 字段 | 类型 | 描述 |
|---|---|---|
| advertiser_id {必填} | string | 广告主ID。 |
| saved_audience_name {必填} | string | 已保存受众名称。<br>名称不能超过512字符，不能包含emoji。 |
| location_ids {必填} | string[] | 您想要定向的地域 ID 列表。<br> 您可以使用[/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713)或[/tool/targeting/search/](https://ads.tiktok.com/marketing_api/docs?id=1761236883355649)接口，查询您可以投放的地区以及相应ID。<br><span style="color:darkred"><b>注意</b></span>：<ul><li>定向地域不允许重叠。例如，不支持同时定向美国和加利福尼亚州。</li></ul> |
| gender | string | 定向受众性别。<br>枚举值: `GENDER_FEMALE`,`GENDER_MALE`,`GENDER_UNLIMITED`。 |
| age_groups | string[] | 定向受众年龄。 枚举值：详见[枚举值-受众年龄区间](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
| languages | string[] | 受众语言。 您可通过[/tool/language/](https://ads.tiktok.com/marketing_api/docs?id=1737188554152962)获取语言代码。若您不想限制受众语言，可为本字段传空值或不传入本字段。 |
| audience_ids | string[] | 受众ID列表。<br>通过[/dmp/custom_audience/list/](https://ads.tiktok.com/marketing_api/docs?id=1739940506015746)接口获取受众ID。 |
| excluded_audience_ids | string[] | 要排除的受众ID列表。<br>通过[/dmp/custom_audience/list/](https://ads.tiktok.com/marketing_api/docs?id=1739940506015746)接口获取受众ID。 |
| interest_category_ids | string[] | 兴趣分类。<br>使用[/tool/target_recommend_tags/](https://ads.tiktok.com/marketing_api/docs?id=1736275204260866)接口根据您的定向地区和行业获取推荐兴趣分类，或使用[/tool/interest_category/](https://ads.tiktok.com/marketing_api/docs?id=1737174348712961)接口获取所有支持的兴趣分类。如果指定了兴趣，不支持兴趣定向的版位上的用户将被限制投放，若要确保所有版位可投，请勿传该字段。 |
| interest_keyword_ids | string[] | 用于定向的兴趣关键词ID列表。<br>您可以使用[/tool/interest_keyword/recommend/](https://ads.tiktok.com/marketing_api/docs?id=1763590884474882)接口获取推荐兴趣关键词。 |
| actions | object[] | 您想要定向的行为分类ID列表。 |
#| action_category_ids {+条件必填} | string[] | 若指定了`actions`，该字段必填。只有当投放仅选择TikTok投放时，该字段才有效。<br>您想要定向的行为分类ID列表。<br>您可以使用接口[/tool/action_category/](https://ads.tiktok.com/marketing_api/docs?id=1737166752522241)获取支持的行为分类完整列表。  |
#| action_scene {+条件必填}  | string | 若指定了`actions`，该字段必填。<br>行为场景。枚举值：`VIDEO_RELATED`(视频行为)，`CREATOR_RELATED`（创作者互动行为），`HASHTAG_RELATED`（视频标签相关）。 |
#| action_period {+条件必填}  | number | 若指定了`actions`，该字段必填。<br>选择n天内发生的行为。<br>枚举值: `0`，`7`，`15`。如果`action_scene`为`CREATOR_RELATED`或`HASHTAG_RELATED`，不论您传入何值，系统将默认使用`0`。`0`表示不设置行为发生的明确时间范围。 |
#| video_user_actions{+条件必填}  | string[] | 若指定了`actions`，该字段必填。<br>视频相关行为。<ul><li>若`action_scene`为`VIDEO_RELATED`（视频类行为），枚举值为：`WATCHED_TO_END`(看完)，`LIKED`（点赞），`COMMENTED`（评论），`HARED`（分享)。</li><li>若`action_scene`为`CREATOR_RELATED`（创作者互动行为），枚举值为：`FOLLOWING`（关注），`VIEW_HOMEPAGE`（浏览主页）。</li><li>若`action_scene`为`HASHTAG_RELATED`（标签相关行为），枚举值为： `VIEW_HASHTAG`（浏览标签）。 </li></ul>|
| operating_systems <br>  | string[] | 受众操作系统。 枚举值：`ANDROID`，`IOS`。只允许传入一个值。 |
| min_android_version | string | 受众最低Android版本。枚举值：详见[枚举值-最低Android版本](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
| min_ios_version | string | 受众最低iOS版本。<br>枚举值：详见[枚举值-最低iOS版本](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
| device_model_ids | string[] | 设备机型ID列表。<br>可参考[获取设备机型列表](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)获取设备机型ID和状态的更多信息。创建广告时需确保对应设备处于活跃状态（ [/tool/device_model/](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)接口返回中`is_active` 为 `true`）。<br><span style="color:darkred"><b>注意</b></span>：不可同时设置设备机型 (`device_model_ids`) 和设备价格(`device_price_ranges`) 。 |
| network_types | string[] | 网络类型。默认值：`unlimited`。<br> 详见[枚举值-网络类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
| carrier_ids | string[] | 运营商 ID列表。<br>您可以使用[获取运营商](https://ads.tiktok.com/marketing_api/docs?id=1737168013095938)接口获取运营商ID。<br>只有在对应的`in_use`字段为`true`时，该运营商的定向才有效。所选运营商需要和定向国家对应。 |
| device_price_ranges | number[] | 设备价格区间（10000代表1000+）。<br>该数字必须是50的倍数。<br><span style="color:darkred"><b>重要提示</b></span>：最终的实际上限将在您设定的上限基础上增加50，您可以在TikTok广告管理平台的广告组设置中看到实际上限。例如，如果您设置的价格区间是[0, 250]，实际区间则为[0, 300]。 |

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/dmp/saved_audience/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "saved_audience_name": "{{saved_audience_name}}",
    "location_ids": [
        "{{location_id}}",
        "{{location_id}}"
    ],
    "languages": [
        "en"
    ],
    "gender": "GENDER_FEMALE",
    "age_groups": [
        "AGE_18_24"
    ],
    "audience_ids": [
        "{{audience_id}}",
        "{{audience_id}}"
    ],
    "excluded_audience_ids": [
        "{{excluded_audience_id}}",
        "{{excluded_audience_id}}"
    ],
    "interest_category_ids": [
        "14",
        "16"
    ],
    "interest_keyword_ids": [
        "{{interest_keyword_ids}}"
    ],
    "interest_keyword_language": [
        "en"
    ],
    "network_types": [
        "WIFI"
    ],
    "actions": [
        {
            "video_user_actions": [
                "FOLLOWING"
            ],
            "action_period": 0,
            "action_scene": "CREATOR_RELATED",
            "action_category_ids": [
                "2"
            ]
        }
    ],
    "carrier_ids": [
        "{{carrier_id}}"
    ],
    "device_price_ranges": [
        0,
        1000
    ],
    "operating_systems": [
        "ANDROID"
    ],
    "min_android_version": "10.0"
}'
(/code)

|字段|类型|描述|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id |string|请求的日志ID，唯一标识一个请求。|
|data |object|返回数据。|
#| saved_audience_id |string| 已保存受众ID。|

示例

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "saved_audience_id": "{{saved_audience_id}}"
    }
}
(/code)