创建相似受众

您可以使用本接口创建相似受众。您需要使用广告主账号下已有的受众人群创建相似受众。

注意
新建的受众最多需要48小时来处理，然后才能使用。
请使用/dmp/custom_audience/get/接口来检查新建受众的状态，只有状态是is_valid的受众才能被使用。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径| /v1.2/dmp/custom_audience/lookalike/create/|/v1.3/dmp/custom_audience/lookalike/create/| |请求参数名称|system|mobile_os| |请求参数类型|advertiser_id: number<br>source_audience_id: number<br> placements: string|advertiser_id: string<br>source_audience_id: string<br> placements: string[]| |请求参数名称和类型|is_contain_source: number|include_source: boolean| |返回参数类型|custom_audience_id: number|custom_audience_id`: string|


## 请求

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

**方法** POST

**Header**

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

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
|custom_audience_name {必填}|string|受众群体名称。限128字符内。|
|audience_sub_type{-已废弃}|string| 受众子类型，表明可以使用的广告类型。枚举值：`NORMAL`: 常规受众，可用于非覆盖和频次广告。`REACH_FREQUENCY`: 覆盖和频次广告受众，只可用于覆盖和频次广告。默认： `NORMAL`。|
|lookalike_spec {必填}|object|相似受众群体的参数。|
#|source_audience_id{必填}|string|种子受众ID。种子受众不能是现有的相似受众。<br><p><span style="color:darkred"><b>注意</b></span>: 种子受众的规模数量不得小于100。|
#|include_source{必填}|boolean|是否包含种子受众群体。|
#|mobile_os{必填}|string|操作系统。枚举值：`ALL`：支持iOS和安卓， `ANDROID`：仅支持安卓，`IOS`：仅支持iOS。具体请查看[枚举值-相似人群手机系统](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|placements{必填}|string[]|投放平台。枚举值：`TikTok`, `TopBuzz & BuzzVideo`，`Pangle`。详见[枚举值-相似受众版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|location_ids{必填}|string[]|投放地区。具体请查看[枚举值-相似受众地点](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|audience_size{必填}|string|相似受众的大小。枚举值：`NARROW`, `BALANCED`，`BROAD`。具体请查看[枚举值-相似受众大小](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/dmp/custom_audience/lookalike/create/' \
--header 'Content-Type: application/json' \
--header 'Access-Token: token' \
--data-raw '{
    "advertiser_id": "ADVERTISER_ID", 
    "calculate_type": "CALCULATE_TYPE", 
    "custom_audience_name": "CUSTOM_AUDIENCE_NAME", 
    "lookalike_spec": {
        "source_audience_id": SOURCE_AUDIENCE_ID,
        "is_contain_source": 1,
        "system": "ALL",
        "placements": ["TikTok"],
        "location_ids": ["JP", "US"],
        "audience_size": "NARROW"
    }
}'
(/code)

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

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {
        "custom_audience_id": "123"
    }
}
(/code);