更新推广系列

您可以使用本接口更新推广系列。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/campaign/update/|/v1.3/campaign/update/| |请求参数名称|industry_types|special_industries| |请求参数类型|advertiser_id: number<br>campaign_id: number|advertiser_id: string<br>campaign_id: string| |废弃请求参数|/|roas_bid| |新增请求参数|/|po_number| |返回参数| 在1.3版本中，返回参数将会包含广告实体的完整信息（包括新增返回参数app_id，app_promotion_type，campaign_app_profile_page_state，rf_campaign_type，disable_skan_campaign、bid_align_type、rta_bid_enabled、virtual_objective_type、sales_destination和po_number`）。详情请参见本页面的返回部分。|


## 请求

**地址** <https://business-api.tiktok.com/open_api/v1.3/campaign/update/>

**方法** POST

**Header**

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

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID。 |
|campaign_id {必填}|string|推广系列ID。 |
|campaign_name|string|推广系列名称。<br><br>推广系列名称不能超过512字符，不能包含emoji。<br><br>中文或日文每个字占用2个字符，每个英语字符占用1个字符。|
|special_industries|string[]| 特殊广告分类。 <br><br>为推广系列选择住房、就业或信贷分类，即表示您保证不会利用 TikTok 在与住房、就业或信贷相关的广告中歧视具有受保护特征的人群，且遵守[ TikTok 的特殊广告分类政策](https://ads.tiktok.com/help/article/housing-employment-credit-hec-ad-policy?redirected=2&lang=zh)。<br><br>您使用字段表明您的推广系列推广特殊广告分类的机会后，广告组层级的定位选项将受限，从而帮助您遵守这些类别相关的反歧视法。若想了解相关限制，请查看[使用特殊广告分类的推广系列中广告组的定向要求](https://business-api.tiktok.com/portal/docs?id=1739381236849665#item-link-使用特殊广告分类的推广系列中广告组的定向要求)。<br><br>枚举值:<ul><li>`HOUSING`：房地产，房屋保险，抵押贷款或相关的广告。</li><li>`EMPLOYMENT`：工作机会，实习机会，职业认证项目或相关的广告。</li><li>`CREDIT`：信用卡申请，汽车贷款，长期融资或相关的广告。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>在推广系列商品来源为商品库和推广系列商品来源非商品库的购物广告中使用特殊广告分类目前为单独的白名单功能。如需使用这些功能，请联系您的TikTok销售代表。</li><li>本字段对于注册地为美国或加拿大的广告主已全量。若您是注册地非美国或加拿大的广告主且想在定向美国或加拿大的广告中使用特殊广告分类，您需申请额外的白名单。</li><li>若已为推广系列设置特殊广告分类，允许清除特殊广告分类，但不支持更改特殊广告分类的类别，且若创建时推广系列未设置特殊广告分类，不允许通过更新为推广系列重新启用特殊广告分类。</li></ul>|
|budget|float| 推广系列预算。<br><br>欲了解最低预算以及如何设置预算类型，请参阅[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。欲直接获取某一币种对应的每日预算取值范围，请参阅[币种-每日预算取值范围](https://ads.tiktok.com/marketing_api/docs?id=1737585839634433)。<br><p><span style="color:darkred"><b>注意</b></span>：新预算需至少为当前消耗的105%。您可以请求[同步报表](https://ads.tiktok.com/marketing_api/docs?id=1740302848100353)或[异步报表](https://ads.tiktok.com/marketing_api/docs?id=1740302766489602)，通过基础数据指标`spend`获取消耗数据。 |
|po_number|string|PO（采购订单）号。<br>PO 号可用于结算单追踪和对账。<br><br>[了解月度结算单上的 PO 号](https://ads.tiktok.com/help/article/update-po-number-on-monthly-invoices)。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/update/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "campaign_name": "{{campaign_name}}"
}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。  |
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id |string|请求的日志ID，唯一标识一个请求。  |
|data |object|返回数据。|
#|advertiser_id |string| 广告主 ID。 |
#|campaign_id |string| 推广系列 ID。 |
#|create_time  |string|推广系列创建时间。|
#|modify_time |string| 推广系列修改时间。 |
#|objective_type|string| 推广目标，获取枚举值，参阅[枚举值-推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#| app_promotion_type | string | 应用推广类型。<br>枚举值：<ul><li>`APP_INSTALL`：应用安装。让新用户安装您的应用。</li><li>`APP_RETARGETING`：应用再营销。重新吸引现有用户在您的应用中执行操作。</li><li>`APP_PREREGISTRATION`：应用预注册。让新用户在您的应用发布前完成预注册。</li><li>`APP_POSTS_PROMOTION`：应用帖子推广。推广 TikTok 帖子，提升应用认知度并度量转化量。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：目前不支持通过 API 创建应用帖子推广类型的推广系列，仅支持通过 API 更新或检索此类推广系列。|
#|virtual_objective_type|string|新推广目标类型。<br><br>枚举值：`SALES`（销量）。<br><br>使用本字段创建推广目标为销量的推广系列，该目标合并了网站转化量目标和商品销量目标。了解销量目标的详情，参见[销量目标](https://business-api.tiktok.com/portal/docs?id=)。|
#|sales_destination|string|销售目标页面，即想要推动销售的渠道。<br><br>枚举值：<ul><li>`TIKTOK_SHOP`：TikTok Shop。推动 TikTok Shop 上的销售。</li><li>`WEBSITE`：网站。推动网站上的销售。</li><li>`APP`：应用。推动应用上的销售（需要商品库）。</li><li>`WEB_AND_APP`：网站和应用。提升网站和应用上的销量。</li></ul>|
#| is_search_campaign | boolean | 推广系列是否为搜索广告推广系列。 <br><br>枚举值：`true`，`false`。 |
#| is_smart_performance_campaign|boolean|是否为自动化类型的推广系列。<br><br>支持的值：<ul><li>`true`：推广系列为 Smart+ 推广系列或智能效果网站推广系列。</li><li>`false`：推广系列为普通类型的推广系列。 </li></ul><br><p><span style="color:darkred"><b>注意</b></span>：若`is_smart_performance_campaign` 为 `true` 且 `objective_type` 为 `WEB_CONVERSIONS`，您可根据[/campaign/spc/get/](1767334299811842.html)返回的`spc_type`查看该网站推广系列为 Smart+ 网站推广系列还是智能效果网站推广系列。|
#|campaign_type|string| 推广系列类型。<br><br>枚举值: `REGULAR_CAMPAIGN`（普通推广系列）、`IOS14_CAMPAIGN`（iOS14推广系列）。|
#| app_id | string | 推广的App的ID。<br><br>您可通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786)获取`app_id`。 |
#| is_advanced_dedicated_campaign| boolean | 该推广系列是否为高级专属推广系列。高级专属推广系列采用捕捉实时信号的高级投放模型。<br><br>枚举值：`true`，`false`。 |
#| disable_skan_campaign | boolean | 是否关闭 SKAN（SKAdNetwork）归因（Apple 针对 iOS 推广系列的转化归因解决方案）。<br><br>枚举值：<ul><li>`true`：关闭 SKAN 归因。推广系列将不受[专属推广系列配额限制](1752256248260610.html)的约束，您可为此推广系列拉取[自归因平台（SAN）指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-自归因平台指标)数据。但是，不支持为此推广系列拉取 [SKAN 指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-SKAN%20指标)数据。了解[自归因平台集成](https://ads.tiktok.com/help/article/about-self-attribution-transition)的详情。</li><li>`false`：启用 SKAN 归因。推广系列将受[专属推广系列配额限制](1752256248260610.html)的约束，您可为此推广系列拉取 [SKAN 指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-SKAN%20指标)数据。</li></ul> |
#| bid_align_type | string | 专属推广系列的归因类型。此类型决定广告组层级设置的目标 CPA （`conversion_bid_price`） 或目标 ROAS（`roas_bid`） 基于的归因网络类型。<br><br>枚举值：<ul><li>`SAN`：自归因平台归因。</li><li>`SKAN`：SKAN 归因。</li></ul> |
#|campaign_app_profile_page_state|string| 下载中间页使用情况。<br><br>枚举值：`INVALID`，`UNSET`，`ON`，`OFF`。|
#|rf_campaign_type |string| 仅当推广目标（`objective_type`）设置为`RF_REACH`时，可根据本字段判断推广系列是否设置为TikTok Pulse推广系列。<br><br>枚举值： `STANDARD` （普通覆盖和频次推广系列）， `PULSE`（TikTok Pulse推广系列）。 |
#| campaign_product_source | string | 仅当推广系列对应的`objective_type`为`PRODUCT_SALES`，且设置了商品来源时返回。<br><br>推广系列的商品来源。<br><br>枚举值：<ul><li> `CATALOG` ：商品库。</li><li>`STORE`：TikTok Shop 店铺，或 TikTok 橱窗。 </li></ul>|
#|campaign_name |string| 推广系列名称。 |
#|special_industries|string[]| 特殊广告分类。 <br><br>枚举值:<ul><li>`HOUSING`：房地产，房屋保险，抵押贷款或相关的广告。</li><li>`EMPLOYMENT`：工作机会，实习机会，职业认证项目或相关的广告。</li><li>`CREDIT`：信用卡申请，汽车贷款，长期融资或相关的广告。</li></ul>|
#|budget_optimize_on|boolean| 仅为开启了推广系列预算优化的推广系列返回本字段。<br><br>是否开启推广系列预算优化。<br><br>枚举值：`true`（开启）。<br><br>详见[推广系列预算优化](https://ads.tiktok.com/marketing_api/docs?id=1739381757818881)。|
#|bid_type |string| 推广系列层级的竞价策略。|
#|deep_bid_type |string| 深度事件出价类型。<br><br>枚举值详见[枚举值-深度事件出价类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|roas_bid |float| 用于价值优化的 ROAS 目标值。|
#|optimization_goal |string|优化目标。|
#|budget_mode |string|预算类型。<br><br>枚举值：<ul><li>`BUDGET_MODE_INFINITE`：不限预算。</li><li>`BUDGET_MODE_TOTAL`：总预算。</li><li>`BUDGET_MODE_DAY`：日预算。</li><li> `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`：动态日预算，即一周七日的平均预算。单日实际消耗不超过设定的七日平均预算的125%。周消耗不会超过七日平均预算*7。</li></ul>|
#|budget |float| 推广系列预算。|
#| rta_id | string | 实时 API ID，即实时 API 策略标识符。 |
#| rta_bid_enabled | boolean | 是否使用实时 API 出价。<br><br> 支持的值：<ul><li> `true`：启用。</li><li> `false`：不启用。</li></ul> |
#| rta_product_selection_enabled| boolean | 是否使用实时 API 自动选择商品。<br><br> 枚举值：<ul><li> `true`：使用。</li><li>`false`：不使用。</li></ul> |
#|operation_status |string|推广系列的操作状态。<ul><li>`ENABLE`：推广系列处于启用（“开”）状态。</li><li>`DISABLE`：推广系列处于未启用（“关”）状态。</li></ul>  |
#|secondary_status|string|推广系列状态（二级状态）。|
#| 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> <br><p><span style="color:darkred"><b>注意</b></span>：若您已为应用启用 <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)。 |
#|is_new_structure|bool|推广系列是否为新结构（对于同一个推广系列，其推广系列、广告组和广告的结构是相同的）。|
#|objective|string| 推广类型（应用或落地页）。<br><br>枚举值： `APP`(应用)，`LANDING_PAGE`(落地页)。 |
#|po_number|string|PO（采购订单）号。<br><br>PO 号可用于结算单追踪和对账。<br><br>[了解月度结算单上的 PO 号](https://ads.tiktok.com/help/article/update-po-number-on-monthly-invoices)。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "is_new_structure": true,
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "campaign_type": "REGULAR_CAMPAIGN",
        "budget": {{budget}},
        "budget_mode": "BUDGET_MODE_TOTAL",
        "special_industries": [],
        "deep_bid_type": null,
        "advertiser_id": "{{advertiser_id}}",
        "objective_type": "TRAFFIC",
        "create_time": "{{create_time}}",
        "operation_status": "ENABLE",
        "is_smart_performance_campaign": false,
        "campaign_id": "{{campaign_id}}",
        "roas_bid": 0,
        "campaign_name": "{{campaign_name}}",
        "objective": "LANDING_PAGE",
        "rf_campaign_type": "STANDARD",
        "modify_time": "{{modify_time}}"
    }
}
(/code);