← 返回目录
📁 API Reference › Super Split Test

更新对比测试时间

您可以使用本接口更新拆分对比测试的起止时间。

请求

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

方法 POST

header

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

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填} | string | 广告主ID。  |
|split_test_group_id {必填} | string | 拆分对比测试组ID。 |
| start_time {必填} | string | 拆分对比测试的起始时间,格式:YYYY-MM-DD HH:MM:SS (UTC+0时间)。例如:2022-01-01 00:00:00。<br><p><span style="color:darkred"><b>注意</b></span>: <ul><li><b>推广系列层级</b>拆分对比测试中,<ul><li>测试时间只能设定到小时级别。因此,传入的分钟和秒数都将默认转化为00。</li><li>推广系列层级拆分对比测试设定的起始时间<b>不会</b>重写此测试中推广系列和广告组的起始时间。</li></ul></ul><ul><li><b>广告组层级</b>拆分对比测试中,测试起始时间将同时应用于测试中的两个广告组。</li></ul><ul><li>推广系列层级和广告组层级拆分对比测试一旦开始,起始时间将无法更新。</li></ul> |
| end_time {必填} | string | 拆分对比测试的结束时间,格式:YYYY-MM-DD HH:MM:SS (UTC+0时间)。例如: 2022-01-01 00:00:00。<br><p><span style="color:darkred"><b>注意</b></span>: <ul><li><b>推广系列层级</b>拆分对比测试中,<ul><li>测试时间只能设定到小时级别。因此,传入的分钟和秒数都将默认转化为00。</li><li>推广系列层级拆分对比测试设定的结束时间<b>不会</b>重写此测试中推广系列和广告组的结束时间。</li></ul></ul><ul><li><b>广告组层级</b>拆分对比测试中,测试结束时间将同时应用于测试中的两个广告组。</li></ul>|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/split_test/update/' \
--header 'Access-Token: xx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "advertiser_id": "xx",
    "start_time": "2022-10-21 22:00:00",
    "end_time": "2022-10-22 22:00:00",
    "split_test_group_id": "xxx"
}'
(/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)

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →