创建拆分对比测试

您可以使用本接口创建拆分对比测试。

在开始创建之前，查看此处了解创建拆分对比测试的前提条件，查看此处了解如何创建拆分对比测试。

目前，我们支持广告组层级拆分对比测试和推广系列层级拆分对比测试。广告组层级拆分对比测试中，总预算将平均分配给每个广告组。推广系列层级拆分对比测试中，预算将按照每个推广系列已设定的预算金额进行分配。

请求

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

方法 POST

header

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

参数

|字段|类型|描述|
|---|---|---|
| advertiser_id {必填} | string | 广告主 ID。|
| split_test_level | string |拆分对比测试层级。<br><br>枚举值：<ul><li>`ADGROUP`：广告组层级拆分对比测试。</li><li>`CAMPAIGN`：推广系列层级拆分对比测试。</li></ul><br>默认值： `ADGROUP`。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>推广系列层级拆分对比测试目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>在单个对比测试中比较不同推广系列中的两个广告组目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li></ul>|
| object_ids  | string[] | 与该拆分对比测试绑定的广告组ID（`adgroup_ids` ）。<br><br><ul><li>进行<b>广告组层级</b>拆分对比测试，请传入本字段或 `cells`。</li><li>进行<b>推广系列层级</b>拆分对比测试，请传入`cells`，不要传入本字段。|
| cells {+条件必填}| object[] | 当`split_test_level `为`CAMPAIGN`时必传本字段。<br><br>拆分对比测试单元列表。 长度必须为2。|
#| object_ids | string[] |<ul><li>若`split_test_level`为`ADGROUP`，请传入`adgroup_id`。每单元的长度必须为1。</li><li>若`split_test_level`为`CAMPAIGN`，请传入`campaign_id`。长度范围：[1,10]。</li></ul>|
| test_variable | string | 拆分对比测试变量。此字段不会影响测试结果。<br><br>枚举值：<ul><li>`BIDDING_OPTIMIZATION`: 为出价和优化字段设置不同的优化值，对比不同优化方法对广告表现的影响。</li><li>`TARGTING`: 在广告组层级设置不同的定向值，比较广告组对不同受众群体或人群属性等的成效。</li><li>`CREATIVE`: 设置不同的创意素材，比较创意素材对广告表现的影响。</li><li>`CUSTOM`：设置多个变量，比较这些变量对广告表现的影响。该枚举值仅支持<b>推广系列层级</b>拆分对比测试。</li></ul>默认值：</li><li><b>广告组层级</b>拆分对比测试的默认值为 `BIDDING_OPTIMIZATION`。</li><li><b>推广系列层级</b>拆分对比测试的默认值为`CUSTOM`。</li></ul><br><p><span style="color:darkred"><b>注意：</b></span> `test_variable` 一旦设置便无法更新。 |
| key_metric | string | 您想监测的关键指标。<br><br>枚举值： <ul><li>`UNSET`：未设置。</li><li>`CONVERT_RATE`：CVR（转化率）。</li><li> `CLICK_THROUGH_RATE`：点击率（CTR）。</li><li> `COST_PER_SHOW`：千次展示成本（CPM）。</li><li> `COST_PER_CONVERT`：每次转化成本。</li><li> `COST_PER_REACH`：覆盖单人成本。 </li><li> `COST_PER_CLICK`：每次点击成本。</li><li>`COST_PER_FOCUSED_VIEW`：每次专注观看成本。</li><li>`FOCUSED_VIEW_RATE`：专注观看率。</li><li>`COMPLETE_PAYMENT_ROAS`：支付完成 ROAS。</li><li>`COST_PER_LANDING_PAGE_VIEW`：落地页浏览平均成本。</li><li>`LANDING_PAGE_VIEW_RATE`：落地页浏览率。</li><li>`CLICK`（<span style="color:red">已废弃</span>） ：点击量。</li><li>`REACH`（<span style="color:red">已废弃</span>） ：覆盖人数。 </li><li> `SHOW`（<span style="color:red">已废弃</span>） ：展示量。</li><li> `CONVERT`（<span style="color:red">已废弃</span>） ：转化量。</li><li> `COST`（<span style="color:red">已废弃</span>） ：成本。</li></ul> <br>参阅[拆分对比测试 - 支持的优化目标](https://ads.tiktok.com/marketing_api/docs?id=1742668394531842)，获取不同优化目标下支持的关键指标。<br>若未赋值，则将使用下列默认值：<ul><li><b>广告组层级</b>拆分对比测试中，若两个广告组的优化目标均为`REACH` ，则默认关键指标为`COST_PER_REACH`。其他情况下，默认关键指标为 `COST_PER_SHOW`。</li><li><b>推广系列层级</b>拆分对比测试的默认关键指标为`UNSET`。 |
| budget {+条件必填} | float |<ul><li>`split_test_level`为`ADGROUP`时<b>必传</b>。</li><li>`split_test_level` 为 `CAMPAIGN`时，<b>请勿</b>传入该字段，否则将会报错。</li></ul><br>拆分对比测试的总预算。<br><br><ul><li><b>广告组层级</b>拆分对比测试中，该预算将平均分配给每个测试组。此处预算会覆盖两个广告组的当前预算。若想在测试开始后更改总预算，推荐做法是将两个广告组的预算改为同一预算金额。</li><li><b>推广系列层级</b>拆分对比测试中，预算将按照每个推广系列已设定的预算金额进行分配。</li></ul>|
| start_time {必填} | string | 拆分对比测试的起始时间，格式：YYYY-MM-DD HH:MM:SS (UTC+0时间)。例如：2022-01-01 00:00:00。<br><br><p><span style="color:darkred"><b>注意：</b></span> <ul><li>推广系列层级拆分对比测试的时间只能设定到小时级别。因此，传入的分钟和秒数都将默认转化为00。</li><li>推广系列层级拆分对比测试设定的起始时间<b>不会</b>重写此测试中推广系列和广告组的起始时间。 </li></ul>|
| end_time {必填} | string | 拆分对比测试的结束时间，格式：YYYY-MM-DD HH:MM:SS (UTC+0时间)。例如： 2022-01-01 00:00:00。<br><br><p><span style="color:darkred"><b>注意：</b></span> <ul><li>推广系列层级拆分对比测试的时间只能设定到小时级别。因此，传入的分钟和秒数都将默认转化为00。</li><li>推广系列层级拆分对比测试设定的结束时间<b>不会</b>重写此测试中推广系列和广告组的结束时间。 </li></ul>|

示例

(code curl http)
curl --location 'https://business-api.tiktok.com/open_api/v1.3/split_test/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "start_time": "2024-03-09 02:42:13",
    "end_time": "2024-03-10 02:42:13",
    "object_ids": [
        "{{object_ids}}",
        "{{object_ids}}"
    ],
    "key_metric": "FOCUSED_VIEW_RATE",
    "test_variable": "BIDDING_OPTIMIZATION",
    "budget": 100
}'
(/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| 返回数据 |
#|split_test_group_id|string|拆分对比测试组ID。|
|request_id|string|请求的日志 ID，唯一标识一个请求。 |

示例

(code Success-Response http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "split_test_group_id": "{{split_test_group_id}}"
    }
}
(/code)