获取升级版 Smart+ 推广系列
此接口可用于获取广告账号内的升级版 Smart+ 推广系列。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/get/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](1738373164380162.html)接口获取。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|fields|string[]|你想要获取的字段。<br><br>不传入时，默认返回所有字段。<br><br>参见<a href="#item-link-返回">返回</a>小节中 `list` 下的字段，了解允许的字段。|
|page|integer|当前页码。<br><br>默认值：1。<br>值范围：≥ 1。|
|page_size|integer|页面大小。<br><br>默认值：10。<br>值范围：1-1,000。|
|filtering|object|筛选条件。<br><br>示例：`filtering={"objective_type":"APP_PROMOTION"}`|
#|campaign_ids|string[]|按推广系列 ID 筛选。<br><br>最大数量：100。|
#|campaign_name|string|按推广系列名称筛选。<br><br>支持模糊匹配。|
#|primary_status|string|一级状态。<br><br>枚举值参见[枚举值 - 一级状态](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-一级状态)。|
#|secondary_status|string|按推广系列二级状态筛选。<br><br>枚举值参见[枚举值 - 推广系列状态 - 二级状态](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-推广系列状态 )。|
#|objective_type|string|按推广目标筛选。<br><br>枚举值参见[枚举值 - 推广目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-推广目标)。|
#| sales_destination | string | 销售目标页面，即你希望提升销量的目标页面。<br><br>枚举值：<ul><li>`WEBSITE`：网站。提升你的网站上的销量。</li><li>`APP`：应用。提升你的应用上的销量（需要商品库）。</li><li>`WEB_AND_APP`：网站和应用。提升你的网站和应用上的销量。</li></ul>|
#|creation_filter_start_time|string|最早推广系列创建时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC 时间）。此筛选条件将检索在该时间之后创建的推广系列。<br><br>示例：`2025-01-01 00:00:01`。<br><br>如果不传入 `creation_filter_start_time` 和 `creation_filter_end_time`，结果将包含在任意时间创建的推广系列。<br><br><p><span style="color:darkred"><b>注意</b></span>：为确保任务效率和速度，建议将创建时间筛选条件的范围设置在 6 个月以内。|
#|creation_filter_end_time|string|最近推广系列创建时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC 时间）。此筛选条件将检索在该时间之前创建的推广系列。<br><br>示例：`2025-02-01 00:00:01`。<br><br>如果不传入 `creation_filter_start_time` 和 `creation_filter_end_time`，结果将包含在任意时间创建的推广系列。<br><br><p><span style="color:darkred"><b>注意</b></span>：为确保任务效率和速度，建议将创建时间筛选条件的范围设置在 6 个月以内。|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/get/?advertiser_id={{advertiser_id}}&page=1&page_size=1000' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code|number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|list|object[]|升级版 Smart+ 推广系列列表。|
##|advertiser_id|string|广告主 ID。|
##|campaign_id|string|推广系列 ID。|
##|create_time|string|推广系列创建时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC 时间）|
##|modify_time|string|推广系列最后修改时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC 时间）|
##|objective_type|string|推广目标。<br><br>枚举值参见[枚举值 - 推广目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-推广目标)。|
##|app_promotion_type|string|应用推广类型。<br><br>枚举值：<ul><li>`APP_INSTALL`：应用安装。吸引新用户安装你的应用。</li><li>`APP_RETARGETING`：应用再营销。重新吸引现有应用用户在你的应用中采取行动。</li><li>`MINIS`：TikTok Mini 或系列。通过优化自然流量和广告流量，推广你的系列、短剧或小游戏。</li></ul>|
##|sales_destination|string|销售目标页面，即你希望提升销量的目标页面。<br><br>枚举值：<ul><li>`WEBSITE`：网站。提升你的网站上的销量。</li><li>`APP`：应用。提升你的应用上的销量（需要商品库）。</li><li>`WEB_AND_APP`：网站和应用。提升你的网站和应用上的销量。</li></ul>|
##|campaign_type|string|推广系列类型。<br><br>目前，我们支持 `REGULAR_CAMPAIGN` 和 `IOS14_CAMPAIGN`。|
##|app_id|string|待推广应用的 ID。<br><br>若想获取应用 ID 列表，需使用 [/app/list/](1740859313270786.html) 接口。|
##|gaming_ad_compliance_agreement|string|是否同意 TikTok 游戏广告主合规保证政策。<br><br>政策如下：你确认并证明，你希望在 TikTok 上推广的任何游戏应用、产品或服务（游戏），包括任何相关的 URL，均 (a) 符合可访问或玩该游戏的司法管辖区的所有适用法律和法规，并且可以根据要求提供支持文件来证明该游戏不属于非法赌博或博彩；以及 (b) 过去和现在均未经受任何关于该游戏的合法性或合规性的调查或诉讼。<br><br>枚举值： <ul><li>`ON`：同意该政策。</li><li>`OFF`：不接受该政策。</li></ul>|
##|is_advanced_dedicated_campaign|boolean|推广系列是否为高级专属推广系列。高级专属推广系列利用可从实时信号中获益的高级投放模型。<br><br>支持的值：`true`、`false`。<br><br>默认情况下，已启用 iOS 14 专属推广系列设置的升级版 Smart+ 应用推广系列均为高级专属推广系列。|
##|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指标)。详细了解 [SAN 集成](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`：SAN。</li><li>`SKAN`：SKAN。</li></ul>|
##|campaign_app_profile_page_state|string|表示应用介绍页的状态。<br><br>枚举值：`ON`、`OFF`。|
##|catalog_enabled|boolean|是否使用商品库，从而根据用户的独特兴趣、意向和行为自动向其推广相关商品或服务。<br><br>支持的值：`true`、`false`。|
##|catalog_type|string|商品库类型。<br><br>枚举值： <ul><li>`ECOMMERCE`：电商。</li><li>`TRAVEL_ENTERTAINMENT`：旅行和娱乐。</li><li>`MINI_SERIES`：短剧。</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|是否已启用 CBO。<br><br>支持的值：`true`（已启用）、`false`（未启用）。|
##|budget_mode|string|预算模式。<br><br><ul><li>当 `budget_optimize_on` 为 `true` 或不传入时，枚举值为：<ul><li>`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`：推广系列动态日预算。即一周内的平均日预算。日消耗不会超过平均日预算的 125%。周消耗不会超过平均日预算的 7 倍。</li><li>`BUDGET_MODE_TOTAL`：推广系列总预算。</li></ul></li><li>当 `budget_optimize_on` 为 `false` 时，枚举值为：<ul><li>`BUDGET_MODE_INFINITE`：该推广系列下的所有广告组没有预算限制。</li><li>`BUDGET_MODE_DAY`：该推广系列下的所有广告组有日预算限制。</li><li>`BUDGET_MODE_TOTAL`：此推广系列下的所有广告组有总预算限制。</li></ul></li></ul>|
##|budget_auto_adjust_strategy |string|仅在满足以下全部条件时返回：<ul><li>`budget_optimize_on` 为 `true` 或不传入。</li><li>`budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`。</li><li>`app_promotion_type` 不为 `MINIS`。</li></ul><br>推广系列预算策略为自动推广系列预算。<br><br>枚举值： <ul><li>`AUTO_BUDGET_INCREASE`：启用基于目标增加预算功能。允许系统在广告效果出色且满足目标 CPA、第 0 天目标 ROAS 和预算要求时自动增加预算。 <ul><li>当 `budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时，传入的 `budget` 将作为初始日预算。如果你的预算利用率至少达到 90%，日预算将自动增加 20%，每天最多可增加 10 次。你的日预算将在每天重置为原来的日预算。</li></ul></li><li>`UNSET`：关闭基于目标增加预算功能。</li></ul>|
##|budget|float|<ul><li>当 `budget_optimize_on` 为 `true` 或不传入时，此字段表示固定推广系列预算或初始推广系列预算。<ul><li>当 `budget_auto_adjust_strategy` 为 `UNSET` 时，此字段表示固定推广系列预算。</li><li>当 `budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时，此字段表示初始推广系列预算。若想获取当前的推广系列预算，请查看返回的 `current_budget`。</li></ul></li><li>当 `budget_optimize_on` 为 `false` 时，此字段表示该推广系列下所有广告组的预算限制。<ul><li>当 `budget_mode` 为 `BUDGET_MODE_DAY` 时，此字段表示该推广系列下所有广告组的日预算限制。</li><li>当 `budget_mode` 为 `BUDGET_MODE_TOTAL` 时，此字段表示该推广系列下所有广告组的总预算限制。</li></ul></li></ul>|
##|current_budget|float|仅当 `budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时返回。<br><br>已启用基于目标增加预算功能的推广系列的当前预算。|
##|operation_status|string|操作状态。<br><br>枚举值：<ul><li>`ENABLE`：推广系列已启用（处于“开启”状态）。</li><li>`DISABLE`：推广系列未启用（处于“关闭”状态）。</li></ul>|
##|secondary_status|string|推广系列二级状态。<br><br>枚举值参见[枚举值 - 推广系列状态 - 二级状态](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-推广系列状态)。|
##|smart_plus_adgroup_mode|string|推广系列的广告组模式。<br><br>枚举值：<ul><li>`SINGLE`：仅可在推广系列内创建一个广告组。</li><li>`MULTIPLE`：仅可在推广系列内创建多个广告组。</li></ul>|
##|postback_window_mode|string|回传窗口期模式，用于确定你希望保障的 SKAN 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`：此模式保障全部 3 次回传，对应 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。参见[如何在 TikTok 广告管理平台上设置应用归因](https://ads.tiktok.com/help/article/set-up-app-attribution-tiktok-ads-manager)文档，了解如何为应用设置 MMP 监测。参见[关于 SKAN 4.0 和 TikTok](https://ads.tiktok.com/help/article/about-skan-4-0-and-tiktok) 和[如何迁移到 SKAN 4.0](https://ads.tiktok.com/help/article/how-to-transition-to-skan-4-0) 文档，详细了解如何将应用迁移到 SKAN 4.0。|
##|po_number|string|PO（采购订单）号。<br><br>PO 号用于监测发票和对账。<br><br>[详细了解月度发票上的 PO 号](https://ads.tiktok.com/help/article/update-po-number-on-monthly-invoices)。|
##|is_promotional_campaign|boolean|是否使用“大型娱乐推广”推广系列设置。<br><br>启用此功能，可激活专为推广院线上映和流媒体服务打造的专属推广系列设置流程和优化。<br><br>支持的值：`true`、`false`。|
##|rta_id|string|实时 API (RTA) ID，即 RTA 策略识别 ID。|
##|rta_bid_enabled|boolean|是否使用 RTA 出价。<br><br>支持的值：<ul><li>`true`：已启用。</li><li>`false`：未启用。</li></ul>|
##|rta_product_selection_enabled|boolean|是否使用 RTA 来自动选择商品。<br><br>枚举值：<ul><li>`true`：已启用。</li><li>`false`：未启用。</li></ul>|
#|page_info|object|分页信息。|
##|page|number|当前页码。|
##|page_size|number|页面大小。|
##|total_number|number|结果总数。|
##|total_page|number|结果总页数。|
示例
(code Success-Response http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"list": [
{
"advertiser_id": "{{advertiser_id}}",
"budget": {{budget}},
"budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
"budget_optimize_on": true,
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"catalog_enabled": false,
"create_time": "{{create_time}}",
"modify_time": "{{modify_time}}",
"objective_type": "LEAD_GENERATION",
"operation_status": "ENABLE",
"secondary_status": "CAMPAIGN_STATUS_ENABLE",
"smart_plus_adgroup_mode": "MULTIPLE"
},
{
"advertiser_id": "{{advertiser_id}}",
"budget": {{budget}},
"budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
"budget_optimize_on": true,
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"campaign_type": "REGULAR_CAMPAIGN",
"create_time": "{{create_time}}",
"modify_time": "{{modify_time}}",
"objective_type": "WEB_CONVERSIONS",
"operation_status": "ENABLE",
"sales_destination": "WEBSITE",
"secondary_status": "CAMPAIGN_STATUS_ENABLE",
"smart_plus_adgroup_mode": "MULTIPLE"
},
{
"advertiser_id": "{{advertiser_id}}",
"budget": {{budget}},
"budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
"budget_optimize_on": true,
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"campaign_type": "REGULAR_CAMPAIGN",
"catalog_enabled": true,
"catalog_type": "TRAVEL_ENTERTAINMENT",
"create_time": "{{create_time}}",
"modify_time": "{{modify_time}}",
"objective_type": "WEB_CONVERSIONS",
"operation_status": "ENABLE",
"sales_destination": "WEBSITE",
"secondary_status": "CAMPAIGN_STATUS_ENABLE",
"smart_plus_adgroup_mode": "MULTIPLE"
},
{
"advertiser_id": "{{advertiser_id}}",
"app_promotion_type": "APP_INSTALL",
"budget": {{budget}},
"budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
"budget_optimize_on": true,
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"campaign_type": "REGULAR_CAMPAIGN",
"create_time": "{{create_time}}",
"modify_time": "{{modify_time}}",
"objective_type": "APP_PROMOTION",
"operation_status": "ENABLE",
"secondary_status": "CAMPAIGN_STATUS_ENABLE",
"smart_plus_adgroup_mode": "SINGLE"
}
],
"page_info": {
"page": 1,
"page_size": 1000,
"total_number": 4,
"total_page": 1
}
}
}
(/code)