更新推广系列操作状态
您可以使用本接口关停，开启或者删除推广系列。
注意
对于已删除的推广系列，其操作状态无法修改。您可以使用/campaign/get/，并通过operation_status字段获取推广系列的操作状态。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/campaign/update/status/|/v1.3/campaign/status/update/|
|请求参数名称|opt_status|operation_status|
|请求参数类型|advertiser_id: number<br>campaign_ids: number[]|advertiser_id: string<br>campaign_ids: string[]|
|新增请求参数| /|postback_window_mode|
|返回参数类型|campaign_ids: number[]|campaign_ids: string[]|
|新增返回参数|/|campaign_list`（包括该对象数组下的所有参数）|
## 请求
**地址** <https://business-api.tiktok.com/open_api/v1.3/campaign/status/update/>
**方法** 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。 |
|campaign_ids {必填}|string[]| 推广系列 ID列表。允许数量范围：`1-20`。|
|operation_status {必填}|string| 要进行的操作。<br>枚举值：`DELETE`（删除）,`DISABLE`（暂停）,`ENABLE`（启用）。<br><p><span style="color:darkred"><b>注意</b></span>：您无法修改已删除推广系列的状态。|
| postback_window_mode | string | 仅当以下条件均满足时生效：<ul><li>推广系列（`campaign_ids`）为专属推广系列（`campaign_type`为`IOS14_CAMPAIGN` ）。 </li><li>你在请求中同时将`operation_status`设置为 `DISABLE` 。</li><li>推广系列未设置`postback_window_mode` 。</li><li>您已为应用启用了 SKAN 4.0。</li></ul><br>选定的模式决定您想要确保能接收到的 SKAN (SKAdNetwork) 4.0 回传。对应的窗口期较长的回传需要更多时间接收回传，推广系列配额释放的时间也相应较长。<br>枚举值： <ul><li>`POSTBACK_WINDOW_MODE1`：此模式确保能接收到第一次回传，对应的归因窗口期为 0-2 天。回传数据最长需要 4 天时间接收，推广系列配额释放的时间最长也为 4 天。</li><li> `POSTBACK_WINDOW_MODE2`：此模式确保能接收到第一次及第二次回传，对应的归因窗口期为 3-7 天。回传数据最长需要 13 天时间接收，推广系列配额释放的时间最长也为 13 天。</li><li>`POSTBACK_WINDOW_MODE3`：此模式确保能接收到三次回传，对应的归因窗口期为 8-35 天。回传数据最长需要 41 天时间接收，推广系列配额释放的时间最长也为 41 天。 </li></ul> <br>若想了解 SKAN 4.0 归因窗口期和推广系列配额详情，请查看[专属推广系列](1740029173531649.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li> 若您已为应用启用 <b>Adjust</b>，<b>Airbridge</b>，<b>Appsflyer</b>，<b>Branch</b>，<b>Kochava</b>，或 <b>Singular</b> 移动合作伙伴 (MMP) 跟踪，且您的 MMP SDK 版本已更新至支持 SKAN 4.0 的版本，您可在事件管理平台将应用迁移至 SKAN 4.0 。若想了解为应用启用 MMP 跟踪的步骤，请查看[如何在 TikTok 广告管理平台中设置应用归因](https://ads.tiktok.com/help/article/set-up-app-attribution-tiktok-ads-manager?lang=zh)。若想了解将应用迁移至 SKAN 4.0 的步骤，请查看[关于 SKAN 4.0 和 TikTok ](https://ads.tiktok.com/help/article/about-skan-4-0-and-tiktok?lang=zh)以及[如何迁移到 SKAN 4.0](https://ads.tiktok.com/help/article/how-to-transition-to-skan-4-0?lang=zh)。</li><li>本字段设置后不允许修改。</li><li>若`operation_status`设置为`ENABLE`或未传入，同时传入了本字段，将出现报错。</li><li>若您传入了本字段，但指定的应用（`app_id`）未启用 SKAN 4.0 ，将出现报错。</li><li>若`campaign_type` 设置为`IOS14_CAMPAIGN`，`operation_status` 设置为 `DISABLE`，且您已为应用启用了 SKAN 4.0，但您未传入本字段，则本字段值默认设置为`POSTBACK_WINDOW_MODE1`。</li><li>回传归因窗口期的设置可能仅部分成功。若您传入了非专属推广系列的`campaign_ids`，或传入了已经设置了`postback_window_mode`的专属推广系列的`campaign_ids`，将忽略这些推广系列，仅为其余满足上文所列条件的推广系列设置`postback_window_mode`。</li><li>若您已为应用启用了 SKAN 4.0，需定向 iOS 16.1 及以上版本的设备，从而确保能够接收 SKAN 4.0 的回传。若您想仅定向 iOS 16.1 及以上版本的设备，可在广告组层级将 `min_ios_version` 设置为 `16.1` 。</li></ul>|
示例
(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
"advertiser_id": "ADVERTISER_ID",
"campaign_ids": [
"CAMPAIGN_IDS"
],
"opt_status": "OPT_STATUS"
}' \
https://business-api.tiktok.com/open_api/v1.3/campaign/update/status/
(/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|返回数据。|
#|campaign_ids |string[]| 修改的推广系列 ID列表。|
#|status |string|已执行的操作，枚举值：`DELETE`，`DISABLE`，`ENABLE`。 |
#| campaign_list | object[] | 所指定的推广系列的相关信息。 |
##| campaign_id | string | 推广系列ID。 |
##| status | string | 该推广系列（ `campaign_id` ）当前的状态。<br> <br>枚举值：`DELETE` （已删除）， `DISABLE` （已暂停）， `ENABLE` （投放中）。 |
##| postback_window_mode | string | 选定的模式决定您想要确保能接收到的 SKAN (SKAdNetwork) 4.0 回传。 <br><br>枚举值：<ul><li>`POSTBACK_WINDOW_MODE1` ：此模式确保能接收到第一次回传，对应的归因窗口期为 0-2 天。 回传数据最长需要 4 天时间接收，推广系列配额释放的时间最长也为 4 天。 </li><li> `POSTBACK_WINDOW_MODE2` ：此模式确保能接收到第一次及第二次回传，对应的归因窗口期为 3-7 天。回传数据最长需要 13 天时间接收，推广系列配额释放的时间最长也为 13 天。</li><li>`POSTBACK_WINDOW_MODE3` ：此模式确保能接收到三次回传，对应的归因窗口期为 8-35 天。回传数据最长需要 41 天时间接收，推广系列配额释放的时间最长也为 41 天。 </li></ul>|
|request_id |string|请求的日志ID，唯一标识一个请求。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
"status": "ENABLE",
"campaign_ids": [
11,
22
]
},
"request_id": "2019091810032301011023224213551"
}
(/code);