投放胜出广告组

您可以使用本接口投放广告组层级拆分对比测试中的胜出广告组。调用此接口后，测试中的另一广告组将被暂停，处于未生效状态，同时胜出广告组的预算将会加倍。

在调用此接口前，请先使用/split_test/result/get/ 接口获取metric 和对应 p_value ，判断出胜出广告组。

注意
本接口目前不支持推广系列层级拆分对比测试。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/split_test/promote/

方法 POST

header

|字段|类型|描述|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填} | string | 广告主ID。  |
|split_test_group_id {必填} | string | 拆分对比测试组ID。 |
|winning_object_id {必填} | string | 胜出广告组的ID。您可使用 [/split_test/result/get/](https://ads.tiktok.com/marketing_api/docs?id=1742666557045761)  接口获取指标（`metric`）和对应p值（`p_value`），然后根据p值是否<=0.1人为判断出胜出广告组。<br><p><span style="color:darkred"><b>注意</b></span>：<b>推广系列层级</b>拆分对比测试<b>请勿</b>传入该字段，否则将会报错。 |

示例

(code curl http)
curl --location --request POST https://business-api.tiktok.com/open_api/v1.3/split_test/promote/' \
--header 'Content-Type: application/json' \
--header 'Access-Token: xxx' \
--data-raw '{
    "advertiser_id": "xx",
    "split_test_group_id": "xx",
    "winning_object_id": "xx"
}'
(/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| 返回数据。 |
|request_id|string|请求的日志 ID，唯一标识一个请求。 |

示例

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