← 返回目录
📁 Appendix

枚举值

广告主

广告账户账单类型

|值 {50%}|描述 {50%}|
|---|---|
|TRANS_TYPE_TRANSFER|转账|
|TRANS_TYPE_TAX|税|
|TRANS_TYPE_COST|消耗|

广告账户展示状态 (advertiser_status)

|值 {50%}|描述 {50%}|
|---|---|
|SHOW_ACCOUNT_STATUS_NOT_APPROVED|未通过|
|SHOW_ACCOUNT_STATUS_APPROVED|已通过|
|SHOW_ACCOUNT_STATUS_IN_REVIEW|审核中|
|SHOW_ACCOUNT_STATUS_PUNISHED|惩罚中|

广告主角色

|值 {50%}|描述 {50%}|
|---|---|
|ROLE_ADVERTISER|普通广告主(直客)|
|ROLE_CHILD_ADVERTISER|普通广告主(代理商子客户)|
|ROLE_CHILD_AGENT|二级代理商|
|ROLE_AGENT|一级代理商|

广告主状态

|值 {50%}|描述 {50%}|
|---|---|
|STATUS_DISABLE|该广告账户已关户|
|STATUS_PENDING_CONFIRM|申请待审核|
|STATUS_PENDING_VERIFIED|待验证|
|STATUS_CONFIRM_FAIL|审核不通过|
|STATUS_ENABLE|审核通过|
|STATUS_CONFIRM_FAIL_END|CRM审核不通过|
|STATUS_PENDING_CONFIRM_MODIFY|修改待审核|
|STATUS_CONFIRM_MODIFY_FAIL|修改审核不通过|
|STATUS_LIMIT|用户被惩罚|
|STATUS_WAIT_FOR_BPM_AUDIT|等待CRM审核|
|STATUS_WAIT_FOR_PUBLIC_AUTH|待对公验证|
|STATUS_SELF_SERVICE_UNAUDITED|自助开户待验证资质|
|STATUS_CONTRACT_PENDING|合同未生效|

商务中心状态

|值{50%}|描述{50%}|
|---|---|
|REVIEWING|审核中|
|DENY|已拒绝|
|ENABLE|已通过|
|PUNISH|已禁用|

商务中心类型

|值 {50%}|描述 {50%}|
|---|---|
|NORMAL|普通商务中心|
|DIRECT|非自助直客商务中心|
|AGENCY|非自助代理商商务中心|
|SELF_SERVICE|自助直客商务中心|
|SELF_SERVICE_AGENCY|自助代理商商务中心|

广告管理

广告投放速度类型 (pacing)

|值 {50%}|描述 {50%}|
|---|---|
|PACING_MODE_SMOOTH|标准,预算将在预定的广告投放时间内分配|
|PACING_MODE_FAST|加速,尽可能快的产生结果及消耗预算|

广告组二级状态

注意
请查看一级状态下所支持的二级状态 ,了解对于所指定的一级状态,您可以通过/adgroup/get/传入的二级状态。

| 值 {40%} | 描述 {60%} |
| ---| ---|
|ADGROUP_STATUS_ALL|所有包含已删除|
|ADGROUP_STATUS_NOT_DELETE|所有不含已删除|
|竞价广告||
#|ADGROUP_STATUS_DELETE|已删除|
#|ADGROUP_STATUS_CAMPAIGN_DELETE|推广系列删除|
#|ADGROUP_STATUS_ADVERTISER_AUDIT_DENY|广告主审核未通过|
#|ADGROUP_STATUS_ADVERTISER_AUDIT|广告主审核中|
#|ADVERTISER_CONTRACT_PENDING|广告主合同未生效|
#|ADVERTISER_ACCOUNT_PUNISH|广告主账号被惩罚|
#|ADGROUP_STATUS_CAMPAIGN_EXCEED|推广系列超出预算|
#|ADGROUP_STATUS_BUDGET_EXCEED|广告组超出预算|
#|ADGROUP_STATUS_BALANCE_EXCEED|广告主余额不足|
#| ADGROUP_STATUS_ADGROUP_PRE_ONLINE | 广告组处于预上线状态,尚未开始投放。   |
#|ADGROUP_STATUS_AUDIT_DENY|广告组审核拒绝|
#|ADGROUP_STATUS_REAUDIT|修改审核|
#|ADGROUP_STATUS_AUDIT|新建审核|
#|ADGROUP_STATUS_CREATE|计划新建|
#|ADGROUP_STATUS_FROZEN|广告组被冻结|
#|ADGROUP_STATUS_NOT_START|未到投放时间|
#|ADGROUP_STATUS_LIVE_NOT_START|已到投放时间但直播未开始。该状态为竞价广告组状态。|
#|ADGROUP_STATUS_CAMPAIGN_DISABLE|推广系列暂停|
#|ADGROUP_STATUS_DISABLE|暂停|
#|ADGROUP_STATUS_SHADOW_ADGROUP_REAUDIT|重新审核中|
#|ADGROUP_STATUS_PIXEL_UNBIND|广告组绑定的Pixel已解绑|
#|ADGROUP_STATUS_PARTIAL_AUDIT_NO_DELIVERY|广告组部分审核中,且不在投放中|
#|ADGROUP_STATUS_PARTIAL_AUDIT_DELIVERY_OK|广告组部分审核中,且在投放中|
#|ADGROUP_STATUS_INDUSTRY_QUALIFICATION_MISSING|待补充行业资质|
#|ADGROUP_STATUS_INDUSTRY_QUALIFICATION_EXPIRED|行业资质已过期|
#|ADGROUP_STATUS_INDUSTRY_QUALIFICATION_DENY|行业资质不通过|
#|ADGROUP_STATUS_ASSET_AUTHORIZATION_LOST|广告组资产无授权。<br><br><p><span style="color:darkred"><b>注意</b></span>:本状态不可用于筛选广告组。|
#|ADGROUP_STATUS_TRANSCODING_FAIL|广告组视频转码失败。<br><br><p><span style="color:darkred"><b>注意</b></span>:本状态不可用于筛选广告组。|
#|ADGROUP_STATUS_ADGROUP_QUOTA_LIMIT|广告账户下无空余广告组投放配额。 <br>如欲新建在投状态的广告组,需先暂停或删除处于“投放中”或“审核中“状态的广告组。<br><br><p><span style="color:darkred"><b>注意</b></span>:本状态不可用于筛选广告组。|
#| ADGROUP_STATUS_IDENTITY_USED_BY_GMV_MAX_AD | 您想用在该广告组内某个广告中的认证身份(发布身份)不可用,因为该身份已被另一优化目标为最大成交额(`optimization_goal` =`GMV`)的广告使用。 |
#| ADGROUP_STATUS_SEARCH_KEYWORDS_IN_REVIEW | 该搜索推广系列中的广告组的所有关键词均在审核中。 |
#| ADGROUP_STATUS_SEARCH_KEYWORDS_NOT_AVAILABLE | 该搜索推广系列中的广告组的所有关键词均未通过审核,或未设置关键词。 |
#| ADGROUP_STATUS_SEARCH_KEYWORDS_PARTIAL_APPROVED | 该搜索推广系列中的广告组的部分关键词通过审核,其他关键词仍在审核中或未通过审核。 |
|竞价广告或覆盖和频次广告||
#|ADGROUP_STATUS_DELIVERY_OK|投放中|
#|ADGROUP_STATUS_REVIEW_PARTIALLY_APPROVED|部分广告未通过审核|
#|ADGROUP_STATUS_TIME_DONE|已完成<br><br><p><span style="color:darkred"><b>注意</b></span>:本状态代表该广告组在所设置的投放结束时间结束投放。|
|覆盖和频次广告||
#|ADGROUP_STATUS_RF_DEDUCTION_FAILED|预扣费失败|
#|ADGROUP_STATUS_RF_NO_VALID_CREATIVE|无有效创意|
#|ADGROUP_STATUS_RF_CLOSED_OTHERS|广告组已关闭|
#|ADGROUP_STATUS_RF_SHORT_BALANCE|账户余额不足扣款|
#|ADGROUP_STATUS_RF_BOOKING|预算/库存已预定|
#|ADGROUP_STATUS_RF_NO_DELIVERY_CREATIVE|无创意可投|
#|ADGROUP_STATUS_RF_SCHEDULE|已排期|
#|ADGROUP_STATUS_RF_TERMINATE|广告组已终止|
#|ADGROUP_STATUS_RF_AD_AUDIT_DENY|覆盖和频次广告创意审核未通过|
#|ADVERTISER_ACCOUNT_INVALID|广告账户无效|
#|ADGROUP_STATUS_RF_ADGROUP_INVALID|覆盖和频次广告组不存在或为其他异常状态|
#|ADGROUP_STATUS_RF_WITHDRAW_ORDER|覆盖和频次推广已撤单|
#|ADGROUP_STATUS_RF_TIME_DONE|覆盖和频次广告组已完成<br><br><p><span style="color:darkred"><b>注意</b></span>:本状态代表该覆盖和频次广告组由于预算不足或账户余额不足,在所设置的投放结束时间前结束了投放。|
| 内容加热广告 | |
#| ADGROUP_STATUS_PROMOTE_AD_NOT_APPROVED | 内容加热广告组中的一个或多个创意未通过审核 |
#| ADGROUP_STATUS_PROMOTE_WITHDRAW_ORDER | 内容加热订单已撤销 |

广告组审核申诉状态 (appeal_status)

|值 {50%}|描述 {50%}|
|---|---|
|NOT_APPEALED|未申诉|
|APPEALING|申诉中|
|APPEAL_SUCCESSFUL|申诉成功|
|APPEAL_FAILED|申诉失败|
|APPEAL_DONE|申诉完成。申诉成功后,广告被重新审核,审核结果覆盖了申诉结果|

广告二级状态

注意
请查看一级状态下所支持的二级状态 ,了解对于所指定的一级状态,您可以通过/ad/get/传入的二级状态。

| 值 {40%} | 描述 {60%} |
| --- | --- |
|AD_STATUS_ALL|所有包含已删除|
|AD_STATUS_NOT_DELETE|所有不含已删除|
|AD_STATUS_CAMPAIGN_DELETE|推广系列已删除|
|AD_STATUS_ADGROUP_DELETE|广告组已删除|
|AD_STATUS_DELETE|已删除|
|AD_STATUS_ADVERTISER_AUDIT_DENY|账号审核拒绝|
|AD_STATUS_ADVERTISER_AUDIT|账号审核中|
|ADVERTISER_CONTRACT_PENDING|广告主合同未生效|
|ADVERTISER_ACCOUNT_PUNISH|广告主账号被惩罚|
|AD_STATUS_BALANCE_EXCEED|广告账号余额不足|
|AD_STATUS_CAMPAIGN_EXCEED|推广系列超出预算|
|AD_STATUS_BUDGET_EXCEED|广告组超出预算|
| AD_STATUS_AD_PRE_ONLINE | 广告处于预上线状态,尚未开始投放。   |
|AD_STATUS_AUDIT|审核中|
|AD_STATUS_REAUDIT|修改审核中|
|AD_STATUS_AUDIT_DENY|审核拒绝|
|AD_STATUS_ADGROUP_AUDIT_DENY|广告组审核拒绝|
|AD_STATUS_ADGROUP_PARTIAL_AUDIT_NO_DELIVERY|广告组部分审核中,且不在投放中|
|AD_STATUS_REVIEW_PARTIALLY_APPROVED | 当前广告创意存在拒审情况 |
|AD_STATUS_PARTIAL_AUDIT_DELIVERY_OK|广告部分审核中,且在投放中|
|AD_STATUS_PARTIAL_AUDIT_NO_DELIVERY|广告部分审核中,且不在投放中|
|AD_STATUS_ADGROUP_INDUSTRY_QUALIFICATION_MISSING|待补充行业资质|
|AD_STATUS_ADGROUP_INDUSTRY_QUALIFICATION_EXPIRED|行业资质已过期|
|AD_STATUS_ADGROUP_INDUSTRY_QUALIFICATION_DENY|行业资质不通过|
|AD_STATUS_MUSIC_AUTHORIZATION_MISSING|待补充音乐资质|
|AD_STAUS_PIXEL_UNBIND|广告绑定的Pixel已解绑|
|AD_STATUS_LIVE_OFFLINE|直播未开始|
|AD_STATUS_NOT_START|未到投放时间|
|AD_STATUS_DONE|已完成|
|AD_STATUS_CAMPAIGN_DISABLE|推广系列暂停|
|AD_STATUS_ADGROUP_DISABLE|广告组暂停|
|ADGROUP_STATUS_FROZEN|广告组被冻结|
|AD_STATUS_DISABLE|广告暂停|
|AD_STATUS_DELIVERY_OK|投放中|
|AD_STATUS_PROCESS_AUDIO|抽声进行中<br><p><span style="color:darkred"><b>注意</b></span>:若二级状态长时间显示为 `AD_STATUS_PROCESS_AUDIO` (前端状态提示“音频处理中,如果此状态持续时间过长,请重新上传素材。”) , 请上传带音频的新视频进行重试。|
|AD_STATUS_TRANSCODING_FAIL|广告视频转码失败。<br><p><span style="color:darkred"><b>注意</b></span>:本状态不可用于筛选广告。|
|AD_STATUS_ADGROUP_ASSET_AUTHORIZATION_LOST|广告组资产无授权。<br><p><span style="color:darkred"><b>注意</b></span>:本状态不可用于筛选广告。|
|AD_STATUS_ASSET_AUTHORIZATION_LOST|广告资产无授权。<br><p><span style="color:darkred"><b>注意</b></span>:本状态不可用于筛选广告。|
|AD_STATUS_AD_QUOTA_LIMIT|广告对应的广告组因广告账户下无空余广告组投放配额而暂停。 <br>如欲新建在投状态的广告,需先暂停或删除处于“投放中”或“审核中“状态的广告组,然后在新建的广告组下创建广告。<br><p><span style="color:darkred"><b>注意</b></span>:本状态不可用于筛选广告。|
| AD_STATUS_PRODUCT_UNAVAILABLE | 您想用在该广告中的商品不可用 |
| AD_STATUS_ANCHOR_UNAVAILABLE| 您想用在该广告中的商品链接不可用 |
| AD_STATUS_NO_AUTHORIZATION_OF_SHOWCASE | 与您想用在该广告中的橱窗绑定的认证身份( 发布身份)不可用|
|AD_STATUS_RF_ADGROUP_CLOSED|覆盖和频次广告组已关闭|
| AD_STATUS_PROMOTE_AD_OFFLINE_AUDIT | 内容加热广告中的一个或多个创意未通过审核 |
| AD_STATUS_PROMOTE_ADGROUP_CLOSED | 内容加热广告组已关闭 |

推广目标 (objective_type)

| 值 {40%} | 描述 {60%} |
| --- | --- |
| APP_PROMOTION | 应用推广。吸引用户安装您的移动应用,并再次吸引应用的已有用户。 |
|WEB_CONVERSIONS |网站转化量。引导用户前往您的网站或即时体验页面采取特定行动,例如购买商品或将商品加入购物车。 |
| APP_INSTALL {-已废弃}| 应用安装量,吸引更多用户安装您的应用。<br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>新目标应用推广下后续将支持更多新功能,旧目标应用安装量下则不会支持新功能。我们建议您使用新的推广目标[应用推广](https://ads.tiktok.com/marketing_api/docs?id=1747553433902082)。</li><li>现有创建于2023年10月27日以前的应用安装量广告将不受影响,预算用尽前将始终保持有效。您可以随时终止或删除这些推广系列、广告组、广告及程序化创意广告。</li></ul> |
| CONVERSIONS{-已废弃} | 转化量,吸引用户在您的网站/应用中执行更多有价值的操作。<br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>新目标网站转化量下后续将支持更多新功能,旧目标转化量下则不会支持新功能。我们建议您使用新的推广目标[网站转化量](https://ads.tiktok.com/marketing_api/docs?id=1747553507237889)。</li><li>现有创建于2023年10月27日以前的转化量广告将不受影响,预算用尽前将始终保持有效。您可以随时终止或删除这些推广系列、广告组、广告及程序化创意广告。</li></ul>|
| REACH | 竞价覆盖。<br>向尽可能多的用户展示竞价广告。 |
|BRAND_CONSIDERATION|品牌意向。 获取对您的品牌表现出兴趣的意向受众。<br><br><p><span style="color:darkred"><b>注意</b></span>:目前,不支持通过 API 创建品牌意向推广系列。本枚举值仅可用于 [/campaign/get/](1739315828649986.html),作为请求中 `objective_type` 的筛选值或返回中品牌意向推广系列的标识符。|
| TRAFFIC | 访问量,吸引更多用户访问您的目标网站或应用。 |
| VIDEO_VIEWS | 视频播放量,吸引更多用户观看视频。 |
| CATALOG_SALES(白名单功能)<br>{-已废弃} | 目录促销,吸引用户在商品库中购买您的商品<br>注意:自2023年2月16日起,您将不能创建目录促销目标下的Dynamic Showcase Ads。为保证流畅的API体验,我们建议您创建商品销量目标下的[视频购物广告](https://ads.tiktok.com/marketing_api/docs?id=1741942291730434&rid=tv5sdeafqp)。 |
| PRODUCT_SALES |商品销量,为商业类广告主提供更加简单便捷的投放广告方式,销售来自 TikTok Shop、网站和应用的商品。 <br><br><p><span style="color:darkred"><b>注意</b></span>:[商品来源为商品库的视频购物广告](1750361698613249.html)目前对于商业类的移动应用广告主为白名单功能。若您为商业类的移动应用广告主且需使用此功能,请联系您的 TikTok 销售代表。若您是商业类的网络广告主,您已自动拥有该功能的权限。|
| ENGAGEMENT  | 社区互动,获得更多账号关注或主页访问等 |
| LEAD_GENERATION  | 线索收集,为业务或品牌开发潜在客户 |
| SHOP_PURCHASES {-已废弃}|店铺推广,用于短视频带货或者直播带货|
|RF_APP_INSTALL (白名单功能){-已废弃}| 应用安装量,吸引更多用户安装您的应用, 用于广告 |
| RF_ENGAGEMENT (白名单功能){-已废弃} | 社区互动,获得更多账号关注或主页访问等,用于覆盖和频次广告。 该推广目标目前不支持品牌安全(Brand Safety)|
| RF_REACH (白名单功能) | 合约覆盖和频次或 TikTok Pulse。 <br>向尽可能多的用户展示提前预订的广告保证覆盖人数和展示频次,或以固定的千次展示成本(CPM)在推荐页上排名前 4% 的热门容后面展示的广告。  <br><br><p><span style="color:darkred"><b>注意</b></span>:  <ul><li>若想使用覆盖和频次目标,可使用[/campaign/create/](1739318962329602.html)将 `objective_type` 设置为 `RF_REACH` 且将 `rf_campaign_type` 设置为 `STANDARD`。</li><li>若想使用 TikTok Pulse 目标,可使用[/campaign/create/](1739318962329602.html)将 `objective_type` 设置为 `RF_REACH` 且将 `rf_campaign_type` 设置为 `PULSE`。 </li></ul> |
| TOPVIEW_REACH | 合约 TopView 。  <br>在尽可能多的用户打开应用时展示广告。 <br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>不支持在 [/campaign/get/](1739315828649986.html),[/adgroup/get/](1739314558673922.html) 和 [/ad/get/](1735735588640770.html) 接口中的筛选字段 `objective_type` 指定本枚举值从而筛选 TopView 数据。若想筛选 TopView 推广系列、广告组或广告的数据,需将筛选字段 `buying_types` 设置为 `&#91;"RESERVATION_TOP_VIEW"&#93;`。</li><li>不支持使用 API 创建、更新或复制 TopView 广告,您仅可通过 API 检索已有的 TopView 广告。若想了解 API 中支持的 TopView 广告功能,请查看[ TopView](1804258360285186.html)。 </li></ul>  |
| RF_TRAFFIC(白名单功能)<br>{-已废弃}| 访问量,吸引更多用户访问您的目标网站或应用,用于覆盖和频次广告。该推广目标目前不支持品牌安全(Brand Safety)。<br><p><span style="color:darkred"><b>注意</b></span>:覆盖和频次广告的推广目标视频播放量和访问量于2023年6月1日废弃。2023年6月1日前保存的存量订单可继续投放,同时支持编辑与暂停,但对应的存量广告的投放结束时间需不晚于2024年1月12日。 |
| RF_VIDEO_VIEW (白名单功能)<br>{-已废弃} | 视频播放量,吸引更多用户观看视频 , 用于覆盖和频次广告。<br><p><span style="color:darkred"><b>注意</b></span>:覆盖和频次广告的推广目标视频播放量和访问量于2023年6月1日废弃。2023年6月1日前保存的存量订单可继续投放,同时支持编辑与暂停,但对应的存量广告的投放结束时间需不晚于2024年1月12日。|

受众年龄区间 (age_groups)

|值 {50%}|描述 {50%}|
|---|---|
|AGE_13_17|13-17岁|
|AGE_18_24|18-24岁|
|AGE_25_34|25-34岁|
|AGE_35_44|35-44岁|
|AGE_45_54|45-54岁|
|AGE_55_100|55+|

应用重定向受众类型 (/adgroup/create/接口中的audience_type )

|值 {50%}|描述 {50%}|
|---|---|
|CUSTOM_AUDIENCE|自定义受众。不支持`TRAFFIC`推广目标|
|EXCLUDE_INTERACT_USERS|排除曾与您的应用互动的用户。|
|INCLUDE_INTERACT_USERS|定向曾与您的应用互动的用户|
|INCLUDE_SPECIFIC_EVENTS|定向满足特定规则的受众|
|EXCLUDE_SPECIFIC_EVENTS|排除满足特定规则的受众。|
|NEW_CUSTOM_AUDIENCE|新的自定义受众类型。新建广告组目前唯一支持的应用重定向受众类型|

出价策略 (bid_type)

在创建广告时,您可以指定您的出价策略。每种出价策略适用于不同业务目标,也有各自的利弊。如果您更看重成本稳定性,我们推荐您使用BID_TYPE_CUSTOM,但您可能无法充分有效地花费预算。获取有关不同出价策略的更多信息,请参考出价策略。

|值 {50%}|描述 {50%}|
|---|---|
|BID_TYPE_CUSTOM|手动出价。在TikTok广告管理平台中,该出价策略被称为“成本上限”。|
|BID_TYPE_NO_BID|关闭出价控制,获取最佳的广告投放效果。在TikTok广告管理平台中,该出价策略被称为“最大投放量”。|

计费事件 (billing_event 或 billing_events)

|值 {50%}|描述 {50%}|
|---|---|
|CPC|点击计费|
|CPM|每千人计费|
|CPV|有效播放计费|
|OCPC    已废弃|oCPC(CPA 即 oCPC)|
|GD|保量|
|OCPM|oCPM|

预算类型

具体说明见预算。

| 值 {40%} | 描述 {60%} |
| ---| --- |
| BUDGET_MODE_DAY | 日预算 |
| BUDGET_MODE_DYNAMIC_DAILY_BUDGET(白名单功能)| 动态日预算<br><br><p><span style="color:darkred"><b>注意</b></span>:为推广目标为`REACH`,`VIDEO_VIEWS` 或 `ENGAGEMENT`的推广系列启用 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET` 目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。此外,对于推广目标为`TRAFFIC`,`APP_PROMOTION`,`WEB_CONVERSIONS`,`LEAD_GENERATION`,或`PRODUCT_SALES`(仅视频购物广告)的推广系列,`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`已全量发布。|
| BUDGET_MODE_TOTAL | 总预算 |
| BUDGET_MODE_INFINITE | 不限预算 |

行动引导文案 (call_to_action)

|值 {50%}|描述 {50%}|
|---|---|
|APPLY_NOW|立即申请|
|BOOK_NOW|立即预约|
|CALL_NOW|立即致电|
|CHECK_AVAILABLILITY|查询库存|
|CONTACT_US|联系我们|
|DOWNLOAD_NOW|立即下载|
|EXPERIENCE_NOW|立即体验|
|GET_QUOTE|查看价格|
|GET_SHOWTIMES|查看演出时间|
|GET_TICKETS_NOW|获取门票|
|INSTALL_NOW|立即安装|
|INTERESTED|感兴趣|
|LEARN_MORE|查看详情|
|LISTEN_NOW|马上去听|
|ORDER_NOW|立即下单|
|PLAY_GAME|去玩游戏|
|PREORDER_NOW|立即预定|
|READ_MORE|阅读更多|
|SEND_MESSAGE|发消息|
|SHOP_NOW|去逛逛|
|SIGN_UP|立即注册|
|SUBSCRIBE|订阅|
|VIEW_NOW|立即查看|
|VIEW_PROFILE|浏览主页 (仅支持`ENGAGEMENT`的推广目标)|
|VISIT_STORE|去附近商店看看|
|WATCH_LIVE|观看直播(仅在直播广告中可用)|
|WATCH_NOW|立即观看|
|JOIN_THIS_HASHTAG|参加挑战(仅在覆盖和频次广告中可用)|
|SHOOT_WITH_THIS_EFFECT|马上开拍(仅在覆盖和频次广告中可用)|
|VIEW_VIDEO_WITH_THIS_EFFECT|查看更多相关视频(仅在覆盖和频次广告中可用)|

推广系列二级状态

注意
请查看一级状态下所支持的二级状态 ,了解对于所指定的一级状态,您可以通过/campaign/get/传入的二级状态。

| 值 {40%} | 描述 {60%} |
| --- | --- |
|CAMPAIGN_STATUS_DELETE|已删除|
|CAMPAIGN_STATUS_ADVERTISER_AUDIT_DENY|广告主审核未通过|
|CAMPAIGN_STATUS_ADVERTISER_AUDIT|广告主审核中|
|ADVERTISER_CONTRACT_PENDING|广告主合同未生效|
|ADVERTISER_ACCOUNT_PUNISH|广告主账号被惩罚|
|CAMPAIGN_STATUS_BUDGET_EXCEED|超出预算|
|CAMPAIGN_STATUS_DISABLE|暂停|
|CAMPAIGN_STATUS_AWAITING_RELEASE|等待释放。<br>该 SKAN 4.0 推广系列正在回传数据。为确保报表数据准确性,建议您等待数日,数日后本推广系列的配额将释放。|
| CAMPAIGN_STATUS_IDENTITY_USED_BY_GMV_MAX_AD | 您想用在该推广系列内某个广告中的认证身份(发布身份)不可用,因为该身份已被另一优化目标为最大成交额(`optimization_goal` =`GMV`)的广告使用。 |
|CAMPAIGN_STATUS_ENABLE|投放中|
|CAMPAIGN_STATUS_ALL|所有包含已删除|
|CAMPAIGN_STATUS_NOT_DELETE|所有不含已删除|
| CAMPAIGN_STATUS_TTS_TT_ASSET_UNAVAILABLE| 您的推广系列中使用的素材不可用。请检查推广系列设置。 |
| CAMPAIGN_STATUS_TTS_TT_IDENTITY_UNAVAILABLE | TikTok 账号不可用,请尝试重新关联或选择其他账号创建广告。 |
| CAMPAIGN_STATUS_TIKTOK_SHOP_UNAVAILABLE | 商店已与商务中心账户取消关联。请重新关联商店。 |
| CAMPAIGN_STATUS_REVIEW_DISAPPROVED| 审核失败 |
| CAMPAIGN_STATUS_AD_UNAVAILABLE | 整个推广系列已暂停投放,原因是一个或多个广告组被拒或部分素材不可用。 |
| CAMPAIGN_STATUS_PRODUCT_UNAVAILABLE | 推广系列创建后,所选商品不可用。请前往商家中心管理或添加商品。 |
| CAMPAIGN_STATUS_LIVE_GMV_MAX_AUTHORIZATION_CANCEL | 由于所选官方 TikTok 账号已将 GMV Max 专属授权授予其他广告账号,此推广系列已暂停。 |
| CAMPAIGN_STATUS_PRODUCT_GMV_MAX_AUTHORIZATION_CANCEL | 由于 TikTok Shop 已将 GMV Max 专属授权授予其他广告账号,此推广系列已暂停。 |
|CAMPAIGN_STATUS_IDENTITY_USED_BY_LIVE_GMV_MAX | 由于存在使用此 TikTok 账号创建的投放中的直播 GMV Max 推广系列,此推广系列已暂停。 |
|CAMPAIGN_STATUS_PRODUCT_USED_BY_PRODUCT_GMV_MAX| 由于存在为此商店创建的投放中的商品 GMV Max 推广系列,此推广系列已暂停。 |

网络类型 (network_types)

|值 {50%}|描述 {50%}|
|---|---|
|WIFI|wifi|
|2G|2G|
|3G|3G|
|4G|4G|
|5G|5G|
|unlimited|不限|

转化窗口期 (conversion_window)

|值 {50%}|描述 {50%}|
|---|---|
|ONE_DAY_CLICK|点击后1天内|
|SEVEN_DAY_CLICK|点击后7天内|
|ONE_DAY_CLICK_OR_ONE_DAY_VIEW|点击和观看后1天内|
|SEVEN_DAY_CLICK_OR_ONE_DAY_VIEW|点击后7天内和观看后1天内|

素材类型 (ad_format)

|值 {50%}|描述 {50%}|
|---|---|
|SINGLE_IMAGE|单个图片。|
|SINGLE_VIDEO|单个视频。|
|CAROUSEL   已废弃|多图轮播,支持TopBuzz版位。|
|LIVE_CONTENT|直播内容。仅适用于直播带货(`promotion_type` = `LIVE_SHOPPING`)场景。|
|CAROUSEL_ADS|多图轮播,支持TikTok版位。|

素材类型 (已废弃,此处仅做参考)

|值{20%}|描述{20%}|宽高比{15%}|最小尺寸{15%}|最大尺寸{15%}|建议尺寸{15%}|
|---|---|---|---|---|---|
|IMAGE_MODE_GIF|微动(不支持用于广告的创建及更新)|-|-|-|-|
|IMAGE_MODE_GROUP|组图(不支持用于广告的创建及更新)|-|-|-|-|
|IMAGE_MODE_LARGE|大图|1.91|600 * 314|2400 * 1256|1200 * 628|
|IMAGE_MODE_LARGE_VERTICAL|大图竖版图|0.62|187 * 302|750 * 1208|375 * 604|
|IMAGE_MODE_SMALL|小图(不支持用于广告的创建及更新)|-|-|-|-|
|IMAGE_MODE_BIG_ONE|方形大图|1|320 * 320|1280 * 1280|640 * 640|
|IMAGE_MODE_VIDEO|横版视频|1.78|1280 * 720|2560 * 1400|1280 * 720|
|IMAGE_MODE_VIDEO_SQUARE|方形视频|1|640 * 640|1280 * 1280|640 * 640|
|IMAGE_MODE_VIDEO_VERTICAL|竖版视频|0.56|720 * 1280|1440 * 2560|720 * 1280|
|IMAGE_MODE_UNION_SPLASH_IMAGE|开屏图片|0.56|1080 * 1920|2160 * 3840|-|
|IMAGE_MODE_SEARCH_BIG_IMAGE|搜索大图|2.5|345 * 138|690 * 276||
|IMAGE_MODE_SEARCH_SHOWCASE_IMAGE|搜索橱窗|1.0|109 * 109|109 * 109||
|IMAGE_MODE_SEARCH_SMALL_IMAGE|搜索小图|1.5|108 * 72|432 * 288||
|MULTI_SQUARE_PICTURES|正方形多图图片|1|640*640|640*640|640*640|
|MULTI_RECTANGLE_PICTURES|长方形多图图片|1.91|1200*628|1200*628|1200*628|
|IMAGE_MODE_OTHERS|其他|-|-|-|-|

店铺推广中的创意类型(creative_type)

用于店铺推广场景下的创意类型。当objective_type 为SHOP_PURCHASES时,必须在广告层级传入。

|参数值 {50%}|描述 {50%}|
|---|---|
|SHOP_PDP|短视频带货广告,包含一个商品链接。`ad_format`需要设置为`SINGLE_VIDEO`。|
|SHOP_PLP|短视频带货广告,包含6-50个商品链接。`ad_format`需要设置为`SINGLE_VIDEO`。|
|SHORT_VIDEO_LIVE|短视频推直播间广告。 `ad_format`需要设置为`SINGLE_VIDEO`。|
|DIRECT_LIVE|直播间带货。每个推广只能有一个直播间。`ad_format`需要设置为`LIVE_CONTENT`。|

深层事件出价策略 (deep_bid_type)

通过不同的出价方式优化您的应用内事件

| 值{40%} | 描述{60%} |
| --- | --- |
| DEFAULT | 无深层事件出价 |
| MIN | 双出价。<br>运作方式 - 我们会控制平均成本稳定在您的目标成本上下,包括安装和深层目标成本<br>最适合以下情况 - 对安装成本和深层目标成本均有预期<br>请注意 - 安装量可能低于其他出价策略 |
| PACING | 自动优化。<br>运作方式 - 我们会控制平均安装成本稳定在您的目标成本上下,同时尽可能多获取深层目标事件<br>最适合以下情况 - 对于安装成本有预期,但对于深层目标成本希望系统自动优化<br>请注意 - 深层目标成本可能高于双出价策略 |
|VO_MIN {-已废弃}| 在有成本上限的条件下进行出价。 本出价策略只适用于价值优化目标 (`optimization_goal` = `VALUE`)。详情参见[价值优化](https://ads.tiktok.com/marketing_api/docs?id=1739381743067137)。|
|VO_MIN_ROAS | 在有ROAS目标的条件下出价。 本出价策略只适用于价值优化目标 (`optimization_goal` = `VALUE`)。详情参见[价值优化](https://ads.tiktok.com/marketing_api/docs?id=1739381743067137)。|
|VO_HIGHEST_VALUE | 无限制出价。 本出价策略只适用于价值优化目标 (`optimization_goal` = `VALUE`)。详情参见[价值优化](https://ads.tiktok.com/marketing_api/docs?id=1739381743067137)。|
|AEO|以应用事件优化为目标进行出价。|

性别 (gender)

|值 {50%}|描述 {50%}|
|---|---|
|GENDER_UNLIMITED|不限|
|GENDER_MALE|男性|
|GENDER_FEMALE|女性|

受众语言 (languages)

您可以使用 /tool/language/ 获取最新语言代码列表。

|值 {50%}|描述 {50%}|
|---|---|
|ar|阿拉伯语|
|as|阿萨姆语|
|bgc|哈里亚纳语|
|bh|比哈尔语|
|bn|孟加拉语|
|cs|捷克语|
|de|德语|
|el|希腊语|
|en|英语|
|es|西班牙语|
|fi|芬兰语|
|fr|法语|
|gu|古吉拉特语|
|he|希伯来语|
|hi|印地语|
|hu|匈牙利语|
|id|印尼语|
|it|意大利语|
|ja|日语|
|kn|卡纳达语|
|ko|韩语|
|ml|马拉雅拉姆语|
|mr|马拉地语|
|ms|马来语|
|nl|荷兰语|
|or|奥里亚语|
|pa|旁遮普语|
|pl|波兰语|
|pt|葡萄牙语|
|raj|拉贾斯坦语|
|ro|罗马尼亚语|
|ru|俄语|
|sv|瑞典语|
|ta|泰米尔语|
|te|泰卢固语|
|th|泰语|
|tr|土耳其语|
|uk|乌克兰语|
|vi|越南语|
|zh|简体中文|
|zh-Hant|繁体中文|

最低 Android 版本 (min_android_version)

可以使用/tool/os_version/接口获取最新的操作系统列表。

|值 {50%}|描述 {50%}|
|---|---|
|NONE|不限|
|4.0|Android 4.0|
|4.1|Android 4.1|
|4.2|Android 4.2|
|4.3|Android 4.3|
|4.4|Android 4.4|
|5.0|Android 5.0|
|5.1|Android 5.1|
|6.0|Android 6.0|
|7.0|Android 7.0|
|7.1|Android 7.1|
|8.0|Android 8.0|
|8.1|Android 8.1|
|9.0|Android 9.0|
|10.0|Android 10.0|
|10.1|Android 10.1|
|10.2|Android 10.2|
|10.3|Android 10.3|
|10.5|Android 10.5|
|10.6|Android 10.6|
|11.0|Android 11.0|
|12.0|Android 12.0|
|13.0|Android 13.0|

最低 iOS 版本 (min_ios_version)

可以使用/tool/os_version/接口获取最新的操作系统列表。

|值 {50%}|描述 {50%}|
|---|---|
|NONE|不限|
|8.0|iOS 8.0|
|8.1|iOS 8.1|
|8.2|iOS 8.2|
|8.3|iOS 8.3|
|8.4|iOS 8.4|
|9.0|iOS 9.0|
|9.1|iOS 9.1|
|9.2|iOS 9.2|
|9.3|iOS 9.3|
|10.1|iOS 10.1|
|10.2|iOS 10.2|
|10.3|iOS 10.3|
|11.0|iOS 11.0|
|11.1|iOS 11.1|
|11.2|iOS 11.2|
|11.3|iOS 11.3|
|11.4|iOS 11.4|
|12.0|iOS 12.0|
|12.1|iOS 12.1|
|12.2|iOS 12.2|
|12.3|iOS 12.3|
|12.4|iOS 12.4|
|13.0|iOS 13.0|
|13.1|iOS 13.1|
|13.2|iOS 13.2|
|13.3|iOS 13.3|
|13.4|iOS 13.4|
|13.5|iOS 13.5|
|13.6|iOS 13.6|
|13.7|iOS 13.7|
|14.0|iOS 14.0|
|14.1|iOS 14.1|
|14.2|iOS 14.2|
|14.3|iOS 14.3|
|14.4|iOS 14.4|
|14.5|iOS 14.5|
|14.6|iOS 14.6|
|14.7|iOS 14.7|
|14.8|iOS 14.8|
|15.0|iOS 15.0|
|15.1|iOS 15.1|
|15.2|iOS 15.2|
|15.3|iOS 15.3|
|15.4|iOS 15.4|
|15.5|iOS 15.5|
|15.6|iOS 15.6|
|16.0|iOS 16.0|
|16.1|iOS 16.1|
|16.2|iOS 16.2|
|16.3|iOS 16.3|
|16.4|iOS 16.4|

受众操作系统 (operating_systems)

|值{50%}|描述{50%}|
|---|---|
|ANDROID|Android|
|IOS|iOS|
|PC   已废弃|PC|

优化目标 (optimization_goal)

| 值 {40%}| 描述{60%} |
| ---- | --- |
| CLICK | 点击/点击数。<br><br>`CLICK` 在以下任意场景中对应优化目标点击数: <ul><li>`shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `STORE` 或 `SHOWCASE`。</li><li>`shopping_ads_type` 设置为 `LIVE`。</li><li> `shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS` 且 `product_source` 设置为 `STORE`。</li></ul>|
| CONVERT | 转化/付费数/开始结账数。<br><br>`CONVERT`(对应的 `optimization_event` 设置为`SHOPPING`)在以下任意场景中对应优化目标付费数: <ul><li>`shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `STORE` 或 `SHOWCASE`。 </li><li> `shopping_ads_type` 设置为 `LIVE`。</li><li>`shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS` 且 `product_source` 设置为 `STORE`。</li></ul><br>`CONVERT`(对应的 `optimization_event` 设置为 `INITIATE_ORDER`) 在以下任意场景中对应优化目标开始结账数:<ul><li>`shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `STORE` 或 `SHOWCASE`。</li><li>`shopping_ads_type` 设置为 `LIVE`。</li></ul>|
| INSTALL | 安装。<br><br>若要在 Pangle 版位或全球化应用组合版位的广告组中使用优化目标“安装与应用内事件数据”,需将 `optimization_goal` 设置为`INSTALL`,传入 `secondary_optimization_event` 合法值,且在`placements`的值中仅包含 `PLACEMENT_PANGLE`或 `PLACEMENT_GLOBAL_APP_BUNDLE` 或`PLACEMENT_PANGLE`和 `PLACEMENT_GLOBAL_APP_BUNDLE`。 <br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>自 2024 年 11 月 30 日起,您将无法创建或复制优化目标为“安装与应用内事件数据”且版位为仅 TikTok 或自动版位的广告组。此变动将影响使用以下配置的广告组:<ul><li>推广系列层级:`objective_type` 为 `APP_PROMOTION` </li><li>广告组层级: <ul><li> `optimization_goal` 为 `INSTALL` 且指定了 `secondary_optimization_event` 合法值</li><li>`placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 为`["PLACEMENT_TIKTOK"]`,或 `placement_type` 为`PLACEMENT_TYPE_AUTOMATIC` </li></ul></li><li>现有的投放在 TikTok 版位的“安装与应用内事件数据”广告组将不受影响。此外,Pangle 版位和全球化应用组合版位(即 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 的值仅包含`PLACEMENT_PANGLE` 和 `PLACEMENT_GLOBAL_APP_BUNDLE`)也不受影响。请注意此变更,并在必要时对您的集成进行适当的调整。</li></ul></li></ul> |
| IN_APP_EVENT | 应用内事件 |
| SHOW | 展示 |
|VIDEO_VIEW{-已废弃} |视频播放。|
| REACH | 覆盖人数 |
| LEAD_GENERATION | 线索量 |
| CONVERSATION | 会话数。向最有可能发起 TikTok 私信会话或即时通讯应用会话的用户展示你的广告。 <br> 本优化目标与`CLICK` 相比,更注重深层次的优化,因此有更大机会实现更好的表现。 <br><br><ul><li>若想了解在 TikTok 私信广告中使用优化目标会话数的步骤,请查看[创建优化位置为 TikTok 私信的线索广告](1774482992153601.html)。</li><li>若想了解在 TikTok 即时通讯广告中使用优化目标会话数的步骤,请查看[创建优化位置为即时通讯应用的线索广告](1774482999036930.html)。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>优化目标会话数(`CONVERSATION`)目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</li><li>您将 `optimization_goal` 设置为 `CONVERSATION` 后, 可不传入 `optimization_event`,`optimization_event` 将默认设置为 `MESSAGE`。若您在`optimization_event` 字段手动传入其他值,则将产生报错。</li></ul>|
| FOLLOWERS | 账号关注 |
| PROFILE_VIEWS {即将废弃} | 主页访问<br><br><p><span style="color:darkred"><b>注意</b></span>: 我们计划在新版本API中废弃 `PROFILE_VIEWS`。为确保集成过程顺利,我们建议您将 `PAGE_VISIT` 用作优化目标。|
| PAGE_VISIT | TikTok 页面访问。为各种 TikTok 页面吸引访问量,包括账号主页、其他 TikTok 页面(播放列表页面、话题标签页面、音乐页面或商业化特效页面)、自定义 TikTok 即时体验页面。<br><br>只有在推广系列层级的 `objective_type` 为 `ENGAGEMENT`(社区互动)时,才能使用此优化目标。<br><br>若想了解如何在社区互动这一推广目标下使用优化目标 TikTok 页面访问,请查看[创建社区互动广告](1808164002093058.html)。|
| VALUE | 价值/总收入。<br><br> `VALUE` 在以下任意场景中对应优化目标总收入:<ul><li> `shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `STORE` 或 `SHOWCASE`。</li><li>`shopping_ads_type` 设置为 `LIVE`。</li><li>`shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS` 且 `product_source` 设置为 `STORE`。</li></ul><br>若想了解如何使用价值这一优化目标,请查看[开启价值优化](1770019181843458.html)。 |
|AUTOMATIC_VALUE_OPTIMIZATION |自动价值优化。通过机器学习进行动态优化,以实现最大价值或最大投放量。<br><br> 若想了解如何在网站转化量推广目标下使用优化目标自动价值优化,请查看[开启网站价值优化](https://business-api.tiktok.com/portal/docs?id=1770019181843458#item-link-开启网站价值优化)。<br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>自动价值优化目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</li><li>同时启用自动价值优化和推广系列预算优化目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</li></ul> |
|GMV|一个组合筛选器,筛选出推广目标(`objective_type`)为 `PRODUCT_SALES`、优化目标(`optimization_goal`)为 `VALUE`、推广系列的商品来源(`campaign_product_source`)为 `STORE`,以及购物广告类型(`shopping_ads_type`)为 `VIDEO`/`LIVE`/`PRODUCT_SHOPPING_ADS` 的推广系列、广告组和广告。 <br><p><span style="color:darkred"><b>注意</b></span>: 该优化目标不能用于创建广告组,只能在获取推广系列/广告组/广告的GET 接口和报表管理的接口中筛选时使用。 |
|PURCHASES|一个组合筛选器,筛选出推广目标(`objective_type`)为 `PRODUCT_SALES`、优化目标(`optimization_goal`)为 `CONVERT`、推广系列的商品来源(`campaign_product_source`)为 `STORE`,以及匹配的事件(`optimization_event`)为 `SHOPPING` 的推广系列、广告组和广告。<br><p><span style="color:darkred"><b>注意</b></span>: 该优化目标不能用于创建广告组,只能在获取推广系列/广告组/广告的GET 接口和报表管理的接口中筛选时使用。 |
|INITIATE_CHECKOUTS|一个组合筛选器,筛选出推广目标(`objective_type`)为 `PRODUCT_SALES`、优化目标(`optimization_goal`)为 `CONVERT`、推广系列的商品来源(`campaign_product_source`)为 `STORE`,以及匹配的事件(`optimization_event`)为 `INITIATE_ORDER` 的推广系列、广告组和广告。 <br><p><span style="color:darkred"><b>注意</b></span>:该优化目标不能用于创建广告组,只能在获取推广系列/广告组/广告的GET 接口和报表管理的接口中筛选时使用。|
|MT_LIVE_ROOM| 直播间观众留存。本优化目标只适用于直播带货场景 (`promotion_type` = `LIVE_SHOPPING`)。匹配的事件(`optimization_event`)为 `LIVE_STAY_TIME`|
|PRODUCT_CLICK_IN_LIVE| LIVE商品点击数。本优化目标只适用于直播带货场景(`promotion_type` = `LIVE_SHOPPING`)。匹配的事件(`optimization_event`)为 `LIVE_CLICK_PRODUCT_ACTION`|
|ENGAGED_VIEW| 观看6秒次数(专注观看)。<br>用户观看视频时长达到6秒,或观看付费广告的一天内与视频互动至少一次。纳入统计的互动包括:点赞,分享,关注,访问主页,点击,话题标签点击,音乐点击,锚点点击,以及创新互动样式行为点击。<br><p><span style="color:DarkRed"><b>注意</b></span>:<ul><li>广告组创建后,将无法把`optimization_goal`从`ENGAGED_VIEW`更新为其他值。</li><li>将`optimization_goal`设置为`ENGAGED_VIEW`后,系统将自动将 `ENGAGED_VIEW` 传入`optimization_event`。若已经将 `optimization_event`设置为其他值,则传入值会被忽略。</li></ul>|
|ENGAGED_VIEW_FIFTEEN| 观看15秒次数(专注观看)。<br>用户观看视频时长达到15秒,或观看付费广告的一天内与视频互动至少一次。纳入统计的互动包括:点赞,分享,关注,访问主页,点击,话题标签点击,音乐点击,锚点点击,以及创新互动样式行为点击。<br><p><span style="color:DarkRed"><b>注意</b></span>:<ul><li>将`optimization_goal`设置为`ENGAGED_VIEW_FIFTEEN`后,系统将自动将 `ENGAGED_VIEW_FIFTEEN` 传入`optimization_event`。若已经将 `optimization_event`设置为其他值,则传入值会被忽略。</li></ul>|
| TRAFFIC_LANDING_PAGE_VIEW|落地页浏览量。用户点击并成功加载落地页。对应的`optimization_event`为`LANDING_PAGE_VIEW`。<br><br>若要在访问量目标下使用 `TRAFFIC_LANDING_PAGE_VIEW`,需满足以下条件:<ul><li>推广系列层级:`objective_type` 设置为 `TRAFFIC`</li><li>广告组层级:<ul><li>`promotion_type` 设置为 `WEBSITE`</li><li>版位:<ul><li>`placement_type`设置为 `PLACEMENT_TYPE_AUTOMATIC` 或</li><li>`placement_type`设置为 `PLACEMENT_TYPE_NORMAL`,且 `placements` 未设置为 `&#91;"PLACEMENT_GLOBAL_APP_BUNDLE"&#93;`(仅包含全球化应用组合)</li></ul></li><li>`optimization_goal` 设置为 `TRAFFIC_LANDING_PAGE_VIEW`</li></ul></li><li>广告层级:<ul><li>需通过`page_id`传入TikTok 即时体验页面的 ID。</li><li>未设置深度链接(直达链接)。 </li></ul></li></ul></li></ul><br> 若想了解如何商品销量目标下使用落地页浏览量优化目标,请查看[优化视频购物广告中的落地页浏览量](1775099621140482.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>在购物广告中使用优化目标落地页浏览量目前为白名单功能。如需使用此功能,请联系您的TikTok销售代表。</li><li>您将 `optimization_goal` 设置为 `TRAFFIC_LANDING_PAGE_VIEW` 后, 可不传入 `optimization_event`,`optimization_event` 将默认设置为 `LANDING_PAGE_VIEW`。若您在`optimization_event` 字段手动传入其他值,则将产生报错。</li></ul>|
| CONVERSION_LEADS {-已废弃} | 转化线索量。 <br>向最有可能在提供联系信息后完成转化的用户展示广告。|
| DESTINATION_VISIT | 目标页面访问。使用此优化目标的广告会将用户引导至应用内页面,或回退到网站。<br><br>若想了解如何在访问量目标下使用目标页面访问,请查看[优化访问量广告中的目标页面访问](1782086241778690.html)。<br>若想了解如何在商品销量目标下使用目标页面访问,请查看[优化视频购物广告中的目标页面访问](1782087855154177.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>优化目标目标页面访问(`DESTINATION_VISIT`)目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</li><li>您将 `optimization_goal` 设置为 `DESTINATION_VISIT` 后, 可不传入 `optimization_event`,`optimization_event` 将默认设置为 `DESTINATION_VISIT`。若您在`optimization_event` 字段手动传入其他值,则将忽略传入值。</li></ul> |
| PREFERRED_LEAD| 偏好的潜在客户。向最有可能符合你偏好的潜在客户资质的人群展示广告。|

版位 (placements)

| 值 {40%} | 描述 {60%} |
| --- | --- |
| PLACEMENT_TIKTOK | TikTok |
| PLACEMENT_PANGLE | Pangle(原TikTok_Audience_Network) |
|PLACEMENT_GLOBAL_APP_BUNDLE | 全球化应用组合。目前包括Capcut和Fizzo。<br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>全球化应用组合版位目前不支持优化目标落地页浏览量(`optimization_goal`=`TRAFFIC_LANDING_PAGE_VIEW`)。</li></ul> |
| PLACEMENT_TOPBUZZ{-已废弃}| BuzzVideo/Babe |
| PLACEMENT_HELO{-已废弃}| Helo |

一级状态

注意
请查看一级状态下所支持的二级状态 ,了解对于所指定的一级状态,您可以通过/campaign/get/,/adgroup/get/,或/ad/get/传入的二级状态。

| 值 {40%} | 描述 {60%} |
| --- | --- |
|STATUS_DELETE|已删除|
|STATUS_DELIVERY_OK|投放中|
|STATUS_DISABLE|暂停投放|
|STATUS_NOT_DELIVERY|不在投放中|
|STATUS_TIME_DONE|已完成(推广系列无此状态)|
|STATUS_RF_CLOSED|覆盖和频次广告组已关闭(仅覆盖和频次广告组和广告有此状态)|
|STATUS_FROZEN|覆盖和频次广告组冻结中(仅覆盖和频次广告有此状态)|
|STATUS_ALL|所有状态(包含已删除)|
|STATUS_NOT_DELETE|所有状态(不包含已删除)。该枚举值为基础、受众分析或DSA类型的同步报表中的默认筛选条件。|

推广对象类型 (优化位置)(promotion_type)

| 值 {40%} | 描述 {60%} |
| --- | --- |
| APP_ANDROID | 安卓应用 |
| APP_IOS | iOS 应用 |
|MINI_APP|短剧类型的 TikTok Minis。<br><br>仅支持在升级版 Smart+ Minis 广告中推广短剧(`app_promotion_type` 为 `MINIS`)。<br><br>若想了解该推广系列的详情,可查看[创建升级版 Smart+ Minis 推广系列](1853377811982657.html)。|
|MINI_GAME|小游戏类型的 TikTok Minis。<br><br>仅支持在升级版 Smart+ Minis 广告中推广短剧(`app_promotion_type` 为 `MINIS`)。<br><br>若想了解该推广系列的详情,可查看[创建升级版 Smart+ Minis 推广系列](1853377811982657.html)。|
| GAME | 游戏。 <br>仅支持在应用帖子推广(即 `app_promotion_type` 为 `APP_POSTS_PROMOTION`)类型的推广系列中推广游戏。<br><br><p><span style="color:darkred"><b>注意</b></span>:目前不支持通过 API 创建应用帖子推广类型的推广系列,仅支持通过 API 更新或检索此类推广系列。|
| WEBSITE | 落地页 |
| LEAD_GENERATION | 线索广告中的即时表单(线索表单)或落地页。 <br><br>`promotion_type` 设置为 `LEAD_GENERATION` 时,您可将 `promotion_target_type` 设置为:<ul><li>`INSTANT_PAGE` :即时表单。</li><li>或 `EXTERNAL_WEBSITE` :落地页。</li></ul><br>若想了解如何创建推广对象类型为即时表单的线索广告,请查看[这里](1774482920012801.html)。<br>若想了解如何创建推广对象类型为落地页的线索广告,请查看[这里](1774482976097281.html)。 |
| LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE | 通过 TikTok 私信收集线索。<br><br>若想了解如何创建推广对象类型为 TikTok 私信的线索广告,请查看[这里](1774482992153601.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li> 创建优化位置为 TikTok 私信的线索广告对注册地为以下地区的广告主已全量开放:<ul><li>亚太地区:澳大利亚,孟加拉国,柬埔寨,印度尼西亚,日本,马来西亚,新西兰,巴基斯坦,菲律宾,新加坡,韩国,斯里兰卡,中国台湾地区,泰国和越南。</li><li>拉美地区:阿根廷,玻利维亚,巴西,智利,哥伦比亚,哥斯达黎加,多米尼加共和国,厄瓜多尔,危地马拉,墨西哥,巴拿马,巴拉圭,秘鲁,波多黎各和乌拉圭。</li></ul></li><li>对于注册地为其他地区的广告主,此功能目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</li></ul> |
| LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE | 通过即时通讯应用收集线索。<br><br>若想了解如何创建推广对象类型为即时通讯应用的线索广告,请查看[这里](1774482999036930.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>创建优化位置为即时通讯应用的线索广告对注册地为以下亚太地区的广告主已全量开放:澳大利亚,孟加拉国,柬埔寨,印度尼西亚,日本,马来西亚,新西兰,巴基斯坦,菲律宾,新加坡,韩国,斯里兰卡,中国台湾地区,泰国和越南。</li><li>对于注册地为其他地区的广告主,此功能目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</li></ul> |
| LEAD_GEN_CLICK_TO_CALL | 通过电话通话收集线索。 <br><br>若想了解如何创建推广对象类型为电话通话的线索广告,请查看[这里](1774482936048641.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>:创建推广对象类型为电话通话的线索广告目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。 |
| WEBSITE_OR_DISPLAY | 落地页或纯展示页。如果推广对象为网站,且推广对象不需传入`landing_page_url`时,使用`WEBSITE_OR_DISPLAY` (对应推广目标为Reach / Video Views / Engagement) 。对于其他推广目标(Traffic / Conversion),如果推广对象为网站,那么请使用`WEBSITE` |
|TIKTOK_SHOP| TikTok商店|
|VIDEO_SHOPPING| <ul><li>仅当`shopping_ads_type` 设置为`VIDEO` 且 `product_source` 设置为 `STORE` 或 `SHOWCASE` 时生效。</li><li>若 `shopping_ads_type` 设置为`VIDEO` 且 `product_source` 设置为`CATALOG`,需将 `promotion_type` 设置为 `WEBSITE`,`APP_ANDRIOD` 或 `APP_IOS`。</li></ul><br>视频购物。在短视频上展示商品链接。观众可点击购买产品。|
|LIVE_SHOPPING| 仅当 `shopping_ads_type ` 设置为 `LIVE` 时生效。<br><br>直播购物。在直播间介绍商品并展示商品链接。观众可点击购买。|
| PSA_PRODUCT| 仅当`shopping_ads_type` 设置为`PRODUCT_SHOPPING_ADS` 时生效。 <br><br>通过[购物中心和搜索](https://ads.tiktok.com/help/article/about-onsite-shopping-placements?lang=zh)流量推广商品。 |

覆盖和频次广告购买方式 (rf_purchased_type)

|值{50%}|描述{50%}|
|---|---|
|FIXED_SHOW|按固定展示量购买|
|FIXED_REACH|按固定触达人数购买|

广告投放时间类型 (shedule_type)

|值{50%}|描述{50%}|
|---|---|
|SCHEDULE_FROM_NOW|从现在开始一直投放|
|SCHEDULE_START_END|选择起始时间|

广告报表管理

受众报表分组条件

|值{50%}|描述{50%}|
|---|---|
|GENDER|按性别分组|
|AGE|按年龄分组|
|COUNTRY|按国家分组|
|AC|按网络分组|
|LANGUAGE|按语言分组|
|PLATFORM|按操作系统分组|
|INTEREST_CATEGORY|按兴趣定向分组|
|PLACEMENT|按投放位置分组|

受众报表排序字段

|值{50%}|描述{50%}|
|---|---|
|click_cnt|按点击数排序|
|convert_cnt|按转化数排序|
|convert_cost|按转化成本排序|
|convert_rate|按转化率排序|
|ctr|按点击率排序|
|show_cnt|按展示数排序|
|stat_cost|按消耗排序|

应用管理

设备型号

使用获取设备型号列表接口获取最新设备型号列表。

|值|
|---|
|iPhone 13/13 Mini/13 Pro/13 Pro Max|
|iPhone 11 Pro Max/XS Max|
|iPhone 11 Pro/X/XS|
|iPhone 11/XR|
|iPhone 6/6s/7/8|
|iPhone 6/7/8 Plus|
|iPhone 5/5s/5c/SE|
|iPhone 4/4s|
|OPPO A3s|
|OPPO A5s|
|OPPO A71|
|OPPO F7|
|OPPO F9|
|OPPO R15|
|VIVO Y91i|
|VIVO X20A|
|RedMi 5A|
|RedMi 6A|
|RedMi Y2|
|Redmi Note 4|
|RedMi Note 5 Pro|
|RedMi Note 6 Pro|
|SAMSUNG Galaxy J2|
|SAMSUNG Galaxy J2 Prime|
|SAMSUNG Galaxy J7 Nxt|
|SAMSUNG Galaxy J7 Prime|
|SAMSUNG Galaxy A10|
|SAMSUNG Galaxy S8|
|HUAWEI P30|
|Google Pixel 3XL|

关键帧模板类型

|值{30%}|版式{20%}|示例{50%}|
|---|---|---|
|END_FRAME_HORIZONTAL_1|横版|横版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体偏小。|
|END_FRAME_HORIZONTAL_2|横版|横版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体偏大。|
|END_FRAME_HORIZONTAL_3|横版|横版尾帧模板,品牌标识显示为矩形,标语字体偏小。不支持显示品牌名。|
|END_FRAME_HORIZONTAL_4|横版|横版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体中等。|
|END_FRAME_HORIZONTAL_5|横版|横版尾帧模板,品牌标识显示为矩形,标语字体中等。不支持显示品牌名。|
|END_FRAME_VERTICAL_1|竖版|竖版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体偏小。|
|END_FRAME_VERTICAL_2|竖版|竖版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体偏大。|
|END_FRAME_VERTICAL_3|竖版|竖版尾帧模板,品牌标识显示为矩形,标语字体偏小。不支持显示品牌名。|
|END_FRAME_VERTICAL_4|竖版|竖版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体中等。|
|END_FRAME_VERTICAL_5|竖版|竖版尾帧模板,品牌标识显示为矩形,标语字体中等。不支持显示品牌名。|

素材标签

|值{30%}|描述{30%}|适用素材类型{40%}|
|---|---|---|
|title|(商品)名称,标题|文字|
|price|价格|文字|
|description|描述(text类型默认值)|文字|
|logo|品牌logo|图片|
|image|商品图片(image类型默认值)|图片|
|video|商品视频(video类型默认值)|视频|

任务状态

|值{50%}|描述{50%}|
|---|---|
|CREATED|任务已提交|
|PROCESSING|任务正在处理中|
|SUCCESS|任务处理成功|
|FAILED|任务处理失败|

第三方监测合作伙伴

|值{50%}|描述{50%}|
|---|---|
|AdBrix|Adbrix|
|Adjust|Adjust|
|Adzcore  已废弃|Party|
|AppAdforce  已废弃|F.O.X|
|AppLink|Branch|
|AppMetrica  已废弃|AppMetrica|
|AppsFlyer|Appsflyer|
|DoubleClick|DCM (Double Click)|
|FlashTalking|FlashTalking|
|Huangbaoche  已废弃|Sensors Data|
|Kochava|Kochava|
|Lazada  已废弃|Alibaba Group|
|LeadBolt  已废弃|Leadbolt|
|Metaps  已废弃|Metaps|
|ServingsSys|Sizmek|
|Singular|Singular|
|Tenjin|Tenjin|
|TlnkIo|Tune|
|Vidoadsplus  已废弃|Vidoadsplus|
|myTracker  已废弃|myTracker|

受众管理

受众类型

|值{50%}|描述{50%}|
|---|---|
|ENGAGEMENT|广告互动受众|
|APP|应用活动受众|
|PIXEL|网站访客受众|
|LEAD_GENERATION|线索事件受众|
|TIKTOK_SHOP|商店活动受众|
|BUSINESS_ACCOUNT|企业号受众|
|ENGAGEMENT_ORGANIC_VIDEO|自然流量互动受众 (与自然流量视频互动的受众)|
|ENGAGEMENT_LIVE_VIDEO|直播互动受众 (与直播视频互动的受众)|
|OFFLINE|线下活动受众(与线下事件活动互动的受众)|

加密类型 (calculate_type)

|值{50%}|描述{50%}|
|---|---|
|FIRST_SHA256|以SHA256加密的IDFA或GAID。|
|FIRST_MD5|以MD5加密的IDFA或GAID。|
|EMAIL_SHA256|以SHA256加密的邮件地址。|
|PHONE_SHA256|以SHA256加密电话号码。|
|IDFA_SHA256|以SHA256加密的IDFA(即Apple Identifiers for Advertisers,Apple面向广告主的标识符)。|
|IDFA_MD5|以MD5加密的IDFA。|
|GAID_SHA256|以SHA256加密的GAID(即Google Advertising ID,谷歌广告ID)|
|GAID_MD5|以MD5加密的GAID,|
|MULTIPLE_TYPES|多种标识符。该加密类型仅适用于使用客户文件API创建的客户文件受众。|
|FIRST_NORMAL(已废弃)|IDFA或GAID原始数据|

筛选字段

|值{50%}|描述{50%}|
|---|---|
|EVENT|以事件作为筛选字段|

筛选操作符

|值{50%}|描述{50%}|
|---|---|
|EQ|等于。使用`EQ`连接筛选字段和筛选字段值。例如:Field EQ Value|

筛选字段值

| 值 {30%} | 描述 {70%} |
| --- | --- |
| 广告互动受众枚举值 | |
#| CLICK | 视频广告点击事件 |
#| IMPRESSION | 视频广告展示事件 |
#| PLAY 2S | 视频广告播放2秒|
#| PLAY 6S | 视频广告播放6秒 |
#| PLAY 25 | 视频广告播放进度25% |
#| PLAY 50 | 视频广告播放进度50% |
#| PLAY 75 | 视频广告播放进度75% |
#| PLAY OVER | 视频广告播放完成 |
#| ENGAGEMENT APP PROFILE CLICK  | 应用介绍页广告点击事件 |
#| ENGAGEMENT APP PROFILE IMPRESSION | 应用介绍页广告展示事件 |
#| ENGAGEMENT TIKTOK INSTANT CLICK | 即时页面广告点击事件 |
#| ENGAGEMENT TIKTOK INSTANT IMPRESSION | 即时页面广告展示事件 |
#| ENGAGEMENT COLLECTION ADS CLICK | 精品栏广告点击事件 |
#| ENGAGEMENT COLLECTION ADS IMPRESSION  | 精品栏广告展示事件 |
| 直播互动受众枚举值 | |
#| LIVE VIDEO VIEW | 观看 |
#| LIVE VIDEO ENGAGEMENT | 互动 |
|应用活动受众枚举值 | |
#| INSTALL | 安装事件 |
#| DAY 2 RETENTION | 次日留存 |
#| APP ADD PAYMENT INFO | 添加支付信息事件 |
#| APP ADD TO CART | 应用中添加到购物车事件,请注意本事件区别于Pixel中添加到购物车事件|
#| ADD TO WISHLIST | 添加到购物清单事件 |
#| LAUNCH APP | 启动应用事件 |
#| CHECKOUT | 下单事件 |
#| COMPLETE TUTORIAL | 完成导引事件 |
#| VIEW CONTENT | 查看内容事件 |
#| CREATE GROUP | 创建群组事件 |
#| CREATE ROLE | 创建角色事件 |
#| GENERATE LEAD | 生成线索 |
#| IN-APP AD CLICK | 应用内点击广告事件 |
#| IN-APP AD IMPRESSION |应用内广告展示事件 |
#| JOIN GROUP | 加入群组事件 |
#| ACHIEVE LEVEL | 达到等级 |
#| LOAN APPLY | 申请贷款 |
#| LOAN APPROVAL | 贷款获批 |
#| LOAN DISBURSAL | 放款 |
#| LOGIN | 登录 |
#| PURCHASE |购买 |
#| RATE | 评价 |
#| REGISTRATION |注册 |
#| APP SEARCH | 搜索 |
#| SPEND CREDITS | 使用积分 |
#| START TRIAL |开始试用 |
#| SUBSCRIBE | 注册 |
#| UNLOCK ACHIEVEMENT |解锁成就 |
| 网站访客受众枚举值 | |
#| PAGE BROWSE | 对应“网页浏览事件”。访客何时登陆你的网站。 |
#| CLICK BUTTON | 点击按钮 |
#| PIXEL SUBMIT FORM |表单提交 |
#| CONTACT | 问询 |
#| DOWNLOAD  | 点击下载按钮 |
#| PIXEL ADD PAYMENT INFO | 添加付款信息 |
#| COMPLETE PAYMENT | 完成付款 |
#| INITIATE CHECKOUT |开始付款 |
#| COMPLETE REGISTRATION | 完成注册 |
#| PRODUCT DETAIL PAGE BROWSE | 对应“查看内容”事件。用户何时查看了详细的产品页面。 |
#| PIXEL SEARCH | 搜索 |
#| PIXEL ADD TO CART | 添加到购物车(Pixel) |
#| PLACE AN ORDER | 下单 |
#| PIXEL ADD TO WISHLIST | 添加到购物清单(Pixel) |
#| PIXEL SUBSCRIBE | 订阅(Pixel) |
| 线索事件受众枚举值 | |
#| LEAD GENERATION FORM SUBMISSION | 提交表单 |
#| FORM VIEW | 浏览表单 |
| 商店活动受众枚举值 | |
#| TIKTOK SHOP PAGE VIEW | 产品详情页浏览事件 |
#| TIKTOK SHOP ADD TO CART | 添加到购物车事件 |
#| TIKTOK SHOP INITIATE CHECKOUT | 开始下单事件 |
#| TIKTOK SHOP COMPLETE PAYMENT | 支付完成事件 |
| 企业号受众枚举值 | |
#| BUSINESS ACCOUNT PROFILE FOLLOW | 关注事件 |
#| BUSINESS ACCOUNT PROFILE VISIT | 主页访问事件 |
#| BUSINESS ACCOUNT ENGAGEMENT | 视频互动事件(点赞/分享/评论) |
#| BUSINESS ACCOUNT PLAY 2S | 视频播放2秒事件 |
#| BUSINESS ACCOUNT PLAY 6S | 视频播放6秒事件 |
#| BUSINESS ACCOUNT PLAY OVER | 视频播放完成事件 |
| 线下活动枚举值 |  |
#| OFFLINE COMPLETE PAYMENT  | 完成付款 |
#| OFFLINE CONTACT  | 联系 |
#| OFFLINE SUBMIT FORM  | 提交表单 |
#| OFFLINE SUBSCRIBE | 订阅 |
#| OFFLINE ADD PAYMENT INFO | 添加支付信息 |
#| OFFLINE ADD TO CART  | 加入购物车 |
#| OFFLINE ADD TO WISHLIST  | 加入心愿单 |
#| OFFLINE CLICK BUTTON  | 点击按钮 |
#| OFFLINE COMPLETE REGISTRATION | 完成注册 |
#| OFFLINE DOWNLOAD  | 下载 |
#| OFFLINE INITIATE CHECKOUT  | 开始下单 |
#| OFFLINE PLACE AN ORDER | 下单事件 |

相似受众地点

|值{50%}|描述{50%}|
|---|---|
|AE|阿拉伯联合酋长国|
|AU|澳大利亚|
|AZ|阿塞拜疆|
|BG|保加利亚|
|BO|玻利维亚|
|CA|加拿大|
|CY|塞浦路斯|
|DE|德国|
|DZ|阿尔及利亚|
|EE|爱沙尼亚|
|EG|埃及|
|ES|西班牙|
|FR|法国|
|GB|英国|
|HR|克罗地亚|
|ID|印度尼西亚|
|IL|以色列|
|IN|印度|
|IT|意大利|
|JP|日本|
|KE|肯尼亚|
|KR|韩国|
|LK|斯里兰卡|
|LT|立陶宛|
|LV|拉脱维亚|
|MY|马来西亚|
|PL|波兰|
|PR|波多黎各|
|PY|巴拉圭|
|RS|塞尔维亚|
|RU|俄国|
|SA|沙地阿拉伯|
|SI|斯洛文尼亚|
|SK|斯洛伐克|
|TH|泰国|
|TR|土耳其|
|TW|中国台湾地区|
|US|美国|
|VN|越南|

相似受众大小

|值{50%}|描述{50%}|
|---|---|
|NARROW|偏小的相似受众数|
|BALANCED|较平衡的相似受众数|
|BROAD|偏大的相似受众数|

相似受众手机系统

|值{50%}|描述{50%}|
|---|---|
|ALL|iOS以及安卓都包含|
|IOS|iOS|
|ANDROID|安卓|

回溯期(retention_days)

|值{50%}|描述{50%}|
|---|---|
|7|回溯过去7天。|
|14|回溯过去14天。|
|30|回溯过去30天。|
|60|回溯过去60天。|
|90|回溯过去90天。|
|180|回溯过去180天。|

规则集操作符

|值{50%}|描述{50%}|
|---|---|
|OR|或操作。使用`or`连接多个规则,即: rule1 or rule2 or ...|

创意管理

分类标签

|值|
|---|
|`Action`|
|`Adventure`|
|`Arcade`|
|`Art&Design`|
|`Auto&Vehicles`|
|`Beauty`|
|`Board`|
|`Book`|
|`Books`|
|`Books&Reference`|
|`Business`|
|`Card`|
|`Casino`|
|`Casual`|
|`Catalogs`|
|`Comics`|
|`Communication`|
|`Dating`|
|`DeveloperTools`|
|`Education`|
|`Educational`|
|`Entertainment`|
|`Events`|
|`Finance`|
|`Food&Drink`|
|`FoodandDrink`|
|`Games`|
|`Graphics&Design`|
|`Health&Fitness`|
|`HealthandFitness`|
|`House&Home`|
|`Libraries&Demo`|
|`Lifestyle`|
|`Magazines&Newspaper`|
|`MagazinesandNewspapers`|
|`Maps&Navigation`|
|`Medical`|
|`Music`|
|`Music&Audio`|
|`Navigation`|
|`News`|
|`News&Magazines`|
|`Parenting`|
|`Personalization`|
|`Photo&Video`|
|`PhotoandVideo`|
|`Photography`|
|`Productivity`|
|`Puzzle`|
|`Racing`|
|`Reference`|
|`RolePlaying`|
|`Shopping`|
|`Simulation`|
|`Social`|
|`SocialNetworking`|
|`Sports`|
|`Stickers`|
|`Strategy`|
|`Tools`|
|`Travel`|
|`Travel&Local`|
|`Trivia`|
|`Utilities`|
|`VideoPlayers&Editors`|
|`Weather`|
|`Word`|

设备型号

使用获取设备型号接口获取最新的设备型号列表。

关键帧模板类型

|值{30%}|版式{20%}|示例{50%}|
|---|---|---|
|END_FRAME_HORIZONTAL_1|横版|横版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体偏小。|
|END_FRAME_HORIZONTAL_2|横版|横版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体偏大。|
|END_FRAME_HORIZONTAL_3|横版|横版尾帧模板,品牌标识显示为矩形,标语字体偏小。不支持显示品牌名。|
|END_FRAME_HORIZONTAL_4|横版|横版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体中等。|
|END_FRAME_HORIZONTAL_5|横版|横版尾帧模板,品牌标识显示为矩形,标语字体中等。不支持显示品牌名。|
|END_FRAME_VERTICAL_1|竖版|竖版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体偏小。|
|END_FRAME_VERTICAL_2|竖版|竖版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体偏大。|
|END_FRAME_VERTICAL_3|竖版|竖版尾帧模板,品牌标识显示为矩形,标语字体偏小。不支持显示品牌名。|
|END_FRAME_VERTICAL_4|竖版|竖版尾帧模板,品牌标识显示为正方形,标语和品牌名称的字体中等。|
|END_FRAME_VERTICAL_5|竖版|竖版尾帧模板,品牌标识显示为矩形,标语字体中等。不支持显示品牌名。|

素材来源

|值{50%}|描述{50%}|
|---|---|
|UPLOADED|用户上传|
|CREATIVE_TOOL_OTHERS|创意工具-其他|
|CREATIVE_TOOL_SMART_VIDEO|创意工具-微电影|
|OTHERS|其它|

任务状态

|值{50%}|描述{50%}|
|---|---|
|CREATED|任务已提交|
|PROCESSING|任务正在处理中|
|SUCCESS|任务处理成功|
|FAILED|任务处理失败|

Spark Ads 帖子授权状态

|值{50%}|描述{50%}|
|---|---|
|EXPIRED|授权已过期|
|APPLYING|申请中|
|AUTHORIZED|已授权|
|NORESPONSE|授权未响应|
|REJECTED|拒绝授权|
|CANCEL|授权已取消|

对于升级版 Smart+ 报表

素材一级状态 (material_primary_status)

|值{50%}|描述{50%}|
|---|---|
|`STATUS_DELETE`|已删除|
|`STATUS_DISABLE`|已暂停|
|`STATUS_FROZEN`|已冻结|
|`STATUS_TIME_DONE`|已完成|
|`STATUS_NOT_DELIVERY`|未投放|
|`STATUS_PENDING`|待处理|
|`STATUS_DELIVERY_OK`|投放中|
|`STATUS_DELIVERY_PARTIAL`|部分投放受限|
|`STATUS_DELIVERY_CATALOG`|创意素材是商品库中的素材。当前,商品库创意素材的状态为不可用。|

素材二级状态 (material_second_status_list)

|值{50%}|描述{50%}|
|---|---|
|`AD_STATUS_CAMPAIGN_DELETE`|推广系列已删除|
|`AD_STATUS_ADGROUP_DELETE`|广告组已删除|
|`AD_STATUS_DELETE`|广告已删除|
|`AD_STATUS_CAMPAIGN_DISABLE`|推广系列已暂停|
|`AD_STATUS_ADGROUP_DISABLE`|广告组已暂停|
|`AD_STATUS_DISABLE`|广告已暂停|
|`ADGROUP_STATUS_FROZEN`|广告组已冻结|
|`CREATIVE_PAUSED_USED_IN_GMV_MAX`|创意素材不可用,因为已被 GMV Max 广告使用|
|`AD_STATUS_DONE`|已完成|
|`AD_STATUS_CAMPAIGN_EXCEED`|推广系列超出预算|
|`AD_STATUS_BUDGET_EXCEED`|广告组超出预算|
|`AD_STATUS_ADVERTISER_AUDIT_DENY`|账号未通过审核|
|`AD_STATUS_ADVERTISER_AUDIT`|账号正在审核中|
|`ADVERTISER_CONTRACT_PENDING`|合同尚未生效|
|`ADVERTISER_ACCOUNT_PUNISH`|账号被处罚|
|`AD_STATUS_AD_QUOTA_LIMIT`|账号已超出配额,广告组被暂停。如要继续,需暂停一个投放中的广告组。|
|`PRODUCT_ANCHOR_UNAVAILABLE`|尝试用于广告的商品链接不可用。|
|`AD_STATUS_CREATOR_AUTHORIZATION_REVOKED`|创作者尚未授权|
|`AD_STATUS_CREATIVE_ANCHOR_UNAVAILABLE`|尝试用于广告的商品链接不可用。|
|`AD_STATUS_CREATIVE_PRODUCT_ALL_REJECTED`|尝试用于广告的商品全部被拒|
|`AD_STATUS_ANCHOR_UNAVAILABLE`|尝试用于广告的商品链接不可用。|
|`AD_STATUS_PRODUCT_UNAVAILABLE`|尝试用于广告的商品不可用。|
|`NO_AVAILABLE_PRODUCTS`|无可用商品|
|`AD_STATUS_SHOWCASE_AUTHORIZATION_LOST`|尝试用于广告的橱窗标识不可用。|
|`AD_STATUS_ASSET_AUTHORIZATION_LOST`|素材不可用或相关授权已撤销|
|`AD_STAUS_PIXEL_UNBIND`|Pixel 未获得授权|
|`AD_STATUS_AUDIT`|审核中|
|`AD_STATUS_NOT_START`|不在排期时间内|
|`AD_STATUS_AD_PRE_ONLINE`|广告处于待上线状态,尚未投放。|
|`ADVERTISER_REAUDIT`|广告账号修改正在审核中|
|`MATERIAL_DELETE`|创意素材已删除|
|`MATERIAL_DISABLE`|创意素材已暂停|
|`MATERIAL_AUDIT_DENY`|创意素材未通过审核|
|`MATERIAL_AUDIT`|创意素材正在审核中|
|`MATERIAL_AUDIT_PARTIAL_APPROVED`|部分创意素材已通过审核|
|`MATERIAL_DELIVERY_OK`|创意素材投放中|
|`ADVERTISER_ACCOUNT_BALANCE_EXCEED`|账号余额不足|

内容来源: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 每日平台更新简报 →