← 返回目录
📁 API Reference › Campaign

创建推广系列

您可以使用本接口创建推广系列。每个广告账号最多可创建999个推广系列。每个推广系列可包含一个或多个广告组。

在迁移至1.3版本前,请先阅读推广系列管理接口迁移指南,了解推广系列管理API 1.2与1.3版本之间的重点差异。

若想了解 TikTok 广告管理平台上推广系列、广告组、广告层级的功能在 API 中的对应配置,请查看TikTok 广告管理平台的推广系列功能与 API 配置间的映射。

重要提示
使用本接口代表您同意TikTok的线上数据条款。

线上数据条款:在您出于广告推广目的与 TikTok 分享个人数据的情况下(例如,您选择使用 TikTok Pixel 等广告主工具或与度量合作伙伴合作),使用本接口代表您同意 TikTok 的线上数据条款,包括 Business Products (Data) Terms、Controller to Controller Data Terms及所有组成条款。

您同意 TikTok Commercial Terms of Service 的第 13 条适用于由线上数据条款产生或与之相关的任何及所有责任,无论是否因合同、侵权行为(包括但不局限于疏忽)或其他原因引起。

获取更多信息,请参考 TikTok Advertiser Tools and Related Terms 和 TikTok Controller to Controller Data Terms。

使用前需知

请查阅创建推广系列中的详细指南,了解不同类型的推广系列或广告的参数要求。若现有的指南未涵盖您想创建的推广系列或广告类型,可联系您的 TikTok 代表,申请补充相关指南。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/campaign/create/|/v1.3/campaign/create/| |请求参数名称|budget_optimize_switch<br>industry_types|budget_optimize_on<br>special_industries| |请求参数类型|advertiser_id: number|advertiser_id: string| |新增请求参数|/|app_id<br>campaign_type<br>app_promotion_type<br>campaign_app_profile_page_state<br>rf_campaign_type<br>request_id<br>campaign_product_source<br>postback_window_mode<br>is_advanced_dedicated_campaign<br>rta_id<br>rta_product_selection_enabled<br>disable_skan_campaign<br>rta_bid_enabled<br>virtual_objective_type<br>sales_destination<br>is_search_campaign<br>po_number| |废弃请求参数|/|budget_optimize_switch<br>bid_type<br>deep_bid_type<br>roas_bid<br>optimize_goal| |返回参数| 在v1.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/create/>

**方法** 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。 |
|objective_type {必填}|string| 推广目标。<br><br>详情见[推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737585562434561)。|
| app_promotion_type {+条件必填} | string | 当`objective_type`为`APP_PROMOTION`时必填。<br><br>应用推广类型。<br><br>枚举值:<ul><li>`APP_INSTALL`:应用安装。让新用户安装您的应用。</li><li>`APP_RETARGETING`:应用再营销。重新吸引现有用户在您的应用中执行操作。</li><li>`APP_PREREGISTRATION`:应用预注册。让新用户在您的应用发布前完成预注册。若想了解如何创建应用预注册广告,请查看[这里](https://ads.tiktok.com/marketing_api/docs?id=1772549012687873)。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>:   <ul><li>iOS 14专属推广系列中仅支持`APP_INSTALL`,不支持`APP_RETARGETING`和`APP_PREREGISTRATION`。</li><li>应用预注册目前为白名单功能。如需使用此功能,请联系您的TikTok销售代表。</li></ul>|
|virtual_objective_type|string|新推广目标类型。<br><br>枚举值:`SALES`(销量)。<br><br>使用本字段创建推广目标为销量的推广系列,该目标合并了网站转化量目标和商品销量目标。了解销量目标的详情,参见[销量目标](1834189283112962.html)。|
|sales_destination{+条件必填}|string|仅当传入 `virtual_objective_type` 时本字段生效且必填。<br><br>销售目标页面,即想要推动销售的渠道。<br><br>枚举值:<ul><li>`TIKTOK_SHOP`:TikTok Shop。推动 TikTok Shop 上的销售。</li><li>`WEBSITE`:网站。推动网站上的销售。</li><li>`APP`:应用。推动应用上的销售(需要商品库)。</li><li>`WEB_AND_APP`:网站和应用。提升网站和应用上的销量。<ul><li>若想了解如何创建启用此设置的广告,请查看[创建启用网站和应用优化的广告](1839876593708034.html)。</li></ul></li></ul><br><p><span style="color:darkred"><b>注意</b></span>: 创建启用网站和应用优化的广告(即 `sales_destination` 设置为 `WEB_AND_APP`)目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</p>|
|is_search_campaign|boolean|是否创建搜索广告推广系列。<br>借助搜索广告推广系列,您可以选择相应关键词,据此在 TikTok 搜索结果页中投放广告。若想了解此类推广系列的创建步骤,请查看[创建搜索广告推广系列](1815394136739841.html)。<br><br>支持的值:`true`,`false`。<br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>搜索广告推广系列目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</li><li>本字段设置后不允许修改。</li></ul>|
|campaign_type|string|推广系列类型。<br><br>枚举值:`REGULAR_CAMPAIGN` (普通推广系列),` IOS14_CAMPAIGN`(专属推广系列)。<br><br>`IOS14_CAMPAIGN`的取值仅支持`PRODUCT_SALES`和`APP_PROMOTION`( 对应 `app_promotion_type` 为 `APP_INSTALL`) 的推广目标。<br>若`app_promotion_type`为`APP_RETARGETING`或`APP_PREREGISTRATION`,则`campaign_type`仅可设置为`REGULAR_CAMPAIGN`。 <br><br>若专属推广系列的推广目标为其他类型,仅支持将`campaign_type` 设置为`REGULAR_CAMPAIGN`。<br>若想了解专属推广系列的详情,请查看[专属推广系列](1740029173531649.html)。|
|app_id {+条件必填}|string|当推广系列为iOS专属推广系列(`camapign_type`=`IOS14_CAMPAIGN`),且推广目标(`objective_type`)为`PRODUCT_SALES`或`APP_PROMOTION`(对应 `app_promotion_type` = `APP_INSTALL`)时必填。<br><br>推广的App的ID。<br><br>您可通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786)获取`app_id`。<br><br><p><span style="color:darkred"><b>注意</b></span>: 您不能使用本字段指定未在 MMP(移动监测合作伙伴)侧启用 SAN(自归因)模块的 App 新建 iOS 专属推广系列。若想确保您的 App 启用 TikTok 自归因集成,可查看[如何将新应用集成到 SAN](https://ads.tiktok.com/help/article/transition-to-san-for-existing-apps) 和[如何将现有应用迁移到 SAN](https://ads.tiktok.com/help/article/integrate-to-san-for-new-apps)。|
| is_advanced_dedicated_campaign | boolean | 是否使用高级专属推广系列。高级专属推广系列采用捕捉实时信号的高级投放模型。 <br><br>枚举值:`true`,`false`。 <br>默认值:`false`。<br><br>若想了解如何创建此类推广系列,请查看[创建高级专属推广系列](1797011827608577.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>:本字段设置后不支持修改。 |
| disable_skan_campaign | boolean | 仅当满足以下所有条件时生效:<ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_INSTALL`。</li><li>`campaign_type` 为 `IOS14_CAMPAIGN`。</li><li>`app_id` 为可用于[高级专属推广系列](1797011827608577.html)的 iOS 应用的 ID。 若想确认应用能否用于高级专属推广系列中,可使用 [/app/list/](1740859313270786.html) 并查看返回的`advanced_dedicated_campaign_allowed`。</li></ul><br>是否关闭 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)的详情。<ul><li>若专属推广系列中使用了可用于高级专属推广系列的应用,您需使用以下配置之一:仅启用 SKAN 归因、仅启用高级专属推广系列设置、同时启用 SKAN 归因和高级专属推广系列设置。不支持为此推广系列同时关闭 SKAN 归因和高级专属推广系列设置。</li></ul></li><li>`false`:启用 SKAN 归因。推广系列将受[专属推广系列配额限制](1752256248260610.html)的约束,您可为此推广系列拉取 [SKAN 指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-SKAN%20指标)数据。<ul><li>若您启用 SKAN 归因的同时将 `is_advanced_dedicated_campaign` 设置为 `true`,从而启用高级专属推广系列设置,您将可以为此推广系列同时拉取[自归因平台指标](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指标)数据。</li></ul></li></ul><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>为专属推广系列关闭 SKAN 归因目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</li><li>若您已申请为专属推广系列关闭 SKAN 归因的白名单,在满足以下所有条件时,不支持在广告组层级将 `bid_type` 设置为 `BID_TYPE_CUSTOM`:<ul><li>推广系列层级:<ul><li>`is_advanced_dedicated_campaign` 为 `false`。</li><li>`disable_skan_campaign` 为 `false`。</li></ul></li><li>广告组层级:<ul><li>`optimization_goal` 为 `INSTALL` 或 `IN_APP_EVENT`。</li></ul></li></ul></li><li>本字段设置后不支持更新。</li><li>使用高级专属推广系列要求应用满足一定条件。若您的应用不可用于高级专属推广系列,可联系您的 TikTok 销售代表。您的 TikTok 销售代表将提供故障排查支持,帮助您的应用满足高级专属推广系列的条件。</li></ul> |
| campaign_app_profile_page_state | string | 是否使用应用介绍页优化广告投放。<br><br>枚举值: `ON` , `OFF`。<br><br>默认值:`OFF`。<br><br>本字段仅可在`objective_type`为`APP_PROMOTION`的 iOS 14专属推广系列中使用,否则会出现报错。|
|rf_campaign_type |string|仅当推广目标(`objective_type`)设置为`RF_REACH`时,可用此字段将推广系列设置为 TikTok Pulse 推广系列。<br><br>推广目标非`RF_REACH`时,本字段无需传入。<br><br>枚举值: `STANDARD `(普通覆盖和频次推广系列),` PULSE`(TikTok Pulse推广系列)。<br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>本字段目前为白名单功能。如需使用此功能,请联系您的TikTok销售代表。</li><li>推广系列创建后,本字段不可修改。 </li><li>若您将`rf_campaign_type` 设置为PULSE,则使用[/adgroup/rf/create/](https://ads.tiktok.com/marketing_api/docs?id=1738235338194945)创建广告组时,需在`contextual_tag_ids`字段传入 `PREMIUM`类型的内容相关定向标签,创建的广告组的CPM将是固定的。</li><li>若您将`rf_campaign_type `设置为`PULSE`,则使用[/adgroup/rf/update/](https://ads.tiktok.com/marketing_api/docs?id=1738235402874882)更新广告组时,不支持更新定向地域。</li><li>若您将`rf_campaign_type` 设置为`PULSE`,则使用[/adgroup/rf/create/](https://ads.tiktok.com/marketing_api/docs?id=1738235338194945)创建广告组时,`feed_type`不可设置为 `TOP_FEED`。</li></ul>|
| campaign_product_source{+条件必填} | string | 当 `objective_type` 设置为 `PRODUCT_SALES`时必填。<br><br>推广系列的商品来源。<br><br>枚举值:<ul><li>`CATALOG` :商品库。</li><li> `STORE`:TikTok Shop 店铺,或 TikTok 橱窗。</li></ul> <p><span style="color:darkred"><b>注意</b></span>:<ul><li>推广目标`PRODUCT_SALES`目前为白名单功能。如需使用此功能,请联系您的TikTok销售代表。</li><li>对于[视频购物广告](https://ads.tiktok.com/marketing_api/docs?id=1741942291730434),推广系列层级商品来源决定了广告组层级可选的商品来源:<ul><li>若将本字段设置为 `CATALOG`,同一推广系列下广告组的`product_source`仅可设置为`CATALOG`。</li><li>若将本字段设置为 `STORE`,同一推广系列下广告组的`product_source`仅可设置为`STORE` 或`SHOWCASE`。</li></ul> </li></ul> |
|campaign_name {必填}|string|推广系列名称。<br><br>推广系列名称不能超过512字符,不能包含emoji。<br><br>中文或日文每个字占用2个字符,每个英语字符占用1个字符。|
|request_id|string|请求 ID,用于创建同名推广系列。<br>若想创建同名推广系列,可发送两个创建推广系列的请求,请求中指定相同的 `campaign_name` 和不同的`request_id`。<br><br>该 ID 还支持接口幂等,可在 10 秒内避免重复请求。如果您在 10 秒内传入相同的请求 ID 重试多次请求,只有一次请求会成功。<br><br>该 ID 和返回参数中的 `request_id` 不同。返回的`request_id`用于唯一标识一次 HTTP 请求。<br><br>本字段的值需为字符串格式的64位整数值。 <br><br>示例:`123456789`|
|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_optimize_on|boolean|是否开启推广系列预算优化(CBO)。<br><br>枚举值:`true`(开启)。<br><br>获取CBO详细信息,请参阅[推广系列预算优化](https://ads.tiktok.com/marketing_api/docs?id=1739381757818881)。<br><br><p><span style="color:darkred"><b>注意</b></span>:在商品来源为商品库的视频购物广告中使用 CBO 目前为白名单功能。如需使用此功能,请联系您的TikTok销售代表。|
|budget_mode {+条件必填}|string| 当`objective_type`为<strong>非</strong>`RF_REACH`时,`budget_mode`必填。<br>当`objective_type`为`RF_REACH`时,`budget_mode`仅支持`BUDGET_MODE_INFINITE`。<br><br>预算类型。<br><br>开启推广系列预算优化时,推广系列层级的`budget_mode`支持以下枚举值:<ul><li>`BUDGET_MODE_TOTAL`:总预算。</li><li>`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`:动态日预算,即一周七日的平均预算。单日实际消耗不超过设定的七日平均预算的125%。周消耗不会超过七日平均预算*7。<ul><li>`objective_type`设置为`TRAFFIC`,`APP_PROMOTION`,`WEB_CONVERSIONS`,`LEAD_GENERATION`,`PRODUCT_SALES`(仅视频购物广告),`REACH`,`VIDEO_VIEWS` 或 `ENGAGEMENT`且您不想设置总预算时,将本字段设置为`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`。<br><p><span style="color:darkred"><b>注意</b></span>:为推广目标为`REACH`,`VIDEO_VIEWS` 或 `ENGAGEMENT` 的推广系列启用 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET` 目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</li></ul></li><li>`BUDGET_MODE_DAY`:日预算。<ul><li>`objective_type` 设置为`REACH`,`VIDEO_VIEWS` 或 `ENGAGEMENT`时,推荐您使用动态日预算(`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`)而非日预算(`BUDGET_MODE_DAY`)。</li></ul></li></ul><br>未开启推广系列预算优化时,推广系列层级的`budget_mode`支持以下枚举值:<ul><li>`BUDGET_MODE_INFINITE`:不限预算。</li><li>`BUDGET_MODE_TOTAL`:总预算。</li><li>`BUDGET_MODE_DAY`:日预算。<br><p><span style="color:darkred"><b>注意</b></span>:未开启推广系列预算优化的推广系列中,`BUDGET_MODE_DAY`对于推广目标 `REACH`,`VIDEO_VIEWS` 和 `ENGAGEMENT` 已废弃。</li></ul><br>了解如何设置预算类型,请参阅[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。|
|budget {+条件必填}|float| 当 `budget_mode` 为 `BUDGET_MODE_DAY` 或 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`或`BUDGET_MODE_TOTAL` 时必填。<br><br>推广系列预算。<br><br>欲了解最低预算以及如何设置预算类型,请参阅[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。欲直接获取某一币种对应的每日预算取值范围,请参阅[币种-每日预算取值范围](https://ads.tiktok.com/marketing_api/docs?id=1737585839634433)。 |
| rta_id | string | 实时 API ID,即实时 API 策略标识符。 <br><br>若想获取与您的广告账户绑定的实时 API ID,请联系您的 TikTok 销售代表。<br>若想了解为广告启用实时 API 的前提及启用步骤,请查看[实时 API](1805437148769281.html)。<br> <br><p><span style="color:darkred"><b>注意</b></span>:为广告启用实时 API 目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。您需首先完成实时 API 的入门流程,具备接收发送至您的系统的实时 API 请求并进行回复的能力。 |
| rta_bid_enabled | boolean | 是否使用实时 API 出价。<br><br> 支持的值:<ul><li> `true`:启用。</li><li> `false`:不启用。</li></ul> 默认值:`false`。<br><br> 仅在同时满足以下条件时支持将本字段设置为 `true`:<ul><li> `objective_type` 为 `APP_PROMOTION`、`WEB_CONVERSIONS` 或 `PRODUCT_SALES`。</li><li> 传入了 `rta_id`。</li></ul> <br><p><span style="color:darkred"><b>注意</b></span>: 启用实时 API 出价目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。 |
| rta_product_selection_enabled | boolean | 是否使用实时 API 自动选择商品。<br><br> 枚举值:<ul><li> `true`:使用。</li><li>`false`:不使用。</li></ul> 默认值: `false`。 <br><br> 仅在满足以下条件时支持将本字段设置为`true`: <ul><li>`objective_type` 设置为 `PRODUCT_SALES`。</li><li>`campaign_product_source` 设置为 `CATALOG`。</li><li>传入了 `rta_id` 。</li></ul>|
|operation_status  |string|<p><span style="color:darkred"><b>注意</b></span><ul><li>对于覆盖和频次推广系列,需将`operation_status`设置为`ENABLE`,或不传入`operation_status`,请不要将`operation_status`设置为`DISABLE`。</li></ul> <br>推广系列创建时的启用/关闭状态。枚举值:<ul><li>`ENABLE` : 推广系列创建时处于启用状态。</li><li>`DISABLE` : 推广系列创建时处于关闭状态。</li></ul> 默认值:`ENABLE`。<br>若想在推广系列创建后更新其启用/关闭状态,请使用[/campaign/status/update/](https://ads.tiktok.com/marketing_api/docs?id=1739320994354178)接口。|
| postback_window_mode | string | 仅当 `campaign_type` 设置为`IOS14_CAMPAIGN`且`operation_status` 设置为 `DISABLE`时生效。<br><br> 本字段支持在创建暂停状态的推广系列时指定,或在通过[/campaign/status/update/](https://ads.tiktok.com/marketing_api/docs?id=1739320994354178)接口暂停现有推广系列时指定。推荐做法为在暂停现有推广系列时指定本字段。 <br><br>选定的模式决定您想要确保能接收到的 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>若想了解 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>若您已为应用启用了 SKAN 4.0,需定向 iOS 16.1 及以上版本的设备,从而确保能够接收 SKAN 4.0 的回传。若您想仅定向 iOS 16.1 及以上版本的设备,可在广告组层级将 `min_ios_version` 设置为 `16.1` 。</li> </ul>|
|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/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "objective_type": "TRAFFIC",
    "campaign_name": "{{campaign_name}}",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}}
}'
(/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| 推广目标,<br><br>获取枚举值,参阅[枚举值-推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#| app_promotion_type | string | 应用推广类型。<br><br>枚举值:<ul><li>`APP_INSTALL`:应用安装。让新用户安装您的应用。</li><li>`APP_RETARGETING`:应用再营销。重新吸引现有用户在您的应用中执行操作。</li><li>`APP_PREREGISTRATION`:应用预注册。让新用户在您的应用发布前完成预注册。</li></ul>|
#|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> |
#|is_new_structure|boolean|推广系列是否为新结构(对于同一个推广系列,其推广系列、广告组和广告的结构是相同的)。|
#|objective|string| 推广类型(应用或落地页)。枚举值: `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": {
        "operation_status": "ENABLE",
        "modify_time": "{{modify_time}}",
        "create_time": "{{create_time}}",
        "campaign_id": "{{campaign_id}}",
        "roas_bid": 0,
        "campaign_name": "{{campaign_name}}",
        "campaign_type": "REGULAR_CAMPAIGN",
        "is_new_structure": true,
        "advertiser_id": "{{advertiser_id}}",
        "is_smart_performance_campaign": false,
        "objective": "LANDING_PAGE",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "budget": {{budget}},
        "objective_type": "TRAFFIC",
        "deep_bid_type": null
    }
}
(/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 每日平台更新简报 →