功能更新
参阅下表,了解 TikTok API for Business 的功能更新情况。
2026年
2026年7月
| 日期{20%} | 更新类型{15%} | 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2026年7月31日 | 产品优化 | 推广系列管理 | 我们已在使用 Messenger 和 WhatsApp 应用的升级版 Smart+ 即时通讯广告中新增自动添加新生成素材的能力,此功能由 [/smart_plus/ad/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad/v1.3) 中请求参数 `creative_auto_add_toggle` 控制。借助 TikTok 最新的热门元素(开场、音乐、文案等),该功能可提供现成的优质内容,与您选定的素材一同投放,让广告紧跟潮流并减少人工创意操作。 |
| 2026年7月24日 | 产品优化 | 推广系列管理 | 我们已在升级版 Smart+ 广告组接口 [/smart_plus/adgroup/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad-group/v1.3)、[/smart_plus/adgroup/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad-group/v1.3) 和 [/smart_plus/adgroup/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ad-groups/v1.3) 中新增了请求参数 `app_attribution_source` 和 `app_data_source`,使您能够清晰控制作为报表数据基准的归因来源,以及在投放阶段被优先采用的数据源。为便于可用性检查与配置,[/app/info/](https://business-api.tiktok.com/portal/docs/get-info-of-an-app/v1.3) 和 [/app/list/](https://business-api.tiktok.com/portal/docs/get-the-app-list/v1.3) 新增了返回参数 `is_attribution_flex_enable`,同时新增接口 [/tool/available/attribution_source/](https://business-api.tiktok.com/portal/docs/get-available-attribution-sources-and-data-sources-for-an-app/v1.3) 用于获取指定应用实际可配置的归因来源和数据源。 |
| 2026年7月24日 | 产品优化 | 其他 | 我们已上线验证 API 的四个新接口:[/account/verification/filetype/](https://business-api.tiktok.com/portal/docs/get-available-verification-document-types-for-a-region/v1.3) 用于获取某地区支持的验证文件类型,[/account/verification/upload/](https://business-api.tiktok.com/portal/docs/upload-verification-documents/v1.3) 用于上传验证文件,[/account/verification/submit/](https://business-api.tiktok.com/portal/docs/submit-a-verification-request-for-your-account/v1.3) 用于提交验证请求,[/account/verification/status/](https://business-api.tiktok.com/portal/docs/check-the-verification-status-of-your-account/v1.3) 用于跟踪验证结果。这些接口将以往依赖界面的人工流程升级为程序化链路,方便您在不同市场和账户间顺畅规模化相关操作。详细步骤可参阅[验证 TikTok 商务中心账号或广告账号](https://business-api.tiktok.com/portal/docs/verify-your-business-center-account-or-ad-account-on-tiktok/v1.3)。 |
| 2026年7月24日 | 产品优化 | 账号 | 我们已上线 [/business/publish/location/](https://business-api.tiktok.com/portal/docs/get-the-location-tags-for-a-tiktok-account/v1.3),用于获取 TikTok 账号可用的位置标签,并在 [/business/video/publish/](https://business-api.tiktok.com/portal/docs/publish-a-public-video-post-to-an-owned-account/v1.3) 和 [/business/photo/publish/](https://business-api.tiktok.com/portal/docs/publish-a-photo-post-to-an-owned-account/v1.3) 中新增了请求参数 `location_id` 和 `location_name`。这些更新让您可以在发布时为帖子附加位置标签,帮助本地受众和按位置搜索的用户更容易发现您的内容。 |
| 2026年7月17日 | 产品优化 | 报表管理 | 我们已优化基础报表,使 [Native Growth 指标](https://business-api.tiktok.com/portal/docs/basic-reports-supported-metrics/v1.3#item-link-Native%20growth%20%E6%8C%87%E6%A0%87)可按一个 ID 维度分组,或按 ID 维度与 `stat_time_day` 组合分组。这使您能够更灵活地拆解指标表现,并更直观地观察按天趋势。 |
| 2026年7月17日 | 产品优化 | 创意管理 | 我们已在 [/file/video/ad/search/](https://business-api.tiktok.com/portal/docs/search-for-videos/v1.3) 中新增请求参数 `sort_field`,支持按视频最近更新时间进行降序排序。该能力可帮助您在管理大量视频素材时更快定位最新更新的内容。 |
| 2026年7月10日 | 产品优化 | 报表管理 | 我们已支持在同步基础报表中使用 `ad_id` 和 `ad_id_v2` 维度查询 [TikTok Native Growth 指标](https://business-api.tiktok.com/portal/docs/basic-reports-supported-metrics/v1.3#item-link-Native growth 指标)。此功能为您提供更细粒度的推广系列效果数据,帮助您获得更深入的洞察以优化广告策略。 |
| 2026年7月10日 | 产品优化 | TikTok One | 我们已在 [/tto/tcm/report/](https://business-api.tiktok.com/portal/docs/report-on-tto-creator-marketplace-videos/v1.3) 接口中新增返回参数 `favorites`、`favorites_organic` 和 `favorites_paid`。通过此更新,您可以获自然流量与付费流量收藏数的总数据和每日细分数据,实现对 TikTok One Creator Marketplace 视频更精细的效果分析。 |
| 2026年7月3日 | 产品优化 | 推广系列管理 |我们已支持[升级版 Smart+ TikTok Growth Max 剧集推广系列](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-mini-series-feed-campaign/v1.3),让您可以在广告中推广 TikTok 剧集。借助 TikTok Growth Max 的高意向受众定向能力,该推广系列将连续追剧行为转化为增量的应用内互动、购买以及更强的投资回报。 |
| 2026年7月3日 | 产品优化 | MCP | 我们已上线 [TikTok for Business MCP 服务器](https://business-api.tiktok.com/portal/docs/tiktok-ads-mcp-server/v1.3),让您能够将 AI 智能体直接接入 TikTok 广告平台。智能体现在可以完成从推广系列创建、受众定向到实时出价调整和效果报表的完整广告投放工作流,大幅提升团队运营效率并解锁全新的自动化能力。 |
| 2026年7月3日 | 产品优化 | 技能管理 | 我们已在 TikTok for Business Developers 门户网站上线<b>我的技能</b>模块,使您能够上传自己的技能并发布至 TikTok for Business Agentic Hub。作为 TikTok 上 AI 驱动的自动化广告解决方案的集中市场,Agentic Hub 帮助您的技能触达更广泛的用户群体。如需了解详情,参见[技能管理](https://business-api.tiktok.com/portal/docs/skill-management/v1.3)。 |
2026年6月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2026年6月26日 | 产品优化 | 推广系列管理 | 我们已在 [/smart_plus/adgroup/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad-group/v1.3)、[/smart_plus/adgroup/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad-group/v1.3) 和 [/smart_plus/adgroup/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ad-groups/v1.3) 接口中新增参数 `tiktok_subplacements`,为升级版 Smart+ 广告组扩展了广告位选项。通过该参数,您的广告可投放至 Lemon8 和 PineDrama,在这两个应用的沉浸式、高注意力体验中触达更易转化的受众。 |
| 2026年6月26日 | 产品优化 | 推广系列管理 | 我们已在 [/smart_plus/adgroup/update/](1843317411665921.html) 接口中新增了请求参数 `ad_material_id`,让您能够更简便地修改广告中的非创意内容。此更新免去了重新输入所有相关参数的繁琐步骤,使您的更新流程更加高效。 |
| 2026年6月26日 | 产品优化 | 推广系列管理 | 我们已在升级版 Smart+ 广告接口 [/smart_plus/ad/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad/v1.3)、[/smart_plus/ad/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad/v1.3) 和 [/smart_plus/ad/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ads/v1.3) 中新增参数 `playable_list`,扩展了试玩广告能力。该样式邀请用户在信息流中与应用的演示版本进行互动,将被动曝光转化为高意向参与,从而提升转化表现。 |
| 2026年6月26日 | 产品优化 | 推广系列管理 | 我们已在升级版 Smart+ 广告接口 [/smart_plus/ad/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad/v1.3)、[/smart_plus/ad/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad/v1.3) 和 [/smart_plus/ad/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ads/v1.3) 中新增了参数 `product_card_type`。借助这一新增能力,升级版 Smart+ 电商商品库广告的商品卡展示类型可灵活配置,让您能够以最具吸引力的方式呈现商品。 |
| 2026年6月26日 | 产品优化 | 推广系列管理 | 我们已在 [/smart_plus/ad/preview/](https://business-api.tiktok.com/portal/docs/preview-upgraded-smart-ads/v1.3) 中新增了请求参数 `call_to_action_id`,使您能够在升级版 Smart+ 广告中预览动态 CTA。这种上线前的可视化能力可帮助您验证创意版本,减少上线后的高成本调整。 |
| 2026年6月26日 | 产品优化 | TikTok One | 我们已在 [/tto/tcm/brand/profile/create/](https://business-api.tiktok.com/portal/docs/create-a-brand-profile-for-your-tto-account/v1.3) 和 [/tto/tcm/brand/profile/get/](https://business-api.tiktok.com/portal/docs/get-the-brand-profiles-for-your-tto-account/v1.3) 接口中引入了参数 `tiktok_account_url`。通过将 TikTok 账户关联到 TikTok One 品牌主页,敏感行业的品牌也能在 TikTok One 上开展达人合作,且内容投放会自动投放至年龄合适的受众。 |
| 2026年6月18日 | 产品优化 | TikTok One | 我们已在 [/tto/tcm/report/](https://business-api.tiktok.com/portal/docs/report-on-tto-creator-marketplace-videos/v1.3) 的 `daily_stats` 对象数组中新增返回参数 `engagement_rate_organic`、`engagement_rate_paid`、`likes_organic`、`likes_paid`、`comments_organic`、`comments_paid`、`shares_organic` 和 `shares_paid`。此功能为您提供 TikTok One Creator Marketplace 营销活动中视频的每日自然流量与付费流量带来的互动率、点赞数、评论数和分享数的细分数据。 |
| 2026年6月18日 | 产品优化 | 账号 | 我们已在 Webhook 事件 [comment.update](https://business-api.tiktok.com/portal/docs/comment-update-event/v1.3) 的数据结构中新增参数 `text`,使您能够在 Webhook 通知中获取评论文本内容。通过在 Webhook 通知中直接包含评论内容,此更新可简化跟踪和响应 TikTok 账户评论活动的流程。 |
| 2026年6月18日 | 产品优化 | 其他 | 我们已在 [/identity/video/get/](https://business-api.tiktok.com/portal/docs/get-posts-under-an-identity/v1.3) 中新增请求参数 `exclude_adsonly`,使您能够从返回结果中排除仅通过广告显示的帖子。此功能让您在检索广告发布身份下的帖子时,拥有更精准的控制。 |
| 2026年6月12日 | 产品优化 | 推广系列管理 | 我们已上线两个新接口 [/smart_plus/campaign/copy/task/create/](https://business-api.tiktok.com/portal/docs/create-an-asynchronous-copy-task-for-an-upgraded-smart-campaign/v1.3) 和 [/smart_plus/campaign/copy/task/check/](https://business-api.tiktok.com/portal/docs/get-the-results-of-an-asynchronous-copy-task-for-an-upgraded-smart-campaign/v1.3),用于异步复制升级版 Smart+ 推广系列。该功能让您轻松复制现有推广系列配置,从而加速广告创建工作流程。如需了解具体步骤,参见[复制升级版 Smart+ 推广系列](https://business-api.tiktok.com/portal/docs/copy-an-upgraded-smart-campaign/v1.3)。 |
| 2026年6月12日 | 产品优化 | 推广系列管理 | 我们已支持通过在升级版 Smart+ 广告接口 [/smart_plus/ad/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad/v1.3)、[/smart_plus/ad/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad/v1.3)、[/smart_plus/ad/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ads/v1.3) 和 [/smart_plus/ad/preview/](https://business-api.tiktok.com/portal/docs/preview-upgraded-smart-ads/v1.3) 的 `catalog_media_settings` 参数中新增枚举值 `MULTI_SHOW`,支持创建和预览多影片格式的升级版 Smart+ 流媒体广告。该动态轮播体验支持从商品库自动播放多个视频磁贴,最大化产品曝光和用户互动。如需了解如何创建此类广告,参见[创建升级版 Smart+ 流媒体广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-streaming-ads/v1.3)。 |
| 2026年6月12日 | 产品优化 | 报表管理 | 我们已在同步基础报表中新增[维度](https://business-api.tiktok.com/portal/docs/basic-reports-supported-dimensions/v1.3) `minis_id` 和[属性指标](https://business-api.tiktok.com/portal/docs/basic-reports-supported-metrics/v1.3) `minis_name` 及 `optimization_event`。这些新增内容使您能够按各 TikTok Minis 监控小游戏和短剧广告表现,并分别追踪应用内购买价值优化(VBO IAP)和应用内广告价值优化(VBO IAA)广告的效果,获取更精细的表现洞察。 |
| 2026年6月5日 | 产品优化 | 推广系列管理 | 我们已在升级版 Smart+ 广告接口([/smart_plus/ad/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad/v1.3)、[/smart_plus/ad/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad/v1.3) 和 [/smart_plus/ad/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ads/v1.3))中新增了参数 `viewability_postbid_partner`、`viewability_vast_url`、`brand_safety_postbid_partner` 和 `brand_safety_vast_url`。这些新增参数使您能够为[常规升级版 Smart+ 网站推广系列](https://business-api.tiktok.com/portal/docs/create-a-regular-upgraded-smart-web-campaign/v1.3)和[升级版 Smart+ 电商商品库广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-e-commerce-catalog-ads/v1.3)配置出价后第三方可见性和品牌安全监测设置,从而在三方平台衡量广告的可见度与品牌安全。 |
| 2026年6月5日 | 产品优化 | 报表管理 |我们已在同步基础报表中新增 [TikTok 付费流量与自然流量指标](https://business-api.tiktok.com/portal/docs/basic-reports-supported-metrics/v1.3#item-link-付费流量与自然流量指标),使您能够监测[升级版 Smart+ Minis 推广系列](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-minis-campaign/v1.3)的付费和自然流量表现。此功能可帮助您全面评估推广系列的整体效果,为优化投放策略提供深度洞察。 |
2026年5月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2026年5月29日 | 产品优化 | 推广系列管理 | 我们新增了四个接口 [/gmv_max/creation/custom_anchor_video_list/create/](https://business-api.tiktok.com/portal/docs/create-shop-level-customized-tiktok-posts/v1.3)、[/gmv_max/creation/custom_anchor_video_list/get/](https://business-api.tiktok.com/portal/docs/get-customized-tiktok-posts/v1.3)、[/gmv_max/creation/custom_anchor_video_list/delete/](https://business-api.tiktok.com/portal/docs/delete-customized-tiktok-posts/v1.3) 和 [/gmv_max/creation/shop_video/video_anchors/](https://business-api.tiktok.com/portal/docs/get-product-linkage-details-of-videos-in-customized-posts/v1.3),使您能够创建、检索和删除店铺层级的自定义 TikTok 作品,以及在店铺和推广系列层级检索自定义作品中视频的商品关联详情。这些功能优化了在店铺层级将商品与视频配对的流程,并确保当关联商品属于投放中推广系列时,视频能自动添加到相关推广系列中。 |
| 2026年5月22日 | 产品优化 | 其他 | 我们已为 [/page/get/](https://business-api.tiktok.com/portal/docs/get-the-page-id/v1.3) 新增两个返回参数 `template_name` 和 `supported_objectives`。借助此项更新,您可以快速识别指定页面模板所支持的推广目标,更高效、更可靠地将即时体验页面整合到广告投放中。 |
| 2026年5月15日 | 产品优化 | 账号 | 我们优化了 [/business/video/list/](https://business-api.tiktok.com/portal/docs/get-post-data-of-a-tiktok-account/v1.3) 接口,新增了返回参数 `is_ad`,并将其添加为请求参数 `fields` 中支持的字段。您现在可以识别帖子是否正作为广告进行推广。更高的可见性简化了监控 Spark Ads 表现和筛选可授权广告贴子的流程。 |
| 2026年5月8日 | 产品优化 | 推广系列管理 | 我们已优化 Pulse 广告组,支持 6 秒完播率(View+)优化目标。此功能需在 [/adgroup/rf/create/](https://business-api.tiktok.com/portal/docs/create-an-r&f-ad-group/v1.3) 接口将 `optimization_goal` 设为 `REACH`,并将 `cpv_video_duration` 设为 `SIX_SECONDS`。此外,我们通过为 `delivery_mode` 参数新增枚举值 `VIEW_OPTIMIZE`,在 [/adgroup/rf/create/](https://business-api.tiktok.com/portal/docs/create-an-r&f-ad-group/v1.3)、[/adgroup/rf/update/](https://business-api.tiktok.com/portal/docs/update-an-r&f-ad-group/v1.3) 和 [/adgroup/get/](https://business-api.tiktok.com/portal/docs/get-ad-groups/v1.3) 接口中提供了一种以播放量为优化目标的投放策略,旨在助您最大极限提升完播率并获得更多用户关注。 |
2026年4月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2026年4月24日 | 产品优化 | 推广系列管理 | 我们已将创新互动样式的支持范围扩展至常规升级版 Smart+ 网站推广系列和升级版 Smart+ 电商商品库广告。您现在可以使用 [/smart_plus/ad/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad/v1.3) 和 [/smart_plus/ad/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad/v1.3) 接口中的 `interactive_add_on_list` 参数来管理这些创新互动样式,从而提升用户互动。了解如何创建使用此功能的[常规升级版 Smart+ 网站推广系列](https://business-api.tiktok.com/portal/docs/create-a-regular-upgraded-smart-web-campaign/v1.3)和[升级版 Smart+ 电商商品库广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-e-commerce-catalog-ads/v1.3)。 |
| 2026年4月24日 | 产品优化 | 报表管理 | 我们增强了报表功能,新增了三个社交指标:`cost_per_consideration`、`new_consideration_rate` 和 `new_consideration_size`。这些指标现已支持在[基础报表](https://business-api.tiktok.com/portal/docs/basic-reports-supported-metrics/v1.3)和[升级版 Smart+ 素材概览报表](https://business-api.tiktok.com/portal/docs/supported-ad-level-metrics-for-upgraded-smart-creative-reports/v1.3)中查看,为您提供更深入的意向受众洞察。 |
| 2026年4月24日 | 产品优化 | 工具 | 我们扩展了关键词发现功能,支持[/tool/search_keyword/keyword_idea/](https://business-api.tiktok.com/portal/docs/discover-new-keywords/v1.3) 接口在 11 个新增地域发现关键词。您现在可以在更多市场研究关键词,例如英国、法国和加拿大,让您更深入地洞察本地搜索趋势。 |
| 2026年4月17日 | 产品优化 | 推广系列管理 | 我们已拓展升级版 Smart+ 应用安装和应用再营销推广系列的年龄定向选项。您现在可以通过在 [/smart_plus/adgroup/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad-group/v1.3)、[/smart_plus/adgroup/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad-group/v1.3) 和 [/smart_plus/adgroup/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ad-groups/v1.3) 接口的 `age_groups` 参数中使用新增的枚举值 `AGE_13_17` 以及在 `spc_audience_age` 参数中使用 `ALL` 来定向 13-17 岁的用户。 |
| 2026年4月17日 | 产品优化 | 推广系列管理 | 我们已将自定义受众再营销功能的功能拓展至[升级版 Smart+ 商品库应用广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-catalog-ads-for-app/v1.3)和[升级版 Smart+ 电商商品库广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-e-commerce-catalog-ads/v1.3)中。您现在可以在 [/smart_plus/adgroup/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad-group/v1.3)、[/smart_plus/adgroup/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad-group/v1.3) 和 [/smart_plus/adgroup/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ad-groups/v1.3) 接口中使用参数 `shopping_ads_retargeting_type`、`shopping_ads_retargeting_actions_days`、`included_custom_actions`、`excluded_custom_actions` 和 `shopping_ads_retargeting_custom_audience_relation`,在这些广告中基于特定用户行为进行再营销。 |
| 2026年4月10日 | 产品优化 | 推广系列管理 |我们在[/smart_plus/ad/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad/v1.3)、[/smart_plus/ad/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad/v1.3)和[/smart_plus/ad/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ads/v1.3)接口新增了 `tracking_pixel_id` 和 `tracking_offline_event_set_ids` 参数,扩展了升级版 Smart+ 应用安装和应用再营销推广系列的监测功能。此项功能可帮助您衡量全面的用户互动,包括加入购物车等线上网站活动和店铺付费等线下事件。 |
| 2026年4月3日 | 产品优化 | 推广系列管理 | 我们已在启用网站和应用优化的升级版 Smart+ 商品库广告中新增了自定义受众再营销功能。您现在可以在 [/smart_plus/adgroup/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad-group/v1.3)、[/smart_plus/adgroup/update/](https://business-api.tiktok.com/portal/docs/update-an-upgraded-smart-ad-group/v1.3) 和 [/smart_plus/adgroup/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ad-groups/v1.3) 接口中使用新增的参数 `shopping_ads_retargeting_type`、`shopping_ads_retargeting_actions_days`、`included_custom_actions`、`excluded_custom_actions` 和 `shopping_ads_retargeting_custom_audience_relation`,基于特定用户行为进行再营销。 |
| 2026年4月3日 | 产品优化 | 推广系列管理 | 我们已上线新接口 [/campaign/gmv_max/creative/update/](https://business-api.tiktok.com/portal/docs/remove-or-add-back-creatives-in-a-gmv-max-campaign/v1.3),以简化 GMV Max 推广系列的创意素材管理。您现在可以轻松地在商品或直播 GMV Max 推广系列中移除或重新添加创意,确保您的广告投放保持敏捷和高效。 |
| 2026年4月3日 | 产品优化 | 报表管理 | 我们扩展了商品 GMV Max 推广系列的报表功能,在创意层级新增了两个维度组合:`["campaign_id","item_group_id","item_id","stat_time_day"]` 和 `["item_id","stat_time_day"]`。这些新增功能使您能够进行更精细的表现追踪和优化。了解有关[ GMV Max 推广系列报表中指标](https://business-api.tiktok.com/portal/docs/metrics-in-gmv-max-campaign-reports/v1.3)的详情。 |
| 2026年4月3日 | 产品优化 | 开发者体验 | 我们已将开发者文档链接更新为更具语义和描述性的格式。新链接基于文档标题和内容生成,让您能够一目了然地识别将要阅读的内容。
2026年3月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2026年3月27日 | 产品优化 | 推广系列管理 | 我们已在 [/smart_plus/ad/create/](1843317390059522.html)、[/smart_plus/ad/update/](1843317411665921.html) 和 [/smart_plus/ad/get/](1843317378982914.html) 接口中新增了参数`product_titles`、`product_image_list`、`catalog_tag_list`、`promo_info_list` 和 `product_info_enabled`。通过将商品详情和促销码或优惠信息整合到您的升级版 Smart+ 广告中,您可以利用系统生成定制化广告版本,最终提升广告表现并突出优惠信息以促进用户与广告的互动。 |
| 2026年3月27日 | 产品优化 | 报表管理 | 我们已为同步受众分析报表添加了 `bucket_id` 和 `stat_time_hour` [维度](1751454103714818.html)以及 `cost` [指标](1751454162042882.html)。您可以按实时 API 分桶 ID 对报表数据进行分组,从而能够根据不同分桶的用户特征微调您的实时出价策略,并评估不同流量细分上的多种策略。 |
| 2026年3月20日 | 产品优化 | 报表管理 | 我们优化了基础报表,新增了 TikTok 指标,以便您获取用户在付费、广告收入和订阅等方面的行为的洞察数据。本次更新能让您更有效地追踪关键业绩指标。如需了解详情,请参阅[基础报表 > 支持的指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-v1.2与v1.3版本对比)中的“<b>v1.2与v1.3版本对比</b>”部分。 |
| 2026年3月20日 | 产品优化 | 报表管理 | 我们上线了[报表订阅 API](https://business-api.tiktok.com/portal/docs?id=1859914816615617),使您能够监控 `spend`、`impressions`、`clicks` 和 `video_play_actions` 等报表指标数据的变更。这一工具为您的广告账户提供分钟级通知,助力您更快地基于数据作出决策。 |
| 2026年3月20日 | 产品优化 | 商务中心 | 我们推出了多项优化,以简化您对财务资产组合的管理。关键更新包括在 [/bc/balance/get/](1739939128198145.html) 中添加 `payment_portfolio_id` 参数用于余额查询,在 [/bc/transfer/](1739939095321601.html) 中添加该参数用于转账,该接口现在还会通过`payee_account` 和 `remitter_account` 参数返回转账参与方的详情。此外,还在 [/advertiser/balance/get/](1739939106470913.html),[/payment_portfolio/create/](1839151986039809.html)和 [/payment_portfolio/get/](1839151931301954.html)接口中添加了 `payment_portfolio_type` 返回字段,以便更方便地识别高级和标准财务资产组合。 |
| 2026年3月13日 | 产品优化 | 推广系列管理| 我们推出了一系列更新,旨在让您更好地控制 Spark Ads 推送内容。您现在可以从 [/identity/get/](1740218420781057.html) 检索 `ads_only_mode` 和 `username`,并从 [/identity/info/](1740218453385217.html) 检索 `username`。此外,[/advertiser/info/](1739593083610113.html) 现已支持 `ads_only_mode`,帮助您验证广告账户的强制开启“仅在广告中显示”模式状态,避免 Spark Ads 推送内容意外发布为主页可见帖子。 |
| 2026年3月13日 | 产品优化 | 推广系列管理| 我们优化了升级版 Smart+ 电商商品库广告的功能。升级版 Smart+ 广告接口([/smart_plus/ad/create/](1843317390059522.html)、[/smart_plus/ad/update/](1843317411665921.html) 和 [/smart_plus/ad/get/](1843317378982914.html))现已支持 `identity_authorized_bc_id`、`catalog_creative_info` 以及新的广告发布身份类型 `TT_USER` 和 `BC_AUTH_TT`。这使您可以利用 Spark Ads 搭配更灵活的商品库创意素材媒体设置。 |
| 2026年3月13日 | 产品优化 | 推广系列管理| 我们为升级版 Smart+ 电商商品库广告优化了广告预览功能。[/smart_plus/ad/preview/](1843317445798914.html) 接口现在可传入 `identity_authorized_bc_id` 和 `catalog_creative_info`。同时,它还支持新的 `identity_type` 枚举值 `TT_USER` 和 `BC_AUTH_TT`,让您能够精确预览使用 Spark Ads 搭配更灵活的商品库创意素材媒体设置的电商商品库广告。 |
| 2026年3月6日 | 产品优化 | 推广系列管理 | 我们已将 [/campaign/gmv_max/create/](1822000988713089.html) 和 [/campaign/gmv_max/update/](1822001009002497.html) 接口的请求参数 `item_group_ids` 的最大数量从 50 扩展到 400。此项优化让您可以在单个商品 GMV Max 推广系列中包含更多商品,从而简化您的推广系列管理。 |
| 2026年3月6日 | 产品优化 | 推广系列管理 | 我们已在 [/store/product/get/](1793482248880130.html) 接口的返回中添加了 `quantity` 参数。这个新字段提供了您 TikTok Shop 的商品数量,方便规划和执行商品 GMV Max 推广系列。 |
| 2026年3月6日 | 产品优化 | 推广系列管理 | 我们已在 GMV Max 推广系列 API 接口中添加了 `accelerate_testing_for_new_videos` 参数,包括 [/campaign/gmv_max/create/](1822000988713089.html)、[/campaign/gmv_max/update/](1822001009002497.html) 和 [/campaign/gmv_max/info/](1822000968821762.html)。您现在可以开启加速新视频测试,以快速评估推广系列中新视频、近期授权视频和更新视频的效果。 |
| 2026年3月6日 | 产品优化 | 推广系列管理 | 我们通过 [/bc/advertiser/create/](1739939020318721.html) 接口优化了广告账号创建流程。该接口现在支持 `payment_info` 请求参数,并返回 `payment_portfolio_binding_result` 和 `budget_setup_result`,从而支持在创建账号的同时关联财务资产组合和配置预算。 |
| 2026年3月6日 | 产品优化 | 推广系列管理 | 我们向 [/bc/transfer/](1739939095321601.html) 接口添加了 `amount_info` 请求参数。这使您能够指定在广告账户级别处理的确切现金、赠款或信用额度,从而实现更精确的资金控制。 |
2026年2月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2026年2月27日 | 产品优化 | 推广系列管理 | 我们在升级版 Smart+ API 接口([/smart_plus/campaign/create/](1843312852800706.html)、[/smart_plus/campaign/update/](1843312876001282.html) 和 [/smart_plus/campaign/get/](1843312818332930.html))中为未开启推广系列预算优化的推广系列增加了更多预算选项。您现在可以使用 `budget_mode` 参数的 `BUDGET_MODE_DAY` 和 `BUDGET_MODE_TOTAL` 枚举值,为未开启推广系列预算优化的推广系列下的所有广告组设置日预算或总预算限制。这项优化让您能更精确地分配预算,确保更高效的推广系列支出。 |
| 2026年2月13日 | 产品优化 | 账号 | 我们优化了评论功能。新上线的 [/business/comment/image/upload/](1856212334897154.html) 接口可用于上传图片,随后可以通过 [/business/comment/create/](1762228442072066.html) 和 [/business/comment/reply/create/](1762228448779266.html) 中新增的请求参数(`image_uri`、`image_width`、`image_height`)和返回参数(`image_url`)来创建带图片的评论或回复。您还可以通过 [/business/comment/list/](1760232109619202.html) 和 [/business/comment/reply/list/](1762228430145538.html) 中的 `image_url` 返回参数来检索评论和回复中的图片。 |
| 2026年2月6日 | 产品优化 | 推广系列管理 |我们发布了[升级版 Smart+ API](1843301794874370.html),该 API 支持管理升级版 Smart+ 推广系列这种经过优化的推广系列结构,内置升级版 Smart+ 推广系列管理功能。此功能可帮助您在统一的框架内更高效地创建和管理推广系列。了解更多关于[升级版 Smart+ 推广系列](1853452461203458.html)的详情。 |
| 2026年2月6日 | 产品优化 | 推广系列管理 | 我们已在升级版 Smart+ 推广系列接口中新增 `disclaimer` 参数,包括 [/smart_plus/ad/create/](1843317390059522.html)、[/smart_plus/ad/update/](1843317411665921.html) 和 [/smart_plus/ad/get/](1843317378982914.html)。您现在可以为升级版 Smart+ 广告配置纯文本或文字链免责声明,确保合规性和信息清晰度。 |
| 2026年2月6日 | 产品优化 | 推广系列管理 | 我们已在升级版 Smart+ 推广系列接口 [/smart_plus/ad/create/](1843317390059522.html)、[/smart_plus/ad/update/](1843317411665921.html) 和 [/smart_plus/ad/get/](1843317378982914.html) 中新增了 `creative_auto_add_toggle` 参数。这使您能够控制是否在投放期间将新生成的素材自动添加到广告中,从而更精确地管理您的创意素材。 |
| 2026年2月6日 | 产品优化 | 推广系列管理 | 我们已在多个接口中新增 `creative_auto_enhancement_strategy_list` 参数。这包括升级版 Smart+ 推广系列接口 ([/smart_plus/ad/create/](1843317390059522.html)、[/smart_plus/ad/update/](1843317411665921.html)、[/smart_plus/ad/get/](1843317378982914.html))、手动广告接口 ([/ad/create/](1739953377508354.html)、[/ad/update/](1739953405142018.html)、[/ad/get/](1735735588640770.html))以及推广系列复制接口 [/campaign/copy/task/create/](1788434394151938.html)。此功能使您能够自动优化广告创意。[进一步了解自动优化](1855450880142402.html)。
| 2026年2月6日 | 产品优化 | 工具 | 我们上线了新接口 [/tool/search_keyword/keyword_idea/](1855460985594881.html)。该工具能帮助您为搜索广告推广系列发现新关键词,从而更有效地触达对您业务感兴趣的人群。 |
2026年1月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2026年1月30日 | 产品优化 | 推广系列管理 | 我们优化了 [/gmv_max/report/get/](1824721673497601.html) 接口,在 `campaign_statuses` 参数中增加了枚举值 `STATUS_ALL`。您可以通过该功能一次性获取所有 GMV Max 推广系列的成效数据,全面掌握广告活动的表现。 |
| 2026年1月30日 | 产品优化 | 通用 | 我们已在 [/identity/info/](1740218453385217.html) 接口中新增 `ads_only_mode` 返回参数。这个新参数能帮助您确认某个身份是否仅限在“仅广告模式”下创建广告,让您能更好地控制仅限广告的内容投放。 |
| 2026年1月30日 | 产品优化 | 商务中心 | 我们上线了新接口 [/bc/oa/create/](1855027199571138.html) ,用于在直客或代理商商务中心内创建机构号。此外,[/bc/get/](1737115687501826.html) 中新增的 `verification_status` 返回参数可让您在创建账号前检查商务中心的验证状态,确保设置过程更顺畅。更多详情请参阅[机构号](1855026897423361.html)。 |
| 2026年1月30日 | 产品功能增强 | 商务中心 | 我们增强了商务中心的功能,以实现更简化的 TikTok 账号管理。<ul><li>[/bc/asset/advertiser/assign/](1846868953025538.html) 接口现在支持通过 `asset_type` 参数,可关联用于广告投放和原生经营的 TikTok 账号。</li><li>此外,还上线了两个新接口:[/bc/asset/advertiser/unassign/](1855027260369921.html) 用于撤销 TikTok 账号与广告账号的关联,以及 [/bc/asset/advertiser/assigned/](1855027294743554.html) 用于获取已关联至广告账号的 TikTok 账号列表。</li><li>为更方便检索和管理,`MANAGED_BUSINESS_ACCOUNT` 枚举值已添加到 [/bc/asset/admin/get/](1739433007779841.html)、[/bc/asset/get/](1739432717798401.html) 和 [/bc/asset/member/get/](1739659558931458.html) 接口的 `asset_type` 参数中。这些接口还会返回更丰富的数据,新增的返回参数包括 `business_account_roles`、`is_business_verified`、`operating_region_code`、`tt_asset_handle` 和 `tt_asset_profile_image`。</li><li>最后,[/bc/asset/assign/](1739438211077121.html) 和 [/bc/asset/unassign/](1739448126749698.html) 接口的 `asset_type` 参数中也新增枚举值 `MANAGED_BUSINESS_ACCOUNT` ,从而简化权限管理工作流,其中`/bc/asset/assign/`接口还新增请求参数 `business_account_roles` ,以实现更精细的角色分配。</li></ul>|
| 2026年1月16日 | 产品优化 | 创意管理 | 我们更新了 [/creative/ads_preview/create/](1739403070695426.html) 接口,支持预览竞价覆盖人数广告的 CapCut 和 Lemon8 版位。此次更新包括为 `placement` 参数新增枚举值 `PLACEMENT_GLOBAL_APP_BUNDLE`、新增请求参数 `tiktok_subplacement` ,以及为 `preview_format` 参数新增枚举值 `IN_FEED_TWO_COLUMNS`。|
| 2026年1月9日 | 产品优化 | 推广系列管理 | 我们优化了 GMV Max 推广系列的管理,在 [/campaign/gmv_max/create/](1822000988713089.html)、[/campaign/gmv_max/update/](1822001009002497.html) 和 [/campaign/gmv_max/info/](1822000968821762.html) 接口中新增了 `promotion_days` 和 `auto_budget` 参数。您现在可以在推广日和非推广日启用自动增加预算,并自定义增加百分比和增加上限,以实现更佳的推广效果。 |
| 2026年1月9日 | 产品优化 | 推广系列管理 | 我们已支持使用 Zefr 进行可见度监测。[/ad/create/](1739953377508354.html) 接口的请求和返回中的 `viewability_postbid_partner` 参数新增了枚举值 `ZEFR`,使您能够选择 Zefr 作为手动广告的投后第三方可见性监测合作伙伴。 |
| 2026年1月9日 | 产品优化 | 推广系列管理 | 我们为搜索广告推广系列提供了库存筛选和内容类型排除功能。您可以通过 [/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114) 接口中的 `brand_safety_type` 和 `category_exclusion_ids` 参数启用这些功能。有关使用场景的更多详细信息,参阅[创建搜索广告系列](1815394136739841.html)指南。 |
2025年
2025年12月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2025年12月26日 | 产品优化 | 通用 | 我们为 [/oauth2/access_token/](1739965703387137.html) 接口新增了 `return_advertiser_ids` 请求参数。现在,您可以在请求访问令牌时不检索关联的全部广告账号,这可以缩短响应时间,避免因令牌可访问的广告账号数量过多而导致的超时。 |
| 2025年12月19日 | 产品优化 | 报表 | 我们上线了新接口 [/campaign_label/get/](1851286489283585.html),用于检索广告账户的推广系列标签。此外,还在同步[基础](1751443975608321.html)、[受众](1751454172429314.html)和 [DSA](1751625296192514.html) 报表中添加了筛选条件 `campaign_label_ids`、`campaign_label_names` 和 `campaign_label_types` ,助您基于推广系列标签优化数据分析。 |
| 2025年12月19日 | 产品优化 | 推广系列管理 | 我们增强了搜索广告推广系列的品牌安全控制,支持通过 `brand_safety_type` 参数为所有搜索广告推广系列启用 TikTok 库存筛选功能。此外,还可以使用 `category_exclusion_ids` 参数为推广目标为访问量和线索收集的搜索广告推广系列启用内容类别排除,确保您的广告与适宜的内容一同展示。更多详情请参阅[创建搜索广告推广系列](1815394136739841.html)。 |
| 2025年12月19日 | 产品优化 | 账号 | 我们为 [/business/video/list/](1762228421622786.html) 接口新增了返回参数 `media_type` 。该功能使您提清晰地识别和区分视频帖子和图片或文本帖子,从而简化内容管理。 |
| 2025年12月12日 | 产品优化 | 报表管理 | 我们扩展了基础报表,新增了 TikTok 指标,从而可以更深入地洞察用户行为,例如付费、结账和广告展示。若想了解新增指标详情,参阅[基础报表 > 支持的指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-v1.2%E4%B8%8Ev1.3%E7%89%88%E6%9C%AC%E5%AF%B9%E6%AF%94)文档中的“<b>v1.2与v1.3版本对比</b>”小节。 |
| 2025年12月12日 | 产品优化 | 事件 | 我们在 [/pixel/create/](1740858779758593.html)、[/pixel/update/](1740858799524865.html) 和 [/pixel/list/](1740858697598978.html) 接口中新增了参数 `automatic_advanced_matching_fields`、`enable_first_party_cookies` 和 `enable_expanded_data_sharing`。这些参数可以更精细地控制 Pixel 的自动高级匹配、第一方 Cookie 和扩展数据共享设置,从而提高归因效果和性能。 |
| 2025年12月5日 | 产品优化 | 工具 | 我们优化了 [/tool/search_keyword/recommend/](1838630375757825.html) 接口,新增了请求参数 `ad_ids` 和 `landing_page_urls`。此次更新使您能够根据广告 ID 或落地页 URL 获取推荐的搜索关键词,帮助您发现更多关键词并提升创意相关性。 |
| 2025年12月5日 | 产品优化 | 其他 | 我们在 [/identity/get/](1740218420781057.html) 和 [/identity/info/](1740218453385217.html) 接口中新增了返回参数 `is_gpppa`。此参数可以帮助您识别一个 TikTok 账号是否为[政府、政治人物和政党账号](https://support.tiktok.com/en/using-tiktok/growing-your-audience/government-politician-and-political-party-accounts),从而让您在创建 Spark Ads 时排除这些账号。 |
2025年11月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2025年11月28日 | 产品优化 | 商务中心 | 我们通过在 [/bc/invoice/task/create/](1754000448122882.html) 接口中添加 `campaign_id` 请求参数,优化了发票创建流程。此功能允许您按特定推广系列 ID 筛选发票,从而在推广系列层级进行更精细的财务分析和报告。 |
| 2025年11月28日 | 产品优化 | 推广系列管理 | 我们为 Smart+ 推广系列引入了自动增加预算功能,可通过 [/campaign/spc/create/](1767334204047362.html)、[/campaign/spc/update/](1767334250066945.html) 和 [/campaign/spc/get/](1767334299811842.html) 接口管理。现在,您可以使用 `budget_auto_adjust_strategy` 参数启用自动增加预算,从而在满足目标 CPA、第 0 天目标 ROAS 和预算要求时允许预算自动增加,并使用 `current_budget` 检索最新预算,从而帮助您在减少预算的手动操作的同时最大化广告效果。 |
| 2025年11月21日 | 产品优化 | 推广系列管理 | 我们扩展了推广系列管理功能,以支持推广目标为 `REACH` 的轮播广告。您现在可以通过 [/ad/create/](1739953377508354.html) 和 [/creative/ads_preview/create/](1739403070695426.html) 接口中的 `ad_format` 参数来创建或预览这些广告。详细创建步骤可参阅[创建轮播广告](1766217791987713.html)。 |
| 2025年11月14日 | 产品优化 | 报表管理 | 我们增强了报表功能,为直播 GMV Max 推广系列引入了新的指标。您现在可以在推广系列、直播间和时长层级拉取 `all_shops_orders`、`all_shops_cost_per_order`、`all_shops_gross_revenue` 和 `all_shops_roi`指标,从而更深入地了解您在所有店铺的推广系列表现。更多详情参阅 [GMV Max 推广系列报表中的指标](1824722485971009.html)。 |
| 2025年11月14日 | 产品优化 | 商务中心 | 我们增强了商务中心功能,以更有效地管理 TikTok 账号广告投放权限。您现在可以使用 [/bc/asset/account/authorization/](1846868897541122.html) 生成广告投放权限的授权 URL,并使用 [/bc/asset/advertiser/assign/](1846868953025538.html) 将 TikTok 账号关联到商务中心中的广告账号。 |
| 2025年11月14日 | 产品优化 | 工具 | 我们为搜索广告推广系列推出了健康诊断工具。该工具可通过 [/tool/diagnosis/search/health/](1848591212970082.html) 接口使用,为您提供有关搜索量和关键词相关性的洞察,以及出价和预算建议,以提高您的推广系列效果。 |
| 2025年11月14日 | 产品优化 | 商品库管理 | 我们在酒店商品库接口([/catalog/product/upload/](1740497429681153.html), [/catalog/product/update/](1740562287852546.html), [/catalog/product/file/](1740496787164161.html) 和 [/catalog/product/get/](1740564136678402.html))中进行了多项优化,具体包括:<ul><li>移除参数 `phone`、`cancellation_policy`、`hotel_room_id`、`meal_policy`、`amenities` 和 `total_price`。</li><li>新增参数 `secondary_address`、`tertiary_address`、`postal_code`、`internal_label_0` 和 `internal_label_1`。</li><li>将 `hotel_category` 和 `room_type` 参数的数据类型更改为字符串数组。</li><li>将 `hotel_category`、`loyalty_program` 和 `room_type` 参数的值更改为枚举值。</li><li>将 `guest_ratings` 的最大数量从 5 降低为 1。</li><li>将 `additional_image_urls` 的最大数量从 10 增加到 20。</li><li>将 `description`、`availability` 和 `region` 参数从必填更改为可选。</li></ul>此外,我们还支持了[酒店商品库的 CSV 模板中的别名字段](https://business-api.tiktok.com/portal/docs?id=1740496787164161#item-link-酒店商品库的别名字段)。<br>这些优化简化了您的商品库设置,并增强了与其他平台的集成。 |
| 2025年11月7日 | 产品优化 | 推广系列管理 | 我们增强了推广系列功能,为[手动商品库广告](1839882947475458.html)和[手动非商品库广告](1839882969587906.html)支持网站和应用优化,让您可以整合对网站和应用受众的广告投放。要实现此功能,在推广系列接口 ([/campaign/create/](1739318962329602.html),[/campaign/update/](1739320422086657.html)和[/campaign/get/](1739315828649986.html)) 中为`sales_destination`参数使用新的枚举值`WEB_AND_APP`,并在广告组接口 ([/adgroup/create/](1739499616346114.html),[/adgroup/update/](1739586761631745.html)和[/adgroup/get/](1739314558673922.html)) 中使用`app_config`参数。 |
2025年10月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2025年10月31日 | 产品优化 | 推广系列管理 | 我们通过在 [/campaign/get/](1739315828649986.html) 的 `objective_type` 参数中添加 `BRAND_CONSIDERATION` 枚举值,简化了对品牌认知推广系列的管理,该值既可用作筛选条件,也可用作返回标识。为了提供更全面的洞察,还支持将枚举值`BRAND_CONSIDERATION`用在[基础报表](1751443975608321.html)和[受众分析报表](1751454172429314.html)的 `objective_type` 筛选条件中。 |
| 2025年10月31日 | 产品优化 | 推广系列管理 | 我们扩展了竞价覆盖人数推广系列的触达范围,现已支持将广告组投放到 Lemon8 子版位。广告组 API([/adgroup/create/](1739499616346114.html)、[/adgroup/update/](1739586761631745.html) 和 [/adgroup/get/](1739314558673922.html))的 `tiktok_subplacements` 参数中对应新增 `LEMON8` 枚举值。此外,竞价覆盖人数广告组现在也可以投放到 `PLACEMENT_GLOBAL_APP_BUNDLE` 版位,助您触及更广泛的受众。 |
| 2025年10月31日 | 产品优化 | 推广系列管理 | 我们为食品和饮料广告引入了新的合规功能。我们在广告组接口([/adgroup/create/](1739499616346114.html)、[/adgroup/update/](1739586761631745.html) 和 [/adgroup/get/](1739314558673922.html))中新增 `is_lhf_compliance` 参数,方便您确认广告内容是否符合英国的 LHF(较不健康食品)法规。此外,您现在可以在这些接口中使用 `is_hfss` 参数,在定向英国、澳大利亚、新西兰和欧盟等地区的广告中声明推广 HFSS (高脂高盐和高糖)产品,确保广告的合规。 |
| 2025年10月31日 | 产品优化 | 其他 | 我们上线了 [API 服务状态页面](https://business-api.tiktok.com/portal/api-service-status),作为专门用于监控 API 性能、跟踪突发事件和查看历史数据的中心。如需自动获取相关更新,您可以通过 RSS 源订阅,或在我们订阅接口([/subscription/subscribe/](1739092028876801.html) 和 [/subscription/get/](1739093832125442.html))中使用 `subscribe_entity` 参数的新枚举值 `API_SERVICE_STATUS`,订阅接口还支持使用新的 `product_filters` 参数按产品进行筛选。 |
| 2025年10月31日 | 产品优化 | 商品库管理 | 我们为短剧商品库扩展了多地域投放功能。您现在可以使用 [/catalog/create/](1740306481704961.html) 和 [/catalog/get/](1740315452868610.html) 中的 `additional_config_list` 参数配置额外定向地域。上传短剧时,可在 [/catalog/product/upload/](1740497429681153.html) 中 JSON 格式的请求中使用 `target_config` 参数,或在通过 [/catalog/product/file/](1740496787164161.html) 上传的 CSV 文件中使用 `country` 属性参数。为了验证定向设置,可以在 [/catalog/product/get/](1740564136678402.html) 的返回结果中查看 `target_config` 和 `additional_product_list` 参数。 |
| 2025年10月31日 | 产品优化 | 商品库管理 | 我们简化了创建电商商品系列的流程。您可以使用新的 [/catalog/set/upload/](1846770644217858.html) 接口上传包含 SKU ID 列表的 CSV 文件,从而简化商品系列管理并节省您的时间。 |
| 2025年10月31日 | 产品优化 | 商品库管理 | 我们增强了商品库商品 API,以支持短剧商品库的视频属性。现在,您可以在 [/catalog/product/upload/](1740497429681153.html) 和 [/catalog/product/file/](1740496787164161.html) 接口中使用`video_url`(用于 JSON 上传)和 `video_link`(用于 CSV 文件)在短剧设置中包含视频内容。视频信息可以通过 [/catalog/product/get/](1740564136678402.html) 进行检索。 |
| 2025年10月17日 | 产品优化 | 推广系列管理 | 我们在[/campaign/gmv_max/update/](1822001009002497.html)接口中新增了请求参数`item_group_ids` ,使您能够动态调整商品 GMV Max 推广系列中的选品,以提升推广效果。 |
| 2025年10月17日 | 产品优化 | 商品库管理 | 我们精简了商品接口(包括 [/catalog/product/upload/](1740497429681153.html), [/catalog/product/update/](1740562287852546.html), [/catalog/product/file/](1740496787164161.html) 和 [/catalog/product/get/](1740564136678402.html))中娱乐商品库的设置,废弃了字段`availability`,`product_detail`, `product_detail.condition`,`star_rating`,`timeline`和 `category`。此外, `additional_image_urls` 的数量上限提高到 20,且`landing_page_url` 变为选填,以优化您的工作流程。我们还支持在 CSV 模板中将 `IMDb_id` 作为 `qid` 的别名,以改善跨平台集成的兼容性。 |
| 2025年10月17日 | 产品优化 | 商品库管理 | 我们更新了[/catalog/product/upload/](1740497429681153.html) 和 [/catalog/product/file/](1740496787164161.html)接口,对于酒店、航班和目的地商品库 `landing_page` 和 `landing_page_url`变为选填。此项优化提高了您在设置旅游相关的商品时的灵活性。 |
| 2025年10月17日 | 产品优化 | 账号 | 从 2025 年 10 月 15 日开始,我们为所有 URL 资源接口([/business/property/add/](https://ads.tiktok.com/marketing_api/docs?id=1769325280876545),[/business/property/verify/](https://ads.tiktok.com/marketing_api/docs?id=1769325308162050),[/business/property/delete/](https://ads.tiktok.com/marketing_api/docs?id=1769325351919617) 和 [/business/property/list/](https://ads.tiktok.com/marketing_api/docs?id=1769325368603650))新增了必填参数 `secret`。此安全措施旨在通过限制帖子的发布来源为已验证的网域和网址前缀,来防止未经授权的内容发布到您的 TikTok 账户。 |
2025年9月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2025年9月26日 | 产品优化 | 推广系列管理 | 我们在[ GMV Max 推广系列报表](1824722485971009.html)中为创意层级筛选字段 `creative_delivery_statuses` 和指标字段 `creative_delivery_status`新增了枚举值 `NOT_ACTIVE`。该功能增强了识别降级帖子的能力,有助于制定更有效的推广策略。 |
| 2025年9月26日 | 产品优化 | 商品库管理 | 我们在商品库商品接口([/catalog/product/upload/](1740497429681153.html), [/catalog/product/update/](1740562287852546.html), [/catalog/product/file/](1740496787164161.html) 和 [/catalog/product/get/](1740564136678402.html))中对航班商品库进行了多项优化,具体包括:<ul><li>移除参数 `flight_id`、`availability` 和 `total_price`</li><li>将 `cabin_class` 和 `airline_company` 参数的值更改为枚举值</li><li>新增参数 `internal_label_0` 和 `internal_label_1`</li><li>将 `additional_image_urls` 的最大数量从 10 增加到 20</li><li>将 `price` 参数从必填更改为可选</li></ul>此外,我们还支持了[航班商品库的 CSV 模板中的别名字段](https://business-api.tiktok.com/portal/docs?id=1740496787164161#item-link-航班商品库的别名字段)。<br>这些优化简化了您的商品库设置,方便您跨平台进行商品库集成。|
| 2025年9月19日 | 产品优化 | 推广系列管理 | 我们已优化广告组功能,为您提供更精细的广告组优化控制。现在,您可以通过在广告组接口([/adgroup/create/](1739499616346114.html)、[/adgroup/update/](1739586761631745.html) 和 [/adgroup/get/](1739314558673922.html))中使用新增的 `custom_conversion_id` 参数,为您的手动广告组指定自定义转化目标,该参数可与新上线的[自定义转化 API](1842225078560769.html) 结合使用。 |
| 2025年9月5日 | 产品优化 | 报表管理 | 我们在[商品库广告的异步 DSA 报表](1751625287345154.html)中新增了两个维度 `brand` 和 `content_category`。此更新支持按多个渠道(应用、网站和线下)对转化和付费价值进行分组,同时新增了三个线下指标:`offline_shopping_events`、`value_per_offline_shopping_event` 和 `offline_shopping_events_value`。通过基于品牌和内容类别并结合 SKU ID 和商品库 ID 的数据分析,您可发现表现最佳的商品和商品库,优化您的营销策略。 |
2025年8月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2025年8月15日 | 产品优化 | 推广系列管理| 我们已新增在商品 GMV Max 推广系列报表的商品和创意素材层级检索`cost`、`cost_per_order` 和 `roi` 指标的功能。这些新增指标使您能够评估每个商品和创意的表现与影响。若想了解所有可用指标,请查看 [GMV Max 推广系列报表中的指标](1824722485971009.html)。 |
| 2025年8月8日 | 产品优化 | 推广系列管理 | 我们已在 [/ad/update/](1739953405142018.html) 和 [/ad/get/](1735735588640770.html) 接口的返回参数 `viewability_postbid_partner` 中新增了枚举值 `ZEFR`。此功能使您能够检索和识别启用了 Zefr 出价后可见性监测功能的广告,从而提升您的分析能力。|
| 2025年8月1日 | 产品优化 | 推广系列管理 | 我们已在 [/gmv_max/report/get/](1824721673497601.html) 中新增了请求参数 `creative_delivery_statuses`,使您能够按状态获取详细的广告创意层级数据。此外,我们将筛选参数 `campaign_ids`、`item_group_ids` 和 `room_ids` 的限制提升至 100,并增加了多个层级的维度组合,从而优化您的数据分析能力。有关不同层级支持的指标和维度组合详情,请参阅 [GMV Max 推广系列报表中的指标](1824722485971009.html)。 |
| 2025年8月1日 | 产品优化 | 推广系列管理 | 搜索广告 API 已进入封闭 Beta 测试,使您能够创建基于关键词的搜索广告推广系列,通过搜索结果页面的原生体验触达 TikTok 用户。这一新增功能支持更有针对性的广告策略,提高曝光度和用户参与度。参阅[创建搜索广告推广系列](1815394136739841.html)了解具体操作步骤。 |
| 2025年8月1日 | 产品优化 | 商务中心 | 我们上线了[财务资产组合 API](1839151483689986.html),简化了您在 TikTok for Business 平台上管理支付选项的方式。此外,我们在 [/advertiser/balance/get/](1739939106470913.html) 中新增了请求参数 `payment_portfolio_id` 以及返回参数 `payment_portfolio_id` 和 `payment_portfolio_name`,使您可以按财务资产组合 ID 筛选广告账户余额,实现更高效的财务监管。 |
| 2025年8月1日 | 产品优化 | 商务中心 | 我们在 [/advertiser/balance/get/](1739939106470913.html) 中新增了返回参数 `max_transferable_amount` 和 `balance_info`。此功能使您能够识别从广告账户向商务中心可转移的最大现金和赠款金额,同时获取关键的余额信息,帮助您优化财务策略和决策。 |
| 2025年8月1日 | 产品优化 | 账号 | 我们已为照片发布功能新增草稿功能,在[/business/photo/publish/](1803630424390658.html)中新增请求参数 `is_draft` 支持上传草稿。此更新使您能够分阶段发布内容并跟踪其状态,从而使照片发布更加灵活。 |
2025年7月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2025年7月18日 | 产品优化 | 推广系列管理 | 我们在 [/rf/inventory/estimate/](1738235487941633.html) 中新增了返回参数 `max_reach`。该功能帮助您获取覆盖和频次广告可预订的全部覆盖人数,便于您优化库存预估结果,根据推广系列目标优化资源分配。 |
| 2025年7月18日 | 产品优化 | 推广系列管理 | 我们在 [/gmv_max/campaign/get/](1826463372290177.html) 中新增了返回参数 `roi_protection_compensation_status`,让您能够清晰掌握 GMV Max 推广系列的 ROI 保障状态,从而做出更明智的优化决策。 |
| 2025年7月4日 | 产品优化 | 商品库管理 | 我们已支持新的商品库类型:短剧商品库,您可通过[/catalog/create/](https://ads.tiktok.com/marketing_api/docs?id=1740306481704961)和[/catalog/get/](https://ads.tiktok.com/marketing_api/docs?id=1740315452868610)中 `catalog_type` 字段的枚举 `MINI_SERIES`创建短剧商品库,以及获取短剧商品库的详情。 |
| 2025年7月4日 | 产品优化 | 商品库管理 |我们已支持通过 JSON 结构向短剧商品库上传短剧,请查看"[通过 JSON 结构上传商品-v1.2与v1.3版本对比](https://ads.tiktok.com/marketing_api/docs?id=1740497429681153#item-link-v1.2与v1.3版本对比)"小节了解对应的新增请求参数。此外,[/catalog/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1740564136678402) 同时新增了对应的返回参数,可用于获取已上传至短剧商品库的短剧的详情。欲了解通过 JSON 结构向短剧商品库上传短剧的详细步骤,请查看[通过 JSON 结构向不同类型的商品库上传商品](https://ads.tiktok.com/marketing_api/docs?id=1740496787164161)。 |
| 2025年7月4日 | 产品优化 | 商品库管理| 我们已支持使用[/catalog/product/file/](https://ads.tiktok.com/marketing_api/docs?id=1740496787164161)中提供的短剧商品库的 CSV 更新源模版文件,向短剧商品库上传短剧。|
| 2025年7月4日 | 产品优化 | 商品库管理| 我们已支持通过 [/catalog/product/update/](1740562287852546.html) 和 [/catalog/product/delete/](1740562489236481.html)更新和删除短剧商品库中的短剧。这使您在管理短剧时有更多控制和灵活性。|
2025年6月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2025年6月27日 | 产品优化 | 推广系列管理 | 我们已经在 GMV Max 推广系列接口([/campaign/gmv_max/create/](1822000988713089.html), [/campaign/gmv_max/update/](1822001009002497.html), 和 [/campaign/gmv_max/info/](1822000968821762.html))中新增返回参数 `roi_protection_enabled`。此功能使您清晰了解推广系列是否符合 ROI(投资回报率)保障资格。 |
| 2025年6月20日 | 产品优化 | 推广系列管理 | 我们已经在推广系列接口([/campaign/create/](1739318962329602.html), [/campaign/update/](1739320422086657.html), [/campaign/get/](1739315828649986.html), 以及 [/campaign/copy/task/create/](1788434394151938.html))和 Smart+ 接口([/campaign/spc/create/](1767334204047362.html), [/campaign/spc/update/](1767334250066945.html), 以及 [/campaign/spc/get/](1767334299811842.html))中新增了`virtual_objective_type`和`sales_destination`参数,支持创建和管理普通和 Smart+ “销量”推广系列。了解[销量目标](1834189283112962.html)和[如何将推广目标从网站转化量或商品销量升级为销量](1834189985160193.html)。 |
| 2025年6月20日 | 产品优化 | 推广系列管理 | 我们已上线 GMV Max 最大投放量接口,包括 [/campaign/gmv_max/session/create/](1835246967275522.html), [/campaign/gmv_max/session/update/](1835247009119233.html), [/campaign/gmv_max/session/list/](1835246996436162.html), [/campaign/gmv_max/session/get/](1835247031331842.html), 以及 [/campaign/gmv_max/session/delete/](1835246983475217.html)。此更新使您能够创建、更新、检索和删除商品 GMV Max 推广系列商品的最大投放量时段,从而增强您在特定时间内战略性分配预算和最大化总收入的能力。 |
| 2025年6月13日 | 产品优化 | 账号 | 我们已经在[/business/video/publish/](1762228496095234.html)接口中新增请求参数 `custom_thumbnail_url`,使您能够为视频定制封面图片。此功能可助力您创建引人注目的视觉元素,吸引目标受众。 |
| 2025年6月13日 | 产品优化| 创意管理 | 我们已上线接口[/creative/portfolio/delete/](1834560049625089.html),支持一次批量删除最多 100 个创新互动样式。该功能可加快创新互动样式清理速度,助您高效管理创新互动样式。 |
2025年5月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2025年5月30日 | 产品优化 | 推广系列管理 | [/campaign/gmv_max/create/](1822000988713089.html) 中 `shopping_ads_type` 为 `PRODUCT` 且 `product_video_specific_type` 为 `AUTO_SELECTION` 时, `identity_list` 参数现变为可选。此更新支持创建商品 GMV Max 推广系列时不指定 TikTok 账号,可简化推广系列的设置,提升灵活性。 |
| 2025年5月30日 |产品优化 | 通用 | 我们在 [/tt_video/info/](1738376324021250.html) 中新增了返回参数 `status`、`spu_id`、`spu_name` 和 `store_id`,同时在 [/tt_video/list/](1738376465972226.html) 中新增了返回参数 `spu_id`、`spu_name` 和 `store_id`。这些新增参数有助于识别含商品链接的帖子,以便用作[商品 GMV Max 推广系列](1822009220448257.html)中的授权帖子。 |
| 2025年5月30日 | 产品优化 | 推广系列管理 | 我们在广告组接口([/adgroup/create/](1739499616346114.html),[/adgroup/update/](1739586761631745.html)和[/adgroup/get/](1739314558673922.html))的参数 `messaging_app_type` 中新增了枚举值 `ZALO` 和 `LINE`。此更新允许您在即时通讯广告中选择 Zalo 或 Line 作为消息应用,扩展您的消息选项。若想了解如何创建此类广告,请参考[创建优化位置为即时通讯应用的线索广告](1774482999036930.html)。 |
| 2025年5月16日 | 产品优化 | 商务中心 | 我们已在 [/bc/transfer/](1739939095321601.html) 接口中新增了返回参数 `transaction_infos`,支持在转账过程中获取详细交易信息,提升转账监控的效果。 |
| 2025年5月16日 | 产品优化 | 商务中心 |我们已在 [/advertiser/balance/get/](1739939106470913.html) 接口中新增了请求参数`fields`以及返回参数 `budget_remaining`、`budget_frequency_restriction`、`budget_amount_restriction`和`min_transferable_amount`,方便您查询广告账户的剩余预算以及预算及转账限制。 |
| 2025年5月16日 | 产品优化 | 商务中心 | 我们已在[/advertiser/update/](1739939050770434.html) 接口中新增了返回参数`one_click_set_amount`,并为请求参数 `budget_update_type` 新增枚举值`INCREMENTAL_UPDATE`和`ONE_CLICK_SET`。该更新允许您对广告账户预算进行增量修改或一键设置为最低预算,提升预算管理的灵活性。 |
| 2025年5月16日 | 产品优化 | 线索管理 | 我们已上线两个新接口[/lead/field/get/](1832112377641026.html)和[/lead/get/](1832112833212434.html),以简化线索数据的获取。这些接口能够高效访问即时表单和私信线索及线索字段,提升您的线索管理能力。|
| 2025年5月16日 | 产品优化 | 线索管理 | 我们已在[/subscription/subscribe/](1739092028876801.html)和[/subscription/get/](1739093832125442.html)接口中新增了请求参数`lead_source`,以支持私信线索的 Webhook 订阅。此外,您现在可以通过在[/page/lead/mock/create/](1739047132614722.html)、[/page/lead/mock/get/](1739048460493826.html)和[/page/lead/mock/delete/](1739049313198081.html)中使用新的参数`lead_source`来创建、获取和删除测试私信线索。有关 Webhook 订阅的详细步骤,请参见[通过订阅 API 订阅广告账户的 Webhook 事件](1810521739537409.html)。 |
| 2025年5月9日 | 产品优化 | 报表管理 | 我们在基础报表中新增类别[消息指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-消息指标) ,并在四个现有类别网站、TikTok、线下和店铺指标中新增了指标。要了解新增的网站、TikTok、线下和店铺指标,请参阅[基础报表 > 支持的指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-v1.2与v1.3版本对比)中的“<b>v1.2与v1.3版本对比</b>”小节。这些新增指标可以帮助您更好地监控多个渠道的表现,从而有效优化您的策略。 |
| 2025年5月9日 | 产品优化 | 推广系列管理 | 我们已上线新接口[/campaign/spc/quota/get/](1831564498409473.html),使您能够查询广告账户中 Smart+ 推广系列的动态配额。此功能增加了配额的透明度,方便您管理配额,从而更好地规划您的推广系列。|
| 2025年5月9日 | 产品优化 | 推广系列管理 | 我们已在[/ad/get/](1735735588640770.html) 中为 Spark Ads 推送类型的广告返回参数`tiktok_item_id`。这一改进可以帮助您识别原生视频和对应生成的广告之间的联系,增强您对 Spark Ads 的监控和优化能力。 |
| 2025年5月9日 | 文档优化 | 报表管理 | 我们已调整[基础报表 > 支持的指标](1751443967255553.html)章节的结构,将指标重新划分为三个主要类别:核心指标、互动指标和转化指标。此调整可提高指标的清晰度和相关性,方便您更直观的分析报表数据,基于指标数据作出决策。 |
2025年4月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2025年4月25日 | 产品优化 | 推广系列管理 | 我们已上线品牌安全接口[/tiktok_inventory_filters/get/](1830112550443073.html) 和 [/tiktok_inventory_filters/update/](1830112569774274.html),可用于配置[品牌安全中心](https://business-api.tiktok.com/portal/docs?id=1739381752981505#item-link-品牌安全中心)设置,这些设置将应用于新建的 Smart+ 推广系列,确保安全且与品牌一致的广告体验。此外,您可以通过([/campaign/spc/create/](1767334204047362.html), [/campaign/spc/update/](1767334250066945.html)和[/campaign/spc/get/](1767334299811842.html))中的新返回参数 `brand_safety_type` 和 `category_exclusion_ids` 来检索 Smart+ 推广系列中自动应用的品牌安全设置。 |
| 2025年4月25日 | 产品优化 | 推广系列管理 |我们已支持通过[/gmv_max/video/get/](1822001168512129.html)中新增的请求参数 `custom_posts_eligible` 和返回参数 `can_change_anchor` 筛选可用于自定义作品的视频。此外,您可以通过 GMV Max 推广系列接口([/campaign/gmv_max/create/](1822000988713089.html)、 [/campaign/gmv_max/update/](1822001009002497.html) 和 [/campaign/gmv_max/info/](1822000968821762.html))中的新增参数 `custom_anchor_video_list` 和 `campaign_custom_anchor_video_id` 在商品 GMV Max 推广系列中使用自定义作品,并使用新接口[/gmv_max/custom_anchor_video_list/get/]( https://business-api.tiktok.com/portal/docs?id=1830215925061633)检索自定义作品中视频的详细信息。 |
| 2025年4月25日 | 产品优化 | 推广系列管理 |我们已支持通过[/gmv_max/video/get/](1822001168512129.html)中新增的请求参数 `sort_field`,`sort_type` 和 `keyword` 对已授权的作品中的视频和可用于自定义作品的视频进行排序和搜索,增强了视频管理和检索能力。 |
| 2025年4月25日 | 产品优化 | 创意管理 | 我们已扩展支持了创新互动样式互动手势,可通过在创意素材包接口 ([/creative/portfolio/create/](https://ads.tiktok.com/marketing_api/docs?id=1739091950439426), [/creative/portfolio/get/](https://ads.tiktok.com/marketing_api/docs?id=1739092113671170), 和 [/creative/portfolio/list/](1766324010279938.html)) 中使用参数 `creative_portfolio_type` 的 `GESTURE` 枚举值以及新参数 `gesture_type`、`slide_length`、`slide_dimension` 和 `interactive_music_id` 进行配置。若想了解如何在广告中使用互动手势,可查看[高级创新互动样式](1749019676181505.html)。 |
| 2025年4月25日 | 产品优化 | 创意管理 | 我们已简化了智能修复功能,将自动修复范围限制为视频分辨率和大小问题,并仅提供一个修复后的视频。[/file/video/ad/upload/](1737587322856449.html) 中返回参数 `flaw_types` 的枚举值 `NO_BGM`,`BLACK_EDGE` 和 `ILLEGAL_DURATION` 已对应废弃,以确保更有针对性、更有效的修复体验。|
| 2025年4月18日 | 产品优化 | 推广系列管理 | 我们已扩展深度漏斗优化功能,为广告组接口([/adgroup/create/](1739499616346114.html),[/adgroup/update/](1739586761631745.html)和[/adgroup/get/](1739314558673922.html))中的 `deep_funnel_event_source` 参数新增枚举值 `CRM` 以支持 CRM 事件组。这使您可以将 CRM 数据用作深度漏斗优化中的深度事件回传信号。|
| 2025年4月18日 | 产品优化 | 推广系列管理 |我们已为[ Smart+ 线索收集推广系列](1827645480080385.html)扩展深度漏斗优化功能。此更新在 Smart+ 接口([/campaign/spc/create/](1767334204047362.html), [/campaign/spc/update/](1767334250066945.html)和[/campaign/spc/get/](1767334299811842.html))中新增了四个参数`deep_funnel_optimization_status`、`deep_funnel_event_source`、`deep_funnel_event_source_id` 和 `deep_funnel_optimization_event`,使您能够同时优化浅层和深层漏斗事件。|
| 2025年4月18日 | 产品优化 | 商品库 | 我们已全量发布了商品库视频接口([/catalog/video/file/](1803655037415489.html), [/catalog/video/log/](1803655061642242.html), [/catalog/video/get/](1803655082498050.html)和[/catalog/video/delete/](1803655103069185.html)),可用于管理电商商品库中上传的视频。若想了解如何管理上传的商品库视频并应用于广告中,请查看[上传商品库视频并与商品绑定](1803654904260674.html)。|
| 2025年4月11日 | 产品优化 | 商务中心 | 我们已上线 [/bc/account/cost/get/](1829079287639041.html) 接口,支持获取消耗记录,让您能够访问广告账户和商务中心层级的消耗数据。此功能可简化预算管理和支付计划流程。 |
| 2025年4月11日 | 产品优化 | 创意管理| 我们已扩展支持了创新互动样式点赞彩蛋,可通过在创意素材包接口 ([/creative/portfolio/create/](https://ads.tiktok.com/marketing_api/docs?id=1739091950439426), [/creative/portfolio/get/](https://ads.tiktok.com/marketing_api/docs?id=1739092113671170), 和 [/creative/portfolio/list/](1766324010279938.html)) 中使用参数 `creative_portfolio_type` 的 `SUPER_LIKE` 枚举值以及新参数 `pop_up_window_image_id` 进行配置。若想了解如何在广告中使用点赞彩蛋,可查看 [高级创新互动样式](1749019676181505.html)。 |
| 2025年4月11日 | 产品优化 | 推广系列管理 | 我们已在推广系列接口 ([/campaign/create/](1739318962329602.html), [/campaign/update/](1739320422086657.html), 和 [/campaign/get/](1739315828649986.html)) 中新增了 `rta_bid_enabled` 参数,支持实时 API的出价功能,并将实时 API 的支持推广目标扩展到网络转化量和商品来源为且推广网站的视频购物广告。若想了解如何使用实时 API,请参阅[实时 API](1805437148769281.html)。 |
| 2025年4月4日 | 产品优化 | 商务中心| 我们已增强成员信息的透明度,支持通过[/bc/member/get/](1739939404802049.html)接口中的返回参数 `user_email` 获取所有成员的完整邮箱地址。此白名单功能便于进行成员身份验证,增强团队协作效率。 |
| 2025年4月4日 | 产品优化 | 账号 |我们通过 [/business/video/publish/](1762228496095234.html) 接口的请求参数 `is_ads_only` 支持了发布仅限广告的视频功能,并通过 [/business/video/list/](1762228421622786.html) 接口的请求参数 `ad_post_only` 支持了筛选 Spark Ads 视频的表现数据。这些功能使您能够控制广告内容可见性,监控广告视频的表现,从而最大化广告策略的效果。 |
2025年3月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|--- |
| 2025年3月28日 | 产品优化 | 推广系列管理 | 我们已支持了商品购物广告、视频购物广告和直播购物广告的广告预览功能。[/creative/ads_preview/create/](1739403070695426.html)接口中新增请求参数`product_source`、`store_id`、`store_authorized_bc_id`和`showcase_products`,以及参数 `preview_format`的枚举值 `PRODUCT_SEARCH` 和 `PRODUCT_SHOP_CENTER`。此更新使您能够全面测试所有购物广告的预览。 |
| 2025年3月28日 | 产品优化 | 推广系列管理 | 我们已支持 Smart+ 线索收集推广系列。[/campaign/spc/create/](1767334204047362.html) 中新增参数 `promotion_target_type` 和 `spc_audience_age`,以及参数`objective_type`、`promotion_type` 和 `optimization_goal` 的枚举值 `LEAD_GENERATION`。您还可通过 [/campaign/spc/update/](1767334250066945.html) 和 [/campaign/spc/get/](1767334299811842.html) 中的返回参数 `promotion_target_type` 检索 Smart+ 线索收集推广系列的优化位置。这些更新使您能够高效创建广告组并自动优化广告。若想了解如何创建此类推广系列,请参阅[创建 Smart+线索收集推广系列](1827645480080385.html)。 |
| 2025年3月21日 | 产品优化 | 推广系列管理 |我们上线了新接口[/gmv_max/campaign/get/](1826463372290177.html),专门用于高效检索 GMV Max 推广系列。此功能使您能够快速访问推广系列详情,简化推广系列管理流程。 |
| 2025年3月21日 | 产品优化 | 推广系列管理 |我们在 GMV Max 推广系列接口([/campaign/gmv_max/create/](1822000988713089.html)、 [/campaign/gmv_max/update/](1822001009002497.html) 和 [/campaign/gmv_max/info/](1822000968821762.html))中新增了参数 `affiliate_posts_enabled`,使您能够管理商品 GMV Max 推广系列中联盟作品的使用。 |
| 2025年3月14日 | 产品优化 | 通用 |我们已上线简化测试环境 [API Playground](https://business-api.tiktok.com/portal/api-playground),可用于测试 Marketing API 接口。该工具配备直观的用户界面,让您能够实时测试 API 调用。若想了解该工具的使用方法,请参阅[使用 API Playground](https://business-api.tiktok.com/portal/docs?id=1826537506816001#%E4%BD%BF%E7%94%A8%20API%20Playground)。 |
| 2025年3月7日 | 产品优化 | 推广系列管理 |我们为 GMV Max 推广系列新增了 10 种[二级状态](https://business-api.tiktok.com/portal/docs?id=1757239620352002#item-link-GMV%20Max%20%E6%8E%A8%E5%B9%BF%E7%B3%BB%E5%88%97),使您更清晰地了解推广系列的状态并识别资产可用性和商店状态等问题。新增状态包括`CAMPAIGN_STATUS_TTS_TT_ASSET_UNAVAILABLE`、`CAMPAIGN_STATUS_TTS_TT_IDENTITY_UNAVAILABLE`、`CAMPAIGN_STATUS_TIKTOK_SHOP_UNAVAILABLE`、`CAMPAIGN_STATUS_REVIEW_DISAPPROVED`、`CAMPAIGN_STATUS_AD_UNAVAILABLE`、`CAMPAIGN_STATUS_PRODUCT_UNAVAILABLE`、 `CAMPAIGN_STATUS_LIVE_GMV_MAX_AUTHORIZATION_CANCEL`、`CAMPAIGN_STATUS_PRODUCT_GMV_MAX_AUTHORIZATION_CANCEL`、`CAMPAIGN_STATUS_IDENTITY_USED_BY_LIVE_GMV_MAX` 以及 `CAMPAIGN_STATUS_PRODUCT_USED_BY_PRODUCT_GMV_MAX`。|
| 2025年3月7日 | 产品优化 | 创意管理 |我们优化了 [/creative/ads_preview/create/](1739403070695426.html) 接口,支持预览线索轮播广告,使您在发布广告之前能够查看和完善广告内容。 |
| 2025年3月7日 | 产品优化 | 其他 |我们支持了广告账户暂时停用状态的 Webhook ,可通过订阅接口([/subscription/subscribe/](1739092028876801.html) 和[/subscription/get/](1739093832125442.html))中的新增参数 `bc_id` 和 `advertiser_ids` 以及参数 `subscribe_entity` 的新增枚举值 `AD_ACCOUNT_SUSPENSION` 进行订阅。若想了解详细步骤,可查看[订阅广告账户的暂时停用状态](https://business-api.tiktok.com/portal/docs?id=1810521739537409#item-link-订阅广告账户的暂时停用状态)。 |
2025年2月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|----|
| 2025年2月28日 | 产品优化 | 报表管理|我们上线了 [/gmv_max/report/get/](1824721673497601.html) 接口,助力您分析 GMV Max 推广系列数据。若想了解不同层级可选的指标详情,请参阅[ GMV Max 推广系列报表指标](1824722485971009.html)。 |
|2025年2月28日 | 产品优化 | 报表管理 | 我们在基础报表中新增了[筛选条件 `creative_campaign_type`](1751443975608321.html) ,便于您对 Smart+ 推广系列进行精细化分析。 |
| 2025年2月28日 | 产品优化 | 报表管理| 我们在基础报表中新增了[ 12 个应用内事件指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-应用内事件数据指标),可监测安装后最长 168 小时内的 ROAS 和付费价值或广告收入:<ul><li>`total_purchase_roas_day0`、`total_purchase_roas_day2`、`total_purchase_roas_day6`、`total_purchase_value_day0`、`total_purchase_value_day2`、`total_purchase_value_day6`。</li><li>`ad_impression_ad_revenue_roas_day0`、`ad_impression_ad_revenue_roas_day2`、`ad_impression_ad_revenue_roas_day6`、`ad_impression_ad_revenue_day0`、`ad_impression_ad_revenue_day2`、`ad_impression_ad_revenue_day6`。</li></ul> 这些指标有助于您深入了解推广系列的收入表现。|
| 2025年2月28日 | 产品优化 | 报表管理| 我们为高级专属推广系列支持了[自归因平台指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-%E8%87%AA%E5%BD%92%E5%9B%A0%E5%B9%B3%E5%8F%B0%E6%8C%87%E6%A0%87),提供更清晰的应用内转化事件数据。 |
| 2025年2月21日 | 产品优化| 账号 |我们在[/business/get/](1762228399168514.html)接口中将 `audience_cities` 对象数组中的 `city` 参数更名为 `city_name` 。此次更新在确保 API 一致性的基础上,使参数命名更加直观。|
| 2025年2月14日 | 产品优化 | 报表管理 |我们在多个报表类型中新增了指标。<br>[基础报表](1751443967255553.html)新增视频播放数据指标( `paid_engaged_view` 、`paid_engagement_engaged_view`、`paid_engaged_view_15s`和`paid_engagement_engaged_view_15s`)和去重第 7 天留存指标(`day7_retention`、`cost_per_day7_retention`、`day7_retention_rate`、`total_day7_retention`、`cost_per_total_day7_retention`、`value_per_total_day7_retention`和 `total_day7_retention_value`)。<br>[受众分析报表](1751454162042882.html)新增基础数据指标(`reach`、`cost_per_1000_reached`和`frequency`),同时在[针对商品来源为商品库的视频购物广告的 DSA 报表](https://business-api.tiktok.com/portal/docs?id=1751625293044737#item-link-%E5%AF%B9%E4%BA%8E%E5%95%86%E5%93%81%E6%9D%A5%E6%BA%90%E4%B8%BA%E5%95%86%E5%93%81%E5%BA%93%E7%9A%84%E8%A7%86%E9%A2%91%E8%B4%AD%E7%89%A9%E5%B9%BF%E5%91%8A)中新增商品指标(`product_impressions`、`product_clicks` 和 `product_cta`)。 |
| 2025年2月14日 | 产品优化 | 创意管理 |我们在视频洞察报表中新增了基础数据指标(`real_time_conversion`、`real_time_cost_per_conversion`、`real_time_conversion_rate_v2`、`result`、`cost_per_result`、`result_rate`、`real_time_result`、`real_time_cost_per_result`、`real_time_result_rate`、`secondary_goal_result`、`secondary_goal_result_rate`、`cost_per_secondary_goal_result`、`skan_result`、`skan_cost_per_result`、`skan_result_rate`、`skan_conversion`、`skan_cost_per_conversion`和`skan_conversion_rate_v2`)、视频播放指标(`video_play_actions`、`video_watched_2s`、`video_watched_6s`、`video_views_p100`、`video_views_p75`、`video_views_p50`、`video_views_p25`和`average_video_play`)以及互动数据指标(`follows`、`likes`、`comments`、`shares`、`profile_visits`、`profile_visits_rate`、`earned_page_video_views`、`earned_page_video_views_p100`和 `earned_page_clicks`) 。这些新增指标使您能够更全面地分析视频表现。 |
| 2025年2月14日 | 产品优化 | 账号 |我们在[/business/get/](1762228399168514.html)接口中新增了`daily_new_followers`指标,帮助您清晰掌握 TikTok 账户每日粉丝增长情况。 |
| 2025年2月7日 | 产品优化 | 推广系列管理 |我们已扩展 Smart+ 推广系列的功能,支持了添加到商务中心的 TikTok 用户这类型的认证身份。此更新在 Smart+ 相关接口([/campaign/spc/create/](1767334204047362.html)、[/campaign/spc/update/](1767334250066945.html)和[/campaign/spc/get/](1767334299811842.html))中引入了新参数`identity_authorized_bc_id`和`identity_type`参数的新枚举值`BC_AUTH_TT`。 |
| 2025年2月7日 | 产品优化 | 推广系列管理 |我们已支持线索广告的深度漏斗优化功能。该功能在广告组接口([/adgroup/create/](1739499616346114.html) 、[/adgroup/update/](1739586761631745.html)和[/adgroup/get/](1739314558673922.html))中引入了四个新参数:`deep_funnel_optimization_status`、`deep_funnel_event_source`、`deep_funnel_event_source_id`和 `deep_funnel_optimization_event`,使您能够同时优化浅层和深层漏斗事件。 |
| 2025年2月7日 | 产品优化 | 账号 |我们已上线新接口[/business/benchmark/](1822388944791617.html) ,用于获取某个企业类别的基准数据。该功能可帮助 TikTok 账号持有者根据相关基准衡量 TikTok 账号表现,便于做出数据驱动的优化决策。 |
2025年1月
| 日期{20%} | 更新类型{15%} | API 类别{15%} | 更新内容{50%} |
|---|---|---|---|
| 2025年1月24日 | 产品优化 | 推广系列管理 | 我们已发布 [GMV Max API](1822000911166465.html),支持创建商品和直播 GMV Max 推广系列,帮助您实现销售额最大化。该功能简化了 GMV Max 推广系列的创建和管理流程。若想了解如何创建这类推广系列,请查看[创建 GMV Max 推广系列](1822009058467842.html)。 |
| 2025年1月24日 | 产品优化 | 推广系列管理 |我们已增强私信广告功能,发布了[欢迎消息 API](1822106064917506.html),支持在广告账户中系统地管理欢迎消息。若想了解如何创建包含欢迎消息模版的 TikTok 私信广告,请查看[创建优化位置为 TikTok 私信的线索广告](1774482992153601.html)。 |
| 2025年1月24日 | 产品优化 | 账号 |我们已扩展大量 TikTok 账号的数据分析指标。[/business/get/](1762228399168514.html)接口现已支持unique_video_views, `phone_number_clicks`, `lead_submissions`, `app_download_clicks`, `bio_link_clicks`, `email_clicks`, `address_clicks`, `daily_total_followers`, `daily_lost_followers`, `audience_ages`, `audience_cities` 和 `engaged_audience` 指标。 此外, [/business/video/list/](1762228421622786.html) 接口新增了 `favorites`, `profile_views`, `website_clicks`, `phone_number_clicks`, `lead_submissions`, `app_download_clicks`, `email_clicks`, `address_clicks`, `video_view_retention`, `audience_genders`, `audience_cities`, `audience_types`, `new_followers` 和 `engagement_likes` 指标。这些指标可助您深入了解受众行为和内容表现。 |
| 2025年1月24日 | 文档优化 | 推广系列管理 |我们已将“搜索广告开关”更名为“[自动搜索广告位](1771747626094593.html)”。 |
|2025年1月17日 | 产品优化 | 推广系列管理 | 我们已新增两个二级状态枚举值 `ADGROUP_STATUS_REVIEW_PARTIALLY_APPROVED` 和 `AD_STATUS_REVIEW_PARTIALLY_APPROVED`,让您能更清晰地了解广告组和广告的部分拒审状态。若想了解二级状态的详情,可查看[一级状态下支持的二级状态](1757239620352002.html)。 |
|2025年1月17日 | 产品优化 | 商务中心 | 我们已在 [/bc/advertiser/unionpay_info/submit/](1813772274039809.html)接口中新增了请求参数 `representative_document_type`,支持使用包括护照在内的多种证件类型进行银联认证。此项优化简化了认证流程,为中国出海广告主提供了更灵活的证件选择。 |
|2025年1月10日 | 产品优化 | 创意管理 | 我们已上线 TikTok 即时体验页面编辑器 SDK,为您提供更为流畅的页面创建工作流程,支持创建自定义页面、即时表单(线索表单)、应用介绍页和弹出式表单。若想了解 SDK 的具体使用方法,请查看[即时体验页面编辑器 SDK](1740307202170881.html)。 |
|2025年1月10日 | 产品优化 | 商务中心 | 我们已上线 [/changelog/get/](1820767460168705.html) 接口,支持查询商务中心的日志记录。该功能使您能够监控商务中心的变动,提升业务运营管理效率。 |
|2025年1月3日 | 产品优化 | 推广系列管理 | 我们已在 [/creative/cta/recommend/](1739362202742785.html) 接口新增了请求参数,包括 `new_version`、`objective_type`、`promotion_type`、`language`、`app_id`、`placements`、`region_codes`、`optimization_goal`、`ad_texts` 和 `landing_page_url`。这些参数可根据广告配置提供动态优选行动引导文案建议,实现更贴合场景的行动引导文案推荐。若想了解新参数的详细使用方法,请查看[动态优选行动引导文案](https://business-api.tiktok.com/portal/docs?id=1740307296329730#item-link-%E5%8A%A8%E6%80%81%E4%BC%98%E9%80%89%E8%A1%8C%E5%8A%A8%E5%BC%95%E5%AF%BC%E6%96%87%E6%A1%88)。 |
2024年
2024年12月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|---|
| 2024年12月27日 | 产品优化 | 推广系列管理 |我们已在 [/ad/get/](1735735588640770.html) 中新增了请求参数 `modified_after`,方便您检索最近更新的广告。 |
| 2024年12月27日 | 产品优化 | 推广系列管理 |我们已将 TikTok 私信广告全量开放给目前支持的亚太和拉丁美洲地域的广告主,同时将即时通讯广告全量开放给目前支持的亚太地域的广告主。若想了解这两种广告类型在各地域详细的支持情况,请查看[创建优化位置为 TikTok 私信的线索广告](1774482992153601.html)和[创建优化位置为即时通讯应用的线索广告](1774482999036930.html)。 |
| 2024年12月27日 | 产品优化 | 报表管理 |我们已调整了[报表的延迟](1738864894606337.html),以提供更全面的数据处理。小时级别的数据延迟已调整为 16 个小时。此外,我们为更多维度添加了详细的延迟说明,帮助您更好地规划您的数据分析工作流程。 |
| 2024年12月20日 | 产品优化 | 账号| 我们已在[/business/comment/list/](1760232109619202.html)和 [/business/comment/reply/list/](1762228430145538.html)接口中新增返回参数`display_name`,使您能够根据显示名称识别发表主评论和回复的用户。此更新可提高评论管理的效率。 |
| 2024年12月20日 | 产品优化 | 账号 |我们已为视频发布功能新增草稿功能,包括在[/business/video/publish/](1762228496095234.html)中新增请求参数 `upload_to_draft` 支持上传草稿,以及在[/business/publish/status/](1816387106635778.html)中新增`SEND_TO_USER_INBOX`状态,支持跟踪草稿状态。这些更新使您能够分阶段发布内容并跟踪其状态,从而使视频发布更加灵活。 |
| 2024年12月13日 | 产品优化 | 商务中心 |我们已在[/bc/asset/assign/](1739438211077121.html),[/bc/asset/get/](1739432717798401.html)和[/bc/asset/admin/get/](1739433007779841.html)中为 `tt_account_roles` 参数支持新枚举值`DIRECT_MESSAGE`,可用于管理 TikTok 账号的私信权限。此外,还在 [/identity/get/](1740218420781057.html) 和 [/identity/info/](1740218453385217.html) 中新增返回参数 `can_manage_message`,可用于查询 TikTok 账号类认证身份的私信权限。这些更新有助于大规模的消息权限管理。 |
| 2024年12月13日 | 产品优化 | 创意管理 | 我们已在[/creative/portfolio/list/](1766324010279938.html)中支持通过新增请求参数 `creative_portfolio_ids` 基于 ID 筛选创意素材包,还支持获取素材包详情,例如`image_id`和`title`。这些更新可简化创意资产管理。 |
| 2024年12月6日 | 产品优化| 推广系列管理|我们已支持通过广告组接口([/adgroup/create/](1739499616346114.html),[/adgroup/update/](1739586761631745.html) 和[/adgroup/get/](1739314558673922.html)))的新参数 `messaging_app_type` 、 `messaging_app_account_id`,`phone_region_code`,`phone_region_calling_code`,`phone_number` 和 `message_event_set_id` [创建使用即时通讯应用的 TikTok 即时通讯广告](1774482999036930.html)。此更新有助于增强用户参与度,促进更多即时消息对话。 |
| 2024年12月6日 | 产品优化| 账号|我们已支持为 TikTok 账户授权 URL 配置[多个重定向 URL](1738083939371009.html),使您能够在多种环境中进行测试和开发。 |
2024年11月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|---|
| 2024年11月29日 | 产品优化| 报表管理 |我们已在[基础报表](1751443956638721.html)中新增维度`post_id`,可用于度量和对比单个帖子的表现指标,为内容策略优化创造机会。 |
| 2024年11月22日 | 产品优化| 账号 |我们已发布 [/business/publish/status/](1816387106635778.html) 接口,可用于追踪 TikTok 视频和图片帖子的发布状态。 |
| 2024年11月22日 | 产品优化| 账号 |我们已发布 [/business/video/settings/](1816387951979521.html) 接口,可用于获取 TikTok 账号隐私设置,优化帖子管理流程。 |
| 2024年11月22日 | 产品优化| 账号| 我们已在 [/business/video/publish/](1762228496095234.html) 接口中新增请求参数 `is_ai_generated` 参数,可用于披露 TikTok 视频帖子中含有 AI 生成内容。 |
| 2024年11月22日 | 产品优化 | 创意管理 | 我们已在 [/file/name/check/](1759130033155073.html) 接口新增请求参数`files`和 返回参数`batch_results`,实现文件名批量查重。 |
| 2024年11月15日 | 产品优化| 商品库管理 |我们已优化了商品 API,支持了更多旅游类商品的属性字段,您可通过 [/catalog/product/upload/](1740497429681153.html)、[/catalog/product/file/](1740496787164161.html)和[/catalog/product/get/](1740564136678402.html)指定或检索酒店的`neighborhood`、`priority`、`hotel_category` 和 `amenities`,航班的 `priority`,和目的地的 `neighborhood`。此外,还支持通过 [/catalog/product/update/](1740562287852546.html) 和 [/catalog/product/delete/](1740562489236481.html)更新和删除旅游类商品。 |
| 2024年11月15日 | 产品优化| 商品库管理 |我们已支持使用[/catalog/set/create/](1740572891104257.html)、[/catalog/set/update/](1740572974725122.html)、[/catalog/set/delete/](1740573143966722.html)和[/catalog/set/get/](1740570556295169.html)全面管理酒店、航班和目的地商品系列。此外,[/catalog/set/product/get/](1740571478441986.html) 返回参数中新增 `hotel_id`、`flight_id` 和 `destination_id`,方便您识别商品系列中的旅游类商品。若想了解各类商品系列支持的筛选字段,可查看[筛选字段](https://business-api.tiktok.com/portal/docs?id=1740673108747265#item-link-%E7%AD%9B%E9%80%89%E5%AD%97%E6%AE%B5)。 |
| 2024年11月15日 | 产品优化| 商务中心 |我们已支持通过[/bc/asset/get/](1739432717798401.html)和[/bc/asset/admin/get/](1739433007779841.html)中的返回参数 `asset_name`,获取广告账户、商品库、TikTok Shop、Pixel、线索和 TikTok 账号的资产名称。此更新可帮助您识别商务中心内的不同资产。 |
| 2024年11月15日 | 产品优化| 商品库管理 |我们已在[/catalog/set/get/](1740570556295169.html)中新增请求参数`return_product_count`以优化接口性能。通过控制是否在返回中返回`product_count`字段,您可以避免超时错误,确保此接口的调用更稳定可靠。 |
| 2024年11月15日 | 产品优化| 商务中心 |我们已在多个接口中支持了支付组合的管理功能。[/bc/account/transaction/get/](1792849810925569.html)中请求参数`transaction_level`新增的枚举值 `PAYMENT_PORTFOLIO`可用于获取支付组合的交易记录,同时新增的返回参数`payment_portfolio_id`和`payment_portfolio_name`可用于识别交易记录关联的支付组合。此外,您可以通过 [/bc/balance/get/](1739939128198145.html) 或 [/advertiser/balance/get/](1739939106470913.html) 获取支付组合的余额,并通过[/advertiser/update/](1739939050770434.html)中的请求参数`advertiser_budgets`管理支付组合的预算。 |
| 2024年11月8日 | 产品优化 | 账号 | 我们已上线用于管理 TikTok 帖子授权码的新接口([/business/post/authorize/setting/](1815051741912066.html)、[/business/post/authorize/](1815051784582210.html)、[/business/post/authorize/status/](1815051801257986.html)和[/business/post/authorize/delete/](1815051817073665.html))。若想了解相关步骤,可查看[管理 TikTok 帖子的广告授权](1815124785075201.html)。 |
| 2024年11月8日 | 产品优化 | SDK |我们扩展了 API for Business SDK 的功能,包括支持`/adgroup/quota/`和更多受众 API 和工具 API 接口,以提供更好的开发体验 。若想了解 SDK 支持的所有接口列表,可查看 [SDK](https://business-api.tiktok.com/portal/docs?id=1764231376750658#item-link-%E6%94%AF%E6%8C%81%E5%93%AA%E4%BA%9BAPI%E6%8E%A5%E5%8F%A3%EF%BC%9F)。 |
| 2024年11月8日 | 产品优化| 推广系列管理 | 我们已优化了[/adgroup/get/](1739314558673922.html)接口,支持获取 TopView 广告组根据夏令时变化自动调整的排期时间。若想了解 TopView 样式详情,可查看 [TopView](1804258360285186.html)。 |
| 2024年11月1日 | 产品优化| 推广系列管理 | 我们已支持使用 [Smart+ API](1765314260115458.html) 创建、更新和检索普通 Smart+ 商品库广告。若想了解创建 Smart+ 商品库广告的具体步骤,可查看[创建 Smart+ 商品库广告](https://business-api.tiktok.com/portal/docs?id=1814122471133186#item-link-%E5%88%9B%E5%BB%BA%20Smart+%20%E5%95%86%E5%93%81%E5%BA%93%E5%B9%BF%E5%91%8A)。 |
| 2024年11月1日 | 产品优化|报表管理 | 我们已通过 [/campaign/spc/report/get/](1776454619412481.html)中请求参数 `material_type` 的新增枚举值 `SPC_CATALOG_VIDEO` 和`SPC_CATALOG_CAROUSEL`支持了 Smart+ 商品库广告的报表功能。您可获取素材层级的报表数据及商品库详情,包括`catalog_id`,`catalog_name`,`catalog_create_time`和 `catalog_modify_time`。 |
| 2024年11月1日 | 产品优化| 推广系列管理 |我们已支持通过[/campaign/spc/get/](1767334299811842.html)检索 Smart+ 线索收集推广系列。返回中新增参数`spc_audience_age`,即推广系列定向的年龄区间。|
| 2024年11月1日 | 产品优化| 推广系列管理 | 我们已扩展了地域定向功能,支持巴西、印度尼西亚、泰国和越南的邮政编码定向。您可通过[/adgroup/create/](1739499616346114.html)和[/campaign/copy/task/create/](1788434394151938.html)中的 `zipcode_ids` 参数定向这些邮政编码区域。若想搜索可用的邮政编码 ID,可使用[/tool/targeting/search/](1761236883355649.html)。 |
| 2024年11月1日 | 产品优化| 推广系列管理 |我们已支持通过广告组接口([/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114),[/adgroup/update/](1739586761631745.html)和[/adgroup/get/](1739314558673922.html))以及[/campaign/copy/task/create/](1788434394151938.html)中的 `tiktok_subplacements` 字段在推广目标为覆盖人数、视频播放量或社区互动的广告组中使用 TikTok 子版位搜索推荐内容和 TikTok Lite。 此外,您还可通过[/creative/ads_preview/create/](1739403070695426.html)的请求参数 `preview_format` 的枚举值 `SEARCH_FEED` 和 `TIKTOK_LITE` 预览这些子版位。 |
| 2024年11月1日 | 产品优化 | 商务中心| 我们已上线新接口[/bc/advertiser/unionpay_info/check/](1813772238056449.html)和[/bc/advertiser/unionpay_info/submit/](1813772274039809.html),需要为绑定的营业执照进行银联验的中国出海广告主可使用这些接口进行银联验证。若想了解通过 API 创建广告账户的工作流程,可查看[创建广告账户](https://business-api.tiktok.com/portal/docs?id=1754705407307777#item-link-%E5%88%9B%E5%BB%BA%E5%B9%BF%E5%91%8A%E8%B4%A6%E6%88%B7)。 |
| 2024年11月1日 | 产品优化| 账号 |我们已在 [/business/get/](1762228399168514.html)中新增了指标`bio_description` 、`profile_deep_link` 、`is_verified` 、`following_count` 、`total_likes` 和 `videos_count`,这些新增指标可帮助您更深入地了解您的 TikTok 账号及其表现。 |
2024年10月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|---|
| 2024年10月25日 | 产品优化| 推广系列管理 | 我们已支持使用 [Smart+ API](1765314260115458.html) 创建、更新和检索 Smart+ 网站推广系列。若想了解创建 Smart+ 网站推广系列和 Smart+ 应用推广系列的具体步骤,可查看[创建 Smart+ 推广系列](1768006268820546.html)。 |
| 2024年10月25日 | 产品优化| 推广系列管理 | 我们已支持在使用推广目标`REACH`、`VIDEO_VIEWS`或`ENGAGEMENT`时通过[/adgroup/create/](1739499616346114.html)中的 `location_ids` 定向 16 个新开放的国家或地区。这些国家或地区包括:阿塞拜疆、保加利亚、 玻利维亚、塞浦路斯、阿尔及利亚、爱沙尼亚、克罗地亚、肯尼亚、斯里兰卡、立陶宛、拉脱维亚 、波多黎各、巴拉圭、塞尔维亚、斯洛文尼亚、斯洛伐克。若想查看您可以定向的国家或地区,可调用[/tool/targeting/search/](1761236883355649.html)或[/tool/region/](1737189539571713.html)。 |
|2024年10月18日 | 产品优化| 报表管理 |我们在[基础报表](1751443967255553.html)、[受众分析报表](1751454162042882.html)和[创意基础报表](1861363088053250.html)中新增了归因指标 `vta_complete_payment`、`cost_per_vta_payments_completed`、`vta_complete_payment_value` 和 `vta_complete_payment_roas`。此更新使您能够获取支付完成事件的洞察,从而监测转化效果。 |
| 2024年10月18日 | 产品优化| 受众管理| 我们在 [/dmp/custom_audience/rule/create/](1739940509849601.html)的 `inclusion_rule_set` 和 `exclusion_rule_set` 中新增了请求参数 `parameter_filters`。此功能使您能够基于链接关键词和参数的细粒度筛选条件,创建更精细的网站访客受众, 从而创建定向范围更精细的推广系列。 |
| 2024年10月11日 | 产品优化| 推广系列管理 | 我们已扩展[拆分对比测试 API ](1742666215544834.html)中可监测的关键指标(`key_metric`),使用优化目标落地页浏览量的广告组(`TRAFFIC_LANDING_PAGE_VIEW`)可使用`COST_PER_LANDING_PAGE_VIEW`,`LANDING_PAGE_VIEW_RATE` 等指标,使用优化目标价值(`VALUE`)的广告组可使用 `COMPLETE_PAYMENT_ROAS` 。若想了解如何创建使用新关键指标的拆分对比测试,请查看[拆分对比测试](1742668394531842.html)。 |
| 2024年10月11日 | 产品优化| 推广系列管理 | 我们已支持通过在[/adgroup/create/](1739499616346114.html)中的请求字段`languages`的枚举值`zh`进行简体中文语言定向。 此新增功能可为您提供与中文受众加深互动的机会。 |
2024年9月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|---|
| 2024年9月27日 | 产品优化| 推广系列管理 | 我们已支持将单个 iOS 应用的启用状态专属推广系列配额扩展到每个广告网络 25 个,此功能目前为白名单功能。若想了解专属推广系列配额规则和广告网络,请查看[专属推广系列配额限制](1752256248260610.html)。 |
| 2024年9月27日 | 产品优化| 报表管理 |我们已支持通过新维度 `video_material_id` 获取基础报表中的视频维度数据。若想了解该维度支持的维度组合和指标,请查看[支持的维度](1751443956638721.html)。 |
| 2024年9月27日 | 产品优化| 创意管理 | 我们已支持通过[/creative/portfolio/create/](1739091950439426.html),[/creative/portfolio/get/](1739092113671170.html)和 [/creative/portfolio/list/](1766324010279938.html) 的参数`creative_portfolio_type`的新枚举值`WEB_INFO_CARD`创建和获取新的创新互动样式网站信息卡片。此外,您可以通过[/ad/create/](1739953377508354.html) 或 [/campaign/spc/create/](1767334204047362.html)中的`card_id`参数在广告或智能效果推广系列中使用网站信息卡片素材包。若想了解在广告中使用网站信息卡片素材包的详细步骤,请查看[卡片](1749019652141058.html)。 |
| 2024年9月20日 | 产品优化| 推广系列管理| 我们已上线 Webhook API 接口([/business/webhook/update/](1810521279479810.html), [/business/webhook/list/](1810521289122818.html),[/business/webhook/delete/](1810521297052673.html)),可用于创建、更新、获取和删除开发者应用层级的 TikTok 账号 Webhook 配置。若想了解如何创建可订阅的[事件类型](1759978319341570.html)的 Webhook 配置,可查看[通过 Webhook API 订阅 TikTok 账户的 Webhook 事件](1810521730276354.html)。 |
| 2024年9月13日 | 产品优化| 推广系列管理| 我们已支持在线索广告中使用轮播图片( `CAROUSEL_ADS` )这一广告样式。若想了解如何创建此类广告,可查看[创建轮播广告](1766217791987713.html)和[创建线索广告](1739470742024193.html)。 |
| 2024年9月6日 | 产品优化| 推广系列管理| 我们已支持在商品来源为 TikTok Shop 或橱窗的视频购物广告中使用 Pangle 版位(`PLACEMENT_PANGLE`)和自动版位(`PLACEMENT_TYPE_AUTOMATIC`)。若想了解如何创建此类广告,请查看[创建商品来源为 TikTok Commerce 的视频购物广告](1750361719059457.html)和[创建商品来源为橱窗的视频购物广告](1759232259360770.html)。 |
| 2024年9月6日 | 产品优化| 推广系列管理| 优化目标 `PAGE_VISIT` 已全量发布。此外,请求参数 `tiktok_page_category` 新增了枚举值 `TIKTOK_INSTANT_PAGE` 且 `OTHER_TIKTOK_PAGE` 类型的 TikTok 页面支持了商业化特效页面。这些改动在广告接口([/ad/create/](1739953377508354.html)、[/ad/update/](1739953405142018.html), 和 [/ad/get/](1735735588640770.html))中生效,使您可以在优化目标为 TikTok 页面访问的广告组中将商业化特效页面和 TikTok 即时体验页面设置为广告的目标页面,为广告策略提供新的选择。 |
2024年8月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|---|
| 2024年8月30日 | 产品优化 | 推广系列管理 | 我们已将广告组接口([/adgroup/create/](1739499616346114.html)、[/adgroup/update/](1739586761631745.html) 和 [/ad/audience_size/estimate/](1740302379236353.html))和 [/campaign/copy/task/create/](1788434394151938.html) 中的参数 `location_ids` 和 `zipcode_ids` 各自单独使用和组合使用的最大数量扩展至 3,000。此优化使您可在广告组中对更广泛的地域进行定向。 |
| 2024年8月30日 | 产品优化 | 创意管理 |我们已将 [/creative/ads_preview/create/](1739403070695426.html) 中 `ADS_CREATION` 和 `AD` 这两种预览类型的 `preview_link` 有效期延长至 30 天。这一优化为创意审核过程提供了更大的灵活性。 |
| 2024年8月30日 | 文档优化 | 推广系列管理 |我们新增了使用案例文档[创建社区互动广告](1808164002093058.html),以指导您完成创建社区互动广告的步骤。 |
| 2024年8月23日 | 产品优化| 推广系列管理 |我们已支持在使用推广目标`TRAFFIC`、`LEAD_GENERATION`、`APP_PROMOTION`或`WEB_CONVERSIONS`时通过[/adgroup/create/](1739499616346114.html)中的 `location_ids` 定向 17 个新开放的国家或地区。这些国家或地区包括:阿塞拜疆、保加利亚、玻利维亚、塞浦路斯、阿尔及利亚、爱沙尼亚、克罗地亚、肯尼亚、斯里兰卡、立陶宛、拉脱维亚、尼日利亚、波多黎各、巴拉圭、塞尔维亚、斯洛文尼亚、斯洛伐克。若想查看您可以定向的国家或地区,可调用[/tool/targeting/search/](1761236883355649.html) 或 [/tool/region/](1737189539571713.html)。|
| 2024年8月16日 | 产品优化| 商务中心|我们已在 [/bc/account/transaction/get/](1792849810925569.html) 接口中新增了返回参数 `billing_type`,可用于获取每条交易记录的账单类型属性。|
| 2024年8月16日 | 产品优化| 推广系列管理|我们已支持获取网站转化量和线索收集推广系列的预估成效。若想了解获取预算或出价预估成效结果的步骤,请查看[获取推荐预算](1746463333984258.html)和[获取推荐出价](1746463347473410.html)。|
| 2024年8月16日 | 产品优化| 推广系列管理|我们已支持通过 [/adgroup/create/](1739499616346114.html) 中的 `location_ids` 定向阿根廷、智利、哥伦比亚、厄瓜多尔和秘鲁的新增 `CITY` 级别地域 ID。若想查看您可以定向的城市,可调用[/tool/targeting/search/](1761236883355649.html)或 [/tool/region/](1737189539571713.html)。|
| 2024年8月16日 | 产品优化| 广告度量|我们新增了文档[使用网站事件的有效负载助手](1807346079965186.html),以指引您使用有效负载助手构建事件 API 2.0 报告网站事件的有效负载。|
| 2024年8月9日 | 产品优化| 报表管理|我们已更新[基础报表](1751443967255553.html),[受众分析报表](1751454162042882.html),[试玩素材报表](1751617882108929.html),[DSA 报表](1751625293044737.html)和[合约广告报表](1751631257050114.html)中指标的名称和定义,从而与 TikTok 广告管理平台中的指标名称和定义保持一致。API 中指标字段名仍保持不变,以避免对您的现有集成造成影响。|
| 2024年8月9日 | 产品优化| 推广系列管理|我们的拆分对比测试接口([/split_test/create/](1742666471475201.html),[/split_test/update/](1742666501911553.html),[/split_test/end/](1742666522399746.html),和[/split_test/result/get/](1742666557045761.html))目前已支持推广系列层级拆分对比测试。此外,[/campaign/get/](1739315828649986.html)和[/adgroup/get/](1739314558673922.html)中新增响应参数`split_test_enabled`,可用于筛选已启用或未启用拆分对比测试的推广系列。若想了解此功能详情,请查看[拆分对比测试](1742668394531842.html)和[使用拆分对比测试](1742668948278274.html)。|
| 2024年8月2日 | 产品优化| 推广系列管理| 我们已支持通过推广系列接口([/campaign/create/](1739318962329602.html),[/campaign/update/](1739320422086657.html)和 [/campaign/get/](1739315828649986.html))中的 `rta_id` 和 `rta_product_selection_enabled` 字段配置实时 API。此外,[/campaign/copy/task/create/](1788434394151938.html) 中新增请求参数`rta_id`,可用于自定义新复制的推广系列中的实时 API ID。若想了解此功能详情,请查看[实时 API](1805437148769281.html)。|
| 2024年8月2日 | 产品优化| 目录管理|我们已上线[商品库分析 API](1805640759207937.html),可用获取电商商品库中的热门商品和 TikTok 上的热门商品类目。若想了解此功能详情,请查看[获取商品库分析数据](1805437148769281.html)。|
2024年7月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|---|
| 2024年7月19日 | 产品优化| 推广系列管理 | 我们已支持通过 [/adgroup/create/](1739499616346114.html) 的 `zipcode_ids` 字段进行加拿大邮政编码定向,且新增了地域 ID( `location_ids` ),可用于定向更多法国、德国、意大利、西班牙和英国的城市(`CITY`)层级的地域。若想查看这些国家新增的可定向地域,可调用[/tool/targeting/search/](1761236883355649.html) 或 [/tool/region/](1737189539571713.html)。 |
| 2024年7月19日 | 产品优化| 推广系列管理 | 我们已支持通过[/campaign/create/](1739318962329602.html)中`budget_mode`字段的枚举值 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET` 为使用了推广系列预算优化的 `REACH`,`VIDEO_VIEWS` 和`ENGAGEMENT` 推广系列启用动态日预算。此外,还支持通过[/adgroup/create/](1739499616346114.html)中`budget_mode`字段的枚举值`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`为未使用推广系列预算优化的 `REACH`,`VIDEO_VIEWS` 和 `ENGAGEMENT` 广告组启用动态日预算。 |
| 2024年7月12日 | 产品优化| 账号 |我们已上线 [/business/photo/publish/](1803630424390658.html) 接口,可用于将照片帖子发布至自有 TikTok 账号。此外,[webhook 事件](https://business-api.tiktok.com/portal/docs?id=1759979365064706#item-link-post.publish.failed) `post.publish.failed` 的参数 `reason` 新增枚举值 `photo_pull_failed`,用于识别因无法下载指定的图片资源导致的发帖失败。|
| 2024年7月12日 | 产品优化| 报表管理 |我们已上线 [/report/task/cancel/](1803615367145537.html)接口,可用于取消不正确或处理时间过长的异步报表任务。此外,[/report/task/check/](1740302781443073.html) 中的`status`字段新增枚举值 `CANCELED`,用于识别已取消的任务。|
| 2024年7月12日 | 产品优化| 推广系列管理 |我们已在[/campaign/get/](1739315828649986.html),[/adgroup/get/](1739314558673922.html) 和 [/ad/get/](1735735588640770.html)中新增了请求参数`buying_types`,可用于筛选 TopView 推广系列、广告组和广告的数据。此外,[/campaign/get/](1739315828649986.html) 的返回参数`rf_campaign_type` 新增枚举值 `TOPVIEW`且`objective_type` 新增枚举值 `TOPVIEW_REACH`,可用于识别 TopView 推广系列。对于 TopView 广告组,新增了返回参数`predict_impression`,`topview_reach_range`,`pre_discount_cpm`,`cpm`,`discount_type`,`discount_amount`,`discount_percentage` 和`pre_discount_budget`,用于提供广告组的详情。若想了解 API 中支持的 TopView 广告功能,请查看 [TopView](1804258360285186.html)。|
| 2024年7月5日 | 产品优化| 创意管理 |我们已为[/file/video/ad/search/](1740050472224769.html)新增了两个请求字段`video_name`和`video_material_sources`,可用于视频模糊搜索。|
| 2024年7月5日 | 产品优化| 创意管理 |我们已上线[/creative/asset/delete/](1797202997456897.html)接口,可用于删除您的创意资产。|
| 2024年7月5日 | 产品优化| 报表管理 |我们已为[/report/integrated/get/](1740302848100353.html)的请求字段`report_type`新增枚举值`TT_SHOP`,可用于为通过 TikTok Shop 创建的商品最大成交额广告和直播商品交易总额最大化广告请求最大成交额广告报表。若想了解这一新报表类型的详情,请查看[最大成交额广告报表](1803073629472770.html)。此外,还在[商务中心报表](1775747476019266.html)中新增了净消耗指标`billed_cost`。|
| 2024年7月5日 | 产品优化| 创意管理 |我们已为[/creative/portfolio/list/](1766324010279938.html)中的请求字段`creative_portfolio_types` 和返回字段`creative_portfolio_type` 新增了枚举值 `GIFTCODE_STICKER`,可用于检索广告账号中的礼品码贴纸素材包。|
| 2024年7月5日 | 产品优化| 其他 |我们已在[/tt_video/list/](1738376465972226.html)中新增了请求参数`item_types`,可用于筛选广告账户中已通过授权码获取过授权的 Spark Ads 帖子。|
| 2024年7月5日 | 产品优化| 目录管理 |我们已上线了商品库视频接口([/catalog/video/file/](1803655037415489.html),[/catalog/video/log/](1803655061642242.html), [/catalog/video/get/](1803655082498050.html) 和[/catalog/video/delete/](1803655103069185.html)),可用于管理电商商品库中上传的商品库视频。此外,您可以通过广告接口([/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354),[/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018) 和 [/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770))中`vertical_video_strategy` 参数新增的枚举值`CATALOG_UPLOADED_VIDEOS` 使用上传的商品库视频创建视频购物广告。若想了解如何管理上传的商品库视频并应用于广告中,请查看[上传商品库视频并与商品绑定](1803654904260674.html)。|
2024年6月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2024年6月28日| 产品优化 | 商务中心 |余额自动分配功能现已全量。欲了解详情,请查看[管理商务中心的余额分配](1781992772171778.html)。|
| 2024年6月28日| 产品优化 | 推广系列管理 |从 2024 年 6 月 30 日起,对于定向美国的推广系列将新增年龄定向限制。欲了解详情,请查看[TikTok 广告的新增年龄定向限制](1788755983247362.html)。为帮助您及时调整集成,我们已在 [/adgroup/update/](1739586761631745.html) 中新增请求参数`exclude_age_under_eighteen`,可用于排除 18 岁以下的定向年龄区间。此外,[/campaign/copy/task/create/](1788434394151938.html)中新增了请求参数`age_groups`,可用于在复制广告组时自定义定向年龄区间设置。我们还新增了的错误码 `40065`,用于识别与新增年龄限制有关的报错。欲了解详情,请查看[返回码](https://business-api.tiktok.com/portal/docs?id=1737172488964097#item-link-%E5%B9%BF%E5%91%8A%E6%94%BF%E7%AD%96%E7%9B%B8%E5%85%B3)。|
| 2024年6月21日| 产品优化 | 账号 |我们已在评论 webhook 事件 [comment.update](https://business-api.tiktok.com/portal/docs?id=1759979365064706#item-link-comment.update) 中新增了参数`unique_identifier` ,以提高不同 API 之间的一致性和互用性。|
| 2024年6月14日| 产品优化 | 推广系列管理 | 我们已支持在网站转化量广告中使用[优化目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-%E4%BC%98%E5%8C%96%E7%9B%AE%E6%A0%87)`AUTOMATIC_VALUE_OPTIMIZATION` 。若想了解使用此优化目标的步骤,请查看[创建网站转化量广告](1775548501843970.html)。|
| 2024年6月7日 | 产品优化 | 报表管理 | 我们在 DSA 报表中新增了[应用内事件数据指标](1751625293044737.html),可用于度量商品来源为商品库的视频购物广告的应用内付费、加入购物车、结账和查看内容事件。新增的指标包括`purchase`,`total_purchase`,`value_per_total_purchase`, `total_purchase_value`,`app_event_add_to_cart`,`total_app_event_add_to_cart`,`value_per_total_app_event_add_to_cart`,`total_app_event_add_to_cart_value`,`checkout`,`total_checkout`,`value_per_checkout`,`total_checkout_value`,`view_content`,`total_view_content`,`value_per_total_view_content`和`total_view_content_value`。 |
| 2024年6月7日| 产品优化 | 推广系列管理 |我们在广告组接口([/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114),[/adgroup/update/](1739586761631745.html) 和 [/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922))中新增了字段 `vbo_window` ,可用于启用[广告收入价值优化](1739381743067137.html)的第 0 天出价。此外,还在 [/tool/vbo_status/](1770016073586753.html)中新增了返回参数 `vo_iaa_min_roas_zero_day` 和`vo_iaa_highest_value_zero_day`,可用于查询某些设置是否支持启用广告收入价值优化的第 0 天出价。 |
|2024年6月7日 | 产品优化 | 推广系列管理 | 我们已全量发布 AI 生成内容自主声明开关(`aigc_disclosure_type`)。若想了解该开关的详情,请查看[ AI 生成内容自主声明开关](1799186631031809.html)。 |
| 2024年6月7日| 产品优化 | 推广系列管理 | 我们已支持在推广目标为 `LEAD_GENERATION` 和 `TRAFFIC` 的广告中以及`PLACEMENT_PANGLE` 版位上使用[购买意向定向](1739381236849665.html)(`purchase_intention_keyword_ids`) 。 |
| 2024年6月7日 | 产品优化 | 其他 | 我们已在[/page/get/](1737719918220290.html) 中新增了返回参数 `app_id` 和 `has_cpp`,可分别用于获取应用介绍页中指定的应用的 ID 和确认 TikTok 即时体验页面中是否包含自定产品页面。 |
| 2024年6月7日 | 产品优化 | 账号 |我们已在 [/business/comment/list/](1760232109619202.html), [/business/comment/reply/list/](1762228430145538.html), [/business/comment/create/](1762228442072066.html) 和 [/business/comment/reply/create/](1762228448779266.html)中新增了返回参数 `unique_identifier`,以提高不同 API 之间的一致性和互用性。 |
2024年5月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2024年5月31日 | 产品优化 |报表管理|我们已在[基础报表](1751443956638721.html)中废弃了`ad_id` 和 `search_terms` 的维度组合。|
| 2024年5月31日 | 产品优化 | 推广系列管理 |我们已在[/tt_video/info/](1738376324021250.html) 中新增了返回参数 `item_type` 和`carousel_info` ,可用于识别 Spark Ads 照片帖子并获取其详细信息。|
| 2024年5月24日 | 产品优化 | 推广系列管理 |我们已在[/campaign/quota/info/](1752256376677378.html)中新增请求参数`adgroup_id` 和返回参数`ad_quota_info`,可用于获取 SKAN 4.0 专属推广系列下某一广告组的广告配额。|
| 2024年5月24日 | 产品优化 | 推广系列管理 |我们已将 Shop 广告中的竞价策略"成本上限"和"最低 ROAS"分别更名为"目标 CPA"(仅针对优化目标非点击的广告)和 "目标 ROAS",从而更直观地表明每个策略对应的含义。这些竞价策略对应的枚举值将保持不变。若想了解如何在 Shop 广告中使用这些竞价策略,可查看[商品来源为 TikTok Commerce 的视频购物广告](1750361719059457.html), [商品来源为橱窗的视频购物广告](1759232259360770.html),[直播购物广告](1754162402455554.html)和[商品购物广告](1785886237030401.html)。|
| 2024年5月17日 | 产品优化 | 推广系列管理 |我们已在 [/adgroup/status/update/](1739591716326402.html) 中新增请求参数 `allow_partial_success` 和返回参数 `error_list`,可用于启用部分更新成功模式以及返回更新失败时的错误详情。|
| 2024年5月17日 | 产品优化 | 推广系列管理 |我们已在广告接口([/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354), [/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018) 和 [/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770))中新增参数`cpp_url`,可用于在应用推广广告中启用自定产品页面。若想了解相关步骤,请查看[自定产品页面](1798658439859202.html)。|
| 2024年5月17日 | 产品优化 | 推广系列管理 |我们已在广告接口([/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354),[/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018),[/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770)),智能创意接口([/ad/aco/create/](1739473063234626.html),[/ad/aco/update/](1739473077112833.html),[/ad/aco/get/](1739473020978177.html)),智能效果推广系列接口([/campaign/spc/create/](1767334204047362.html),[/campaign/spc/update/](1767334250066945.html),[/campaign/spc/get/](1767334299811842.html))和[/campaign/copy/task/create/](1788434394151938.html) 中新增字段 `aigc_disclosure_type`,可用于在广告中启用 AI 生成内容自主声明开关。若想了解相关步骤,请查看[AI 生成内容自主声明开关](1799186631031809.html)。|
| 2024年5月17日 | 产品优化 | 报表管理 |我们已在[受众分析报表](1738864928947201.html)中增加了新的维度和指标,以便您对受众数据进行更深入的分析。新增的维度包括`hashtag`,`audience_tags`,`additional_interests`和`purchase_intention`。新增的指标包括`delivery_type`,`adgroup_display_name`,`adgroup_schedule`,`optimization_preference`,`image_info`,`ad_display_name`,`identity_type`,`engaged_view`和`engaged_view_15s`。|
|2024年5月17日 |产品优化|通用|我们已在应用创建过程中向新开发者展示弹窗,为他们提供明确的下一步操作指导。|
|2024年5月10日 |文档优化|通用|我们新增了文档[关于本指南](1797738007505921.html),以帮助您流畅、高效地浏览 TikTok API for Business 文档。|
| 2024年5月10日 | 产品优化|推广系列管理|我们已在[/ad/update/](1739953405142018.html)中新增请求参数`product_specific_type`, `product_set_id` 和`item_group_ids`,可用于更新商品来源为商品库的视频购物广告的商品选择维度和所选的商品系列。此外,还支持更新此类广告的动态目标页面策略(`dynamic_destination`)以及删除此类广告中的创新互动样式(`card_id`)。|
2024年4月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2024年4月29日 |产品优化 | Creator Marketplace |我们已将[/tcm/creator/discover/](https://business-api.tiktok.com/portal/docs?id=1739935079726082)中请求参数 `page_size` 的最大值增加至 250,从而允许在单次请求中获取更多创作者的信息。此外,还为此接口的请求参数`major_audience_age`新增枚举值`35-44`,`45-54` 和`55+`,可用于对 35 岁及以上年龄组进行更精细的筛选。 |
| 2024年4月29日 |产品优化 | Creator Marketplace |我们已上线[/oauth2/tcm/get/](https://business-api.tiktok.com/portal/docs?id=1795281223368770)接口,可用于检索授权了某一开发者应用的 TikTok Creator Marketplace 账号列表。 |
| 2024年4月26日 | 产品优化| 创意管理 |我们已废弃[/file/video/ad/search/](1740050472224769.html)中的请求参数`height`,`ratio`,`width` 和 `displayable` ,并将`material_ids`的最大数量从 100 缩小至 20,以提升接口的稳定性。|
| 2024年4月26日 | 产品优化| 受众管理 |我们已上线[/audience/insight/info/](1797016593782785.html)接口,可用于获取您的潜在受众详情。我们还上线了[/audience/insight/overlap/](1797023590780930.html)接口,可用于获取基准受众与最多4个其他Tiktok自定义受众细分之间的重叠信息。|
| 2024年4月26日 | 产品优化| 推广系列管理 |我们已支持使用 iOS 应用创建智能效果推广系列,并在智能效果推广系列 API ([/campaign/spc/create/](1767334204047362.html), [/campaign/spc/update/](1767334250066945.html) 和[/campaign/spc/get/](1767334299811842.html))中新增参数`campaign_app_profile_page_state`,可用于在 iOS 智能效果专属推广系列中使用应用介绍页。|
| 2024年4月26日 | 产品优化| 推广系列管理 |我们已将 SKAN 3.0 专属推广系列的配额扩展至每个广告网络中最多创建 15 个启用状态的专属推广系列,每个专属推广系列中最多创建 5 个启用状态的广告组。若想查询 iOS 应用的推广系列和广告组配额,可使用 [/campaign/quota/info/](1752256376677378.html)。|
| 2024年4月26日 | 产品优化| 推广系列管理 |我们已在[/app/list/](1740859313270786.html) 和 [/app/info/](1740859272887297.html) 中新增返回参数`advanced_dedicated_campaign_allowed`,可用于查询 iOS 应用是否可用于[高级专属推广系列](1797011827608577.html)。此外,还在推广系列 API([/campaign/create/](1739318962329602.html), [/campaign/update/](1739320422086657.html), [/campaign/get/](1739315828649986.html), 和 [/campaign/copy/task/create/](1788434394151938.html))以及智能效果推广系列 API ([/campaign/spc/create/](1767334204047362.html), [/campaign/spc/update/](1767334250066945.html) 和[/campaign/spc/get/](1767334299811842.html))中新增参数`is_advanced_dedicated_campaign`,可用于创建标准高级专属推广系列和智能效果高级专属推广系列。|
| 2024年4月19日 | 产品优化| 推广系列管理 |我们已上线[/targeting/search/](1796638342793218.html)接口,可用于搜索或列举和兴趣与行为相关的定向分类和话题标签。此外,还在[/tool/region/](1737189539571713.html)中新增了请求参数language,可用于获取翻译后的地域名称。|
| 2024年4月12日 | 产品优化| 推广系列管理 |我们已在[普通广告组](1739499616346114.html)和[智能效果广告组](1767334204047362.html)中支持`engaged_view_attribution_window`,可用于衡量观看您的视频广告 6 秒后发生的转化。若想了解不同推广目标下支持的深度互动观看归因窗口期设置,请查看[归因窗口期和事件统计方式](1777694366654465.html)。 |
| 2024年4月12日 | 产品优化| 推广系列管理 |我们已全量发布扩展库存 (`EXPANDED_INVENTORY`),类别排除(`category_exclusion_ids` )和行业敏感内容控制(`vertical_sensitivity_id`)功能。若想了解这些品牌安全功能的详情,请查看[品牌安全](1739381752981505.html)。 |
| 2024年4月12日 | 产品优化| 推广系列管理 |我们已优化了[轮播视频购物广告](https://business-api.tiktok.com/portal/docs?id=1766217791987713#item-link-创建视频购物类型的轮播广告的步骤)中附加图片的失败路径逻辑。若您通过[/ad/create/](1739953377508354.html)或 [/ad/update/](1739953405142018.html)为此类广告指定了`carousel_image_index`,则将在有可用附加图片的商品总数大于等于 2 时,仅在广告中展示这些有可用附加图片的商品,有可用附加图片的商品总数小于 2 时,将展示所有商品,并均使用商品的主图。 |
| 2024年4月12日 | 产品优化| 商务中心 |我们新增了广告账户的预算更新规则。欲了解详情,请查看[管理商务中心的余额分配](1781992772171778.html)。 |
| 2024年4月12日 | 产品优化| 广告度量 |我们在 [/pixel/event/stats/](1740858904557570.html) 中新增了返回参数`browser_event_total_count` 和 `server_event_total_count`,可用于获取 Pixel 网站事件的网络浏览器和服务器事件细分数据。此外,还在 [/pixel/list/](1740858697598978.html) 中新增了返回参数`ownership_status`,可用于判断 Pixel 是否为广告主所有。 |
| 2024年4月12日 |文档优化 | 通用 |我们新增了[需要帮助](1795190020378625.html)页面,以方便您找到帮助信息。 |
2024年3月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2024年3月29日 | 产品优化| 报表管理|我们取消了之前在[受众分析报表](1751454103714818.html)中`dma_id`和时间维度不能同时使用的限制。 |
| 2024年3月29日 | 产品优化| 商务中心|我们在 [/advertiser/update/](1739939050770434.html) 和 [/advertiser/balance/get/](1739939106470913.html) 的 `budget_mode` 中新增了两个枚举值 `DAILY_BUDGET`,`CUSTOM_BUDGET`。我们还在 [/advertiser/update/](1739939050770434.html) 中增加了一个新的请求参数 `budget_update_type`。 |
| 2024年3月29日 | 产品优化| 推广系列管理|我们已全量发布动态日预算(`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`)。若想了解推广系列和广告组层级可用的预算类型,请查看[预算](1739381246298114.html)。 |
| 2024年3月22日 | 产品优化| 推广系列管理|我们已支持在广告投放或产生消耗前通过[/adgroup/update/](1739586761631745.html)或[/adgroup/rf/update/](1738235402874882.html)更新品牌安全设置`brand_safety_type`,`category_exclusion_ids` 和`vertical_sensitivity_id`。若想了解更新`brand_safety_type`的具体前提条件,请查看[更新出价前品牌安全筛选设置的前提条件](https://business-api.tiktok.com/portal/docs?id=1739381752981505#item-link-%E6%9B%B4%E6%96%B0%E5%87%BA%E4%BB%B7%E5%89%8D%E5%93%81%E7%89%8C%E5%AE%89%E5%85%A8%E7%AD%9B%E9%80%89%E8%AE%BE%E7%BD%AE%E7%9A%84%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6)。 |
| 2024年3月22日 | 产品优化| 推广系列管理|我们已支持为直播购物广告和商品来源为 TikTok Shop 的视频购物广告启用出价前第一方筛选和出价后第三方品牌安全监测,以及为覆盖和频次广告和商品来源为 TikTok Shop 的视频购物广告启用出价后第三方可见性监测。若想了解品牌安全的支持范围,请查看[品牌安全](1739381752981505.html)。 |
| 2024年3月22日 | 产品优化| 推广系列管理|我们已不再支持使用未在 MMP (移动测量合作伙伴)侧启用 SAN([自归因](https://ads.tiktok.com/help/article/about-self-attribution-transition?lang=en))模块的应用新建 iOS 专属推广系列或广告组。 |
| 2024年3月15日 | 产品优化| 商品库管理|我们已在[/catalog/product/get/](1740564136678402.html)中新增返回参数`ad_creation_eligible`,可用于直接查询电商商品库中的商品能否用于广告中。 |
| 2024年3月15日 | 产品优化| TikTok 商店|我们已上线[/store/product/get/](1793482248880130.html)接口,可用于查询 TikTok Shop 中的商品信息。|
| 2024年3月15日 | 产品优化|其他|我们已在 [/showcase/region/get/](1759233561597954.html) 和 [/showcase/product/get/](1759233576199169.html) 中新增请求参数`identity_authorized_bc_id`,可用于降低为`BC_AUTH_TT`类型的认证身份查询橱窗可定向地区或橱窗中商品时的请求超时。|
| 2024年3月15日 | 产品优化| 推广系列管理|SKAN 4.0 现已对符合条件的应用全量发布,相应的推广系列结构也已更新。若想了解使用 SKAN 4.0 应用的推广系列最新结构,请查看[专属推广系列结构](https://business-api.tiktok.com/portal/docs?id=1740029173531649#item-link-%E4%B8%93%E5%B1%9E%E6%8E%A8%E5%B9%BF%E7%B3%BB%E5%88%97%E7%BB%93%E6%9E%84)。 |
| 2024年3月15日 | 文档优化|通用|我们更新了开发者个人资料和开发者应用申请指南,对填入信息要求进行了详细说明,并提供了可能的拒审原因。详情见[注册成为开发者](1738855176671234.html),[创建开发者应用](1738855242728450.html),[频控规则](1740029171730433.html)和[应用权限范围](1738855280338946.html)。|
| 2024年3月8日 | 产品优化 | 创意管理 |我们在[/creative/ads_preview/create/](1739403070695426.html)中已支持预览计划创建或已创建(即`preview_type`为`ADS_CREATION`或`AD`)的`RF_REACH`广告。 |
| 2024年3月8日 | 产品优化| 商务中心|我们已上线新接口[/bc/account/transaction/get/](1792849810925569.html),可用于获取商务中心或商务中心中广告账户的交易记录。 |
| 2024年3月8日 | 产品优化 | 创意管理 |我们在[/creative/ads_preview/create/](1739403070695426.html)中已支持预览计划创建或已创建(即`preview_type`为`ADS_CREATION`或`AD`)的`RF_REACH`广告。 |
| 2024年3月8日 | 产品优化| 账号 | 我们已废弃 TikTok 账户授权 URL (v1)。 |
| 2024年3月8日 | 产品优化 | 账号 | 我们已支持在[/business/video/publish/](1762228496095234.html)的请求参数 `caption` 中使用换行符(\n),从而发布可在 TikTok 手机端应用折行显示多行视频描述的视频。 |
| 2024年3月1日|产品优化 | 其他|我们在 [/advertiser/info/](1739593083610113.html) 中新增了返回参数 `company_name_editable`,可以用于判断广告账号的公司名称是否支持通过 API 修改。|
| 2024年3月1日|产品优化 | 通用|我们为1.3版本制作了第一个[快速入门](1781888800300034.html)视频教程,该视频同时提供英文和中文版本。|
| 2024年3月1日|文档优化 | 通用|我们新增了文档[对象 ID 唯一性](1792139804568578.html),以说明常见 ID 字段的唯一性,此信息可供您在设计 TikTok API for Business 数据的本地存储系统时进行参考。|
| 2024年3月1日|产品优化 | 其他|我们优化了[/v1.3/pangle_block_list/update/](https://business-api.tiktok.com/open_api/v1.3/pangle_block_list/update/)中`success_count`字段的逻辑。目前`success_count`字段仅记入成功添加到屏蔽列表的App数量。|
2024年2月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2024年2月23日|产品优化 | 受众管理|我们新增了新的受众类型,线下活动受众,以及该受众类型相关的筛选字段值。详细信息请参阅“[枚举值-受众管理-受众类型](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-受众类型)”和“[枚举值-受众管理-筛选字段值](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-筛选字段值)”。|
| 2024年2月23日|产品优化 | 报表管理|我们已支持为商品来源为商品库的视频购物广告请求 DSA 报表。若想了解此类广告支持拉取的报表数据,请查看[支持的维度](1751625287345154.html)和[支持的指标](1751625293044737.html)。|
| 2024年2月8日|产品优化 | 报表管理|我们通过在基础报表中新增了基础数据指标`billed_cost`,支持净成本指标。有关详细信息,请参阅[基础报表支持的指标](1751443967255553.html)。|
| 2024年2月8日|产品优化 | 工具|我们在 [/tool/interest_keyword/recommend/](1763590884474882.html) 中新增了请求参数 `keywords` 和返回参数 `input_keyword`,可基于种子关键词列表生成推荐兴趣关键词。此外,还在 [/tool/hashtag/recommend/](1739318962329602.html) 中新增了请求参数 `operator` 和返回参数 `input_keyword`,可为关键词列表中的每个关键词分别生成推荐话题标签。|
| 2024年2月8日|产品优化 | 通用|我们已增强参数处理规则,以提高 API 接口的一致性和安全性。在不规范的位置使用参数,例如对于使用 POST 方法的接口,将参数放在查询字符串中,可能会导致报错。<ul><li> 对于使用 GET 方法的接口,请求参数(除 Header 参数外)应仅在查询字符串中指定。</li><li> 对于使用 POST 方法的接口,请求参数(除 Header 参数外)应仅在请求 Body 中指定。</li></ul>|
| 2024年2月2日|产品优化 | 推广系列管理|我们已支持通过 Spark Ads 推送模式使用“添加到商务中心的 TikTok 用户”类型的认证身份创建 Spark Ads。若想了解相关步骤,请查看[将帖子推送至商务中心中授权的 TikTok 账户](https://business-api.tiktok.com/portal/docs?id=1739470744631298#item-link-%E5%B0%86%E5%B8%96%E5%AD%90%E6%8E%A8%E9%80%81%E8%87%B3%E5%95%86%E5%8A%A1%E4%B8%AD%E5%BF%83%E4%B8%AD%E6%8E%88%E6%9D%83%E7%9A%84%20TikTok%20%E8%B4%A6%E6%88%B7)。|
| 2024年2月2日|产品优化 | 推广系列管理|我们已支持在标准轮播广告中启用推广系列预算优化和 Spark Ads。若想了解相关步骤,请查看[创建标准轮播广告的步骤](https://business-api.tiktok.com/portal/docs?id=1766217791987713#item-link-%E5%88%9B%E5%BB%BA%E6%A0%87%E5%87%86%E8%BD%AE%E6%92%AD%E5%B9%BF%E5%91%8A%E7%9A%84%E6%AD%A5%E9%AA%A4)。|
| 2024年2月2日|产品优化 | 推广系列管理|我们已在 [/campaign/copy/task/create/](1788434394151938.html)中新增了请求参数 `ad_format`,可用于将单视频或单图片广告转换为标准轮播广告,或将标准轮播广告转换为单视频或单图片广告。|
| 2024年2月2日|产品优化 | 创意管理| 我们已支持在 [/creative/report/get/](1789700050715650.html)中使用请求参数`report_type`及其枚举值`VIDEO_INSIGHT`创建视频洞察报表。若想了解视频洞察报表支持的指标,请查看[视频洞察报表中支持的指标](1789703614085122.html)。|
| 2024年2月2日|产品优化 | 工具| 我们已升级 [/tool/diagnosis/get/](1738674986981378.html) 接口,新增了预算预估成效和出价预估成效诊断功能,同时废弃了失效功能。若想了解变动详情,请查看“[v1.2与v1.3版本对比](https://business-api.tiktok.com/portal/docs?id=1738674986981378#item-link-Comparing%20v1.2%20and%20v1.3)”小节。|
| 2024年2月2日|产品优化 | 工具|我们在[/tool/region/](1737189539571713.html)中新增了请求参数`shopping_ads_type` 和 `promotion_type`,可用于获取购物广告场景下的可投放地域。此外, [/showcase/product/get/](1759233576199169.html) 中新增了请求参数 `filtering` 和`item_group_ids` 以及返回参数`title`,`product_image_url`,`min_price`,`max_price`,`currency`,`category` 和`status` ,有助于您基于更多商品信息,挑选商品来源为橱窗的视频购物广告中要用的商品。|
| 2024年2月2日|产品优化 | 创意管理| 我们已在 [/tt_video/list/](1738376465972226.html) 和 [/identity/video/get/](1738376465972226.html)中添加请求参数`keyword`,用于通过`item_id`或TikTok帖子文本搜索TikTok帖子。|
| 2024年2月2日|产品优化 | 推广系列管理|我们已支持在更多推广目标(`RF_REACH`,`APP_PROMOTION`,`WEB_CONVERSIONS`,`TRAFFIC`,`LEAD_GENERATION`)下使用[类别排除](https://business-api.tiktok.com/portal/docs?id=1739381752981505#item-link-类别排除)。请注意,类别排除仅当品牌安全类型设置为标准库存或有限库存时可用。对于创建[TikTok Pulse广告](https://business-api.tiktok.com/portal/docs?id=1744571201117186#item-link-TikTok%20Pulse),唯一可用的品牌安全类型是“有限库存”。
| 2024年2月2日|产品优化 | 推广系列管理|我们已在[/adgroup/rf/create/](1738235338194945.html)中新增请求和返回参数 `category_exclusion_ids`。此外,[/tool/content_exclusion/get/](1747747118654465.html)中 `brand_safety_type`的默认值现已设置为 `STANDARD_INVENTORY`。|
2024年1月
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2024年1月26日 | 产品优化 | 推广系列管理| 我们已支持通过[/adgroup/create/](1739499616346114.html) 和 [/adgroup/update/](1739586761631745.html) 中请求参数`optimization_event`的新枚举`AD_REVENUE_VALUE`,启用仅 Pangle 版位的广告收入价值优化。若想了解广告收入价值优化的详情,请查看[价值优化](1739381743067137.html)和[开启价值优化](1770019181843458.html)。|
| 2024年1月26日 | 产品优化 | 工具| 我们已在[/tool/vbo_status/](1770016073586753.html)中新增返回参数`vo_iaa_min_roas` 和 `vo_iaa_highest_value`,可用于检查您的应用是否支持广告收入价值优化。|
| 2024年1月26日 | 产品优化 | 商品库管理|我们在[/catalog/product/upload/](https://ads.tiktok.com/marketing_api/docs?id=1740497429681153)中新增了请求参数`video_url`,可用于为酒店、航班和目的地商品库中的商品配置视频 URL 这一商品属性。此外,[/catalog/product/file/](https://ads.tiktok.com/marketing_api/docs?id=1740496787164161)中可用于向酒店、航班和目的地商品库上传商品的 CSV 模版也新增对应参数`video_link`。|
| 2024年1月26日 | 产品优化 | 推广系列管理|我们在广告接口([/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354), [/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018),和 [/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770))中新增了参数`deeplink_utm_params`,可用于将 URL 参数拼接至商品来源为商品库的视频购物广告中使用的商品库深度链接。此外,广告接口中的现有参数`utm_params` 已支持将 URL 参数拼接至推广应用且商品来源为商品库的视频购物广告中使用的商品库链接。|
| 2024年1月26日 | 文档优化 | 推广系列管理|我们对商品来源为商品库的视频购物广告的使用案例文档进行了改版升级。[改版后的用例文档](1750361698613249.html)增加了核心使用场景的代码示例,并提供了更清晰的集成指南。|
| 2024年1月22日 | 产品优化 | 推广系列管理| 为加强对 TikTok 上 18 岁以下用户的保护,我们引入了额外的广告推广限制。若想了解受影响的场景,请查看 [TikTok 广告的新增年龄定向限制](1788755983247362.html)。|
| 2024年1月19日 | 产品优化 | 推广系列管理| 我们已上线推广系列异步复制接口[/campaign/copy/task/create/](1788434394151938.html) 和 [/campaign/copy/task/check/](1788434463507458.html),支持复制推广系列,并根据需要调整推广系列设置及其中的广告组和广告设置。若想了解相关步骤,请查看[复制推广系列](1788434533212162.html)。|
| 2024年1月19日 | 产品优化 | 推广系列管理| 我们通过在[/campaign/spc/create/](1767334204047362.html), [/campaign/spc/update/](1767334250066945.html)和[/campaign/spc/get/](1767334299811842.html)增加`budget_mode`下的枚举值`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`,`gender`参数和`landing_page_urls`的多落地页模式,支持智能效果推广系列的动态每日预算、多URL和性别定向功能。 |
| 2024年1月12日 | 产品优化 | 创意管理| 我们已支持通过[/creative/ads_preview/create/](1739403070695426.html) 使用 `ADS_CREATION` 或 `AD` 模式预览推广目标为线索收集(`LEAD_GENERATION`)或社区互动(`ENGAGEMENT`)的广告。 |
| 2024年1月12日 | 产品优化 | 推广系列管理| 我们对直播购物广告的使用案例文档进行了改版升级。[改版后的用例文档](1754162402455554.html)增加了直播购物广告核心使用场景的代码示例,并提供了更清晰的集成指南。 |
| 2024年1月5日 | 产品优化 | 受众管理 | 我们在[/dmp/custom_audience/get/](1739940507792385.html)中添加了参数`owner_id`、`lookalike_spec`、`source_audience_id`、`include_source`、`mobile_os`、`placements`、`location_ids`和`audience_size`,以支持创建者广告商ID和相似受众特定信息的获取。 |
2023年
2023年12月
``xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2023年12月29日 | 产品优化 | 推广系列管理 | 我们已在[线索广告](1774482992153601.html)中支持会话数这一[优化目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-优化目标),为字段optimization_goal增加了对应枚举值CONVERSATION。此外,还在 [/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770) 接口中为筛选字段destination新增了枚举值SOCIAL_MEDIA_APP和PHONE_CALL。 |
| 2023年12月29日 | 产品优化 | 报表管理 | 我们为[基础报表](1751443975608321.html)和[受众分析报表](1751454172429314.html)中的筛选条件destination新增了枚举值SOCIAL_MEDIA_APP和PHONE_CALL,可用于筛选目标页面为社交媒体 URL 或电话号码的线索广告。 |
| 2023年12月22日 | 产品优化 | 推广系列管理 | 我们在 [/campaign/get/](1739315828649986.html), [/adgroup/get/](1739314558673922.html)和 [/ad/get/](1735735588640770.html)接口中新增了请求参数campaign_system_origins,可用于获取内容加热广告的数据。若想了解内容加热广告详情,请查看[内容加热推广系列](1785880454546433.html)。 |
| 2023年12月22日 | 产品优化 | 报表管理 | 我们在[基础报表](1751443975608321.html)和[受众报表](1751454172429314.html)中新增了筛选条件campaign_system_origins,可用于专门请求内容加热广告的报表数据。 |
| 2023年12月22日 | 产品优化 | 推广系列管理 | 我们为广告组层级的shopping_ads_type字段新增了枚举值PRODUCT_SHOPPING_ADS,可用于创建商品购物广告。若想了解 商品购物广告详情,请查看[创建购物广告](1741942179356738.html)和[创建商品购物广告](1785886237030401.html)。 |
| 2023年12月15日 | 产品优化 | 报表管理 | 我们在 [/campaign/spc/report/get/](1776454619412481.html)接口的请求参数material_type中添加了枚举值SPC_SPARK,并添加了返回参数identity_id、tiktok_name和tiktok_item_id,从而支持查询智能效果推广系列 Spark 广告的效果指标。 |
| 2023年12月15日 | 产品优化 | 受众管理 | 我们通过在 [/dmp/custom_audience/rule/create/](1739940509849601.html) 接口的audience_type参数中添加两个新的枚举值ENGAGEMENT_LIVE_VIDEO和ENGAGEMENT_ORGANIC_VIDEO,支持直播和自然流量互动受众。 |
| 2023年12月15日 | 产品优化 | 推广系列管理 | 我们在[/ad/update/](1739953405142018.html)中新增了请求参数sku_ids,可用于更新商品来源为商品库的视频购物广告中指定的特定商品。 |
| 2023年12月15日 | 产品优化 | 其他 | 我们已上线 [/identity/live/get/](1785238052792321.html) 接口,用于获取认证身份下的直播视频。 |
| 2023年12月8日 | 产品优化 | 推广系列管理 |我们已将对应的推广系列层级objective_type设置为PRODUCT_SALES且campaign_product_source设置为CATALOG的广告组中允许的最大[广告数量限制](https://ads.tiktok.com/marketing_api/docs?id=1739381193120770)从 20 增加至 50。|
| 2023年12月1日 | 产品优化 | 报表管理 | 我们在基础报表和受众分析报表添加了新的维度和指标。<br>基础报表中新的维度:event_source_id,page_id,component_name,room_id<br>基础报表中新的指标:advertiser_id,advertiser_name,adgroup_download_url,profile_image,bid_secondary_goal,ad_id,ad_profile_image,ad_url,unique_ad_impression_events,cost_per_unique_ad_impression_event,customized_ad_impression_event_rate,ads_impression_events,cost_pre_ad_impression_event,value_per_ad_impression_event,total_ad_impression_events_value,total_ad_impression_roas,page_content_view_events,total_page_view_content_events_value,cost_per_page_content_view_event,page_content_view_event_rate,value_per_page_content_view_event<br>受众分析报表中新的维度:ad_type<br>受众分析报表中新的指标:advertiser_id,advertiser_name,app_promotion_type,adgroup_download_url,profile_image,bid_secondary_goal,ad_id,ad_profile_image,ad_url`
## 2023年11月
```xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|---|
| 2023年11月24日 | 产品优化 | 推广系列管理 | 我们在广告组接口([/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114),[/adgroup/update/](1739586761631745.html) 和 [/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922))中新增了字段`smart_audience_enabled` 和 `smart_interest_behavior_enabled`,可用于开启广告组的智能受众和智能型兴趣和行为。若想了解这些功能的详情,请查看[智能定向](1783164662979586.html)。 |
| 2023年11月24日 | 产品优化 | 推广系列管理 | 我们通过参数`brand_safety_type`的新枚举值`EXPANDED_INVENTORY`支持新的品牌安全类型:扩展库存。可在[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114), [/adgroup/update/](1739586761631745.html) , [/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922), [/adgroup/rf/create/](1738235338194945.html), [/adgroup/rf/update/](1738235402874882.html), [/tool/region/](1737189539571713.html), [/tool/targeting/info/](1761237001980929.html), [/tool/targeting/search/](1761236883355649.html), [/tool/contextual_tag/get/](1747747118654465.html), [/tool/content_exclusion/get/](1769738074686465.html)和[/rf/inventory/estimate/](1738235487941633.html)接口中使用。 |
| 2023年11月17日 | 产品优化 | 报表管理 | 我们在基础报表和受众分析报表添加了竞价广告、覆盖和频次广告以及 TopView 广告数据。使用[/report/integrated/get/](1740302848100353.html) 接口生成[基础报表](1751443975608321.html),按售卖类型进行筛选以获取特定数据。目前,受众分析报表还不支持按售卖类型进行筛选。 |
| 2023年11月17日 | 产品优化 | 报表管理 | 我们在同步基础报表中添加了新的筛选条件和指标。新增[筛选条件](1751443975608321.html)包括`objective_type`、`buying_type`、`age`、`gender`、`is_cbo_enabled`、`app_promotion_type`、`billing_event`、`delivery_type`、`ad_entity_type`和`identity_type`,新增的[指标](1751443967255553.html)包括`engaged_view_through_conversions`、`cost_per_engaged_view_through_conversion`和`video_watched_continuous_2s`。 |
| 2023年11月17日 | 产品优化 | 报表管理 |我们在 [/campaign/spc/report/get/](1776454619412481.html)中添加了请求参数`is_include_removed_material`和返回字段`file_name`,可用于查询视频名称和已删除视频或文本的数据。 |
| 2023年11月17日 | 产品优化 | 创意管理 |我们已支持通过[/creative/ads_preview/create/](1739403070695426.html) 使用 `ADS_CREATION` 或 `AD` 模式预览带有商品磁贴的广告。 |
| 2023年11月17日 | 产品优化 | 广告度量 |我们在 [/pixel/list/](1740858697598978.html) 和 [/pixel/event/stats/](1740858904557570.html) 中新增了返回参数`custom_event_type`,可用于识别自定义 Pixel 事件。 |
| 2023年11月17日 | 产品优化 | 其他 |我们在 [/comment/list/](1738086301876225.html) 和 [/comment/reference/](1738086824859650.html) 中新增了返回参数`user_id`,可用于获取发表评论的 TikTok 用户的 ID。 |
| 2023年11月17日 | 产品优化 | 推广系列管理 |我们在 [/ad/aco/get/](1739473020978177.html) 中新增了返回参数`material_name`,可用于获取程序化创意广告中素材的素材名称。 |
| 2023年11月10日 | 产品优化 | 商务中心 | 我们通过更新[/advertiser/balance/get/](1739939106470913.html) ,[/advertiser/update/](1739939050770434.html) 和 [/bc/transfer/](1739939095321601.html)接口,支持余额共享功能。具体步骤请参见[余额共享](https://business-api.tiktok.com/portal/docs?id=1781992681160770)和[管理商务中心的余额分配](1781992772171778.html)。 |
| 2023年11月10日 | 文档优化 | 通用 | 我们已更新[Marketing API](1781891416235009.html)、[推广系列管理](1739578433846274.html)、[快速入门](1735713609895937.html)和[附录](1737172315193346.html)等章节,以提高内容的有效性和可查找性。 |
| 2023年11月10日 | 产品优化 | 推广系列管理 | 我们已在[访问量广告](1782086241778690.html)和[视频购物广告](1782087855154177.html)中支持目标页面访问这一优化目标,并为字段[`optimization_goal`](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138) 和[`optimization_event`](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889) 增加了对应枚举值`DESTINATION_VISIT` 。此外,针对访问量广告场景在广告接口([/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354), [/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018),和 [/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770))中新增了字段`deeplink_format_type`。 |
| 2023年11月10日 | 产品优化 | 推广系列管理 | 我们在[/ad/update/](1739953405142018.html)接口中新增请求参数`patch_update`,可用于增量更新普通广告中的部分字段。此外,在[/ad/aco/update/](1739473077112833.html)接口中也新增请求参数`patch_update`,可用于接口层级增量更新程序化创意广告。 |
| 2023年11月10日 | 产品优化 | 报表管理 | 我们在同步基础报表中新增了三个[站内事件指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-站内事件指标)(`onsite_destination_visits` ,`cost_per_onsite_destination_visit`,`onsite_destination_visit_rate`),可用于评估"目标页面访问"广告的表现。 |
| 2023年11月10日 | 产品优化 | 其他 | 我们在[/identity/video/info/](1740218522178562.html)接口中新增了请求参数 `item_ids` 和返回参数 `video_details`,可用于获取至多 20 个TikTok 帖子的详情。 |
| 2023年11月10日 | 文档优化 | 商品库管理 | 我们新增了文档[商品库管理器的商品库管理功能与 API 配置间的映射](1782141580104705.html) ,以阐明如何通过 API 集成实现商品库管理器的商品库管理功能。 |
| 2023年11月3日 | 产品优化 | 广告度量 | 我们已上线[/crm/list/](1780896521680898.html) 接口,可用于获取广告账户中的 CRM (客户关系管理)事件组列表。 |
| 2023年11月3日 | 产品优化 | 工具 | 我们在[/tool/vbo_status/](1770016073586753.html)接口中新增了请求参数 `campaign_type`,从而确保与广告创建流程的传参的一致性。 |
| 2023年11月3日 | 产品优化 | 推广系列管理 | 我们已降低了商品来源为 TikTok Shop 或橱窗的购物广告中的最低[预算](1739381246298114.html)要求。此类广告推广系列层级最低预算为10 美元,广告组层级使用日预算时最低预算为 10 美元,使用总预算时最低预算为 10 美元 × 计划天数。 |
2023年10月
xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2023年10月27日 | 产品优化 | 受众管理 | 我们已上线[已保存受众API](1780154462204930.html),可用于存储定向设置,并可复用已保存受众创建广告组。 |
| 2023年10月27日 | 产品优化 | 推广系列管理 | 我们已支持通过推广系列接口([/campaign/create/](1739318962329602.html),[/campaign/update/](1739320422086657.html)和 [/campaign/get/](1739315828649986.html))中的 `special_industries` 字段,为购物广告设置特殊广告分类。 |
| 2023年10月27日 | 产品优化 | 推广系列管理 | 我们已废弃`APP_INSTALL`和`CONVERSIONS`推广目标。 |
| 2023年10月27日 | 产品优化 | 报表管理 | 我们优化了通过[/report/integrated/get/](1740302848100353.html)(不带有`order_field`和`enable_total_metrics`参数)获取的、具有`behavior_id`维度的受众分析报表的[报表性能](1757262274182145.html)。 |
| 2023年10月27日 | 产品优化 | 报表管理 | 我们已支持在商务中心报表中的`country_code`维度下请求`cash_spend` ,`cashback_coupon_spend` 和`voucher_spend` 指标。 |
| 2023年10月27日 | 产品优化 | 商品库管理 | 我们已上线接口[/diagnostic/catalog/eventsource/issue/](1780799405041665.html) 和[/diagnostic/catalog/eventsource/metric/](1780802101608450.html) ,可用于诊断商品库事件源。若想了解相关步骤,请查看[使用诊断数据排查商品库问题](1780803490136066.html)和[商品库管理器的商品库诊断功能与 API 配置间的映射](1780803525320706.html)。 |
| 2023年10月27日 | 产品优化 | 创意管理 | 我们已在 [/file/image/ad/upload/](1739067433456642.html)中限制了上传图片的总像素数(最大 3,686,400 像素),以提高该接口的整体效率和可靠性。 |
| 2023年10月23日 | 产品优化 | Creator Marketplace |我们新增了 [/tcm/creator/discover/](https://business-api.tiktok.com/portal/docs?id=1739935079726082) 中请求参数`sort_field`的枚举值`relevance`,可用于对返回结果按相关性排序。 |
| 2023年10月20日 | 产品优化 | 创意管理|我们已支持通过 [/creative/portfolio/create/](https://ads.tiktok.com/marketing_api/docs?id=1739091950439426)和 [/creative/portfolio/get/](https://ads.tiktok.com/marketing_api/docs?id=1739092113671170)的参数`creative_portfolio_type`的新枚举值`PRODUCT_TILE`创建和获取新的创新互动样式商品磁贴。此外,您可以通过[/ad/create/](1739953377508354.html)中的`card_id`参数在广告中使用商品磁贴素材包。欲了解在广告中使用商品磁贴素材包的详细步骤,请查看[卡片](1749019652141058.html)。|
| 2023年10月20日 | 产品优化 | 推广系列管理| 我们已在应用推广目标下的应用再营销和 iOS 场景以及商品销量目标下的 iOS 场景支持归因窗口设置。此外,废弃了应用推广广告组非重定向场景下自归因应用的长归因窗口选项(14 天和 28 天点击归因窗口,以及 7 天展示归因窗口)以及商品销量广告组重定向场景下 Android 应用的 28 天点击归因窗口选项。欲了解不同场景下可用的归因设置,请参阅[归因窗口期和事件统计方式](1777694366654465.html)。|
| 2023年10月20日 | 产品优化 | 推广系列管理| 我们新增了枚举值`ADGROUP_STATUS_ADGROUP_PRE_ONLINE`和`AD_STATUS_AD_PRE_ONLINE`,用于显示广告组和广告的预上线状态。若想了解这些枚举值详情,请查看[枚举值 - 二级状态 - 广告组状态](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-广告组状态)以及[枚举值 - 二级状态 - 广告状态](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-广告状态)。|
| 2023年10月13日 | 产品优化 | 推广系列管理| 我们在[/tool/contextual_tag/get/](1747747118654465.html)和 [/tool/contextual_tag/info/](1747747180830722.html)接口新增了返回参数`content_lineup_type`,可用于标识Max Pulse或类别分组的内容相关定向标签。请参阅 [TikTok Pulse](https://business-api.tiktok.com/portal/docs?id=1744571201117186#item-link-TikTok%20Pulse) 以了解使用TikTok Pulse的更多信息。 |
| 2023年10月13日 | 产品优化 | 报表管理| 我们在 [/report/integrated/get/](1740302848100353.html) 中添加了`advertiser_ids`,您可在同步报表中指定最多五个广告主ID。 |
| 2023年10月13日 | 产品优化 | 推广系列管理 | 我们在广告组接口([/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114), [/adgroup/update/](1739586761631745.html) 和 [/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922))中新增了`shopping_ads_retargeting_custom_audience_relation`字段,可在视频购物广告中用于取重定向受众和自定义受众的并集构建定向受众。 |
| 2023年10月13日 | 产品优化 | 推广系列管理 | 我们新增了[广告组二级状态](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-广告组状态)的三个枚举值(`ADGROUP_STATUS_SEARCH_KEYWORDS_IN_REVIEW`,`ADGROUP_STATUS_SEARCH_KEYWORDS_NOT_AVAILABLE`和`ADGROUP_STATUS_SEARCH_KEYWORDS_PARTIAL_APPROVED`),用于显示搜索推广系列中广告组的关键词状态。您可将这些枚举值传入[/adgroup/get/](1739314558673922.html)中的`secondary_status` 字段作为筛选条件。|
| 2023年10月13日 | 文档优化 | 推广系列管理 | 我们新增了[深度链接文档](1779541971843073.html),介绍深度链接类型,失败路径,以及具体场景下的支持的深度链接和失败路径设置。|
| 2023年10月9日 | 产品优化 | 账号| 我们在 [URL 资源接口](1769325247778818.html)中废弃了请求参数`Access-Token` 和 `advertiser_id`,并新增请求参数`app_id`,使您无需广告主 ID 便可以使用这些接口。 |
2023年9月
``xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2023年9月28日 | 产品优化 | 通用 | 我们已支持在v1.3沙箱中使用[/identity/create/](https://ads.tiktok.com/marketing_api/docs?rid=uraumvplog&id=1740654203526146), [/identity/get/](https://ads.tiktok.com/marketing_api/docs?rid=uraumvplog&id=1740218420781057) 和 [/identity/delete/](https://ads.tiktok.com/marketing_api/docs?rid=uraumvplog&id=1759155939236865)接口获取identity_id,可用于在沙箱账户中管理广告。|
| 2023年9月28日 | 产品优化 | 推广系列管理| 我们在[/campaign/get/](1739315828649986.html), [/campaign/create/](1739318962329602.html) 和 [/campaign/update/](1739320422086657.html)中增加了返回参数is_search_campaign,可用于区分推广系列是否为搜索推广系列。|
| 2023年9月25日 | 产品优化| 账号 |我们已支持通过[/business/video/publish/](1762228496095234.html)中的请求参数is_brand_organic和is_branded_content为发布的视频开启原生品牌内容开关和品牌内容开关。 |
| 2023年9月22日 | 产品优化 | 创意管理 | 我们已支持通过 [/creative/portfolio/create/](https://ads.tiktok.com/marketing_api/docs?id=1739091950439426)和 [/creative/portfolio/get/](https://ads.tiktok.com/marketing_api/docs?id=1739092113671170)的参数sticker_type中枚举值GIFTCODE创建新的创新互动样式:礼品码贴纸。此外,我们还通过[/ad/create/](1739953377508354.html)和[/creative/ads_preview/create/](1739403070695426.html) 中的card_id参数支持创建或预览带有礼品码贴纸的广告。欲了解在广告中使用礼品码贴纸的详细步骤,请查看[贴纸](1749019667506177.html)。 |
| 2023年9月22日 | 产品优化 | 推广系列管理 | 我们已支持通过[/adgroup/create/](1739499616346114.html)和[/campaign/spc/create/](1767334204047362.html)中的参数click_attribution_window,view_attribution_window,和attribution_event_count,在广告组层级指定归因设置。 |
| 2023年9月22日 | 产品优化 | 推广系列管理 | 我们已支持在单图片 Pangle 广告中使用分辨率为 640 x 100 像素,600 x 500 像素,或 640 x 200 像素的图片创建单图 Pangle 广告。若想了解如何创建单图片 Pangle 广告,请查看[创建单图片广告](1777633230937090.html)。 |
| 2023年9月22日 | 产品优化 | 目录管理 | 我们已支持新的商品库类型:娱乐商品库,您可通过[/catalog/create/](https://ads.tiktok.com/marketing_api/docs?id=1740306481704961)和[/catalog/get/](https://ads.tiktok.com/marketing_api/docs?id=1740315452868610)中catalog_type字段的枚举ENTERTAINMENT创建娱乐商品库,以及获取娱乐商品库的详情。 |
| 2023年9月22日 | 产品优化 | 目录管理 | 我们已支持通过 JSON 结构向娱乐商品库上传商品,请查看"[通过JSON结构上传商品-v1.2与v1.3版本对比](https://ads.tiktok.com/marketing_api/docs?id=1740497429681153#item-link-v1.2与v1.3版本对比)"小节了解对应的新增请求参数。此外,[/catalog/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1740564136678402) 同时新增了对应的返回参数,可用于获取已上传至娱乐商品库的商品的详情。欲了解通过 JSON 结构向娱乐商品库上传商品的详细步骤,请查看[通过 JSON 结构向不同类型的商品库上传商品](https://ads.tiktok.com/marketing_api/docs?id=1740496787164161)。 |
| 2023年9月22日 | 产品优化 | 目录管理 | 我们已支持使用[/catalog/product/file/](https://ads.tiktok.com/marketing_api/docs?id=1740496787164161)中提供的娱乐商品库的 CSV 更新源模版文件,向娱乐商品库上传商品。|
| 2023年9月18日 | 产品优化 | Creator Marketplace |我们已支持使用[/subscription/subscribe/](1739092028876801.html)请求中的video_id字段,以及subscribe_entity字段的枚举值TCM_SPARK_ADS订阅 TikTok Creator Marketplace Spark Ads 的授权状态。若想了解相关步骤,请查看[订阅 Webhook - 订阅 TCM 订单中视频的 Spark Ads 授权状态](https://business-api.tiktok.com/portal/docs?id=1738964126095362#item-link-%E8%AE%A2%E9%98%85%20TCM%20%E8%AE%A2%E5%8D%95%E4%B8%AD%E8%A7%86%E9%A2%91%E7%9A%84%20Spark%20Ads%20%E6%8E%88%E6%9D%83%E7%8A%B6%E6%80%81)。 |
|2023年9月15日| 产品优化 |报表管理|我们已上线新接口 [/campaign/spc/report/get/](1776454619412481.html),可用于在创意素材(包括视频和广告文案)层级生成智能效果推广系列报表。 |
| 2023年9月15日| 产品优化| 推广系列管理 |我们已支持通过广告接口([/ad/create/](1739953377508354.html), [/ad/update/](1739953405142018.html),和 [/ad/get/](1735735588640770.html))在商品来源为商品库的视频购物广告中追踪线下事件组(tracking_offline_event_set_ids)。 |
| 2023年9月15日 | 产品优化 | TikTok 商店 |我们已废弃了 Storefront 接口(/commerce/store/create/,/commerce/store/bind_to_catalog/,/commerce/window/update/,/commerce/store/get/,/commerce/store/product/get/) 。此外,还废弃了[/store/list/](1752267762718722.html)中的返回参数tiktok_account_binding_status以及请求和返回参数store_type的枚举值STOREFRONT。 |
|2023年9月8日|产品优化|报表管理|我们在[/report/integrated/get/](1740302848100353.html)接口中新增了enable_total_metrics字段,可用于获取竞价基础报表中请求指标的汇总数据。|
|2023年9月8日|文档优化|推广系列管理|我们新增了文档 [TikTok 广告管理平台的推广系列功能与 API 配置间的映射](1740673047618561.html),以阐明如何通过 API 集成实现 TikTok 广告管理平台上的推广系列相关功能。|
|2023年9月8日|文档优化|账号|我们新增了文档[管理自有 TikTok 视频上的评论](1776065099288577.html),概述了管理自有 TikTok 视频上的评论的工作流程和使用案例。|
|2023年9月1日|产品优化|报表管理|我们已支持在[/report/integrated/get/](1740302848100353.html)中使用请求参数bc_id以及参数report_type的枚举值BC创建同步商务中心报表。若想了解商务中心报表支持的维度、指标、筛选条件和使用案例,请查看[商务中心报表](1740302848100353.html)。|
|2023年9月1日|产品优化|商务中心|我们已上线新接口[/bc/advertiser/attribute/](1775752357139457.html),可用于获取获取商务中心内广告账户的币种和注册地区。|
|2023年9月1日|产品优化|TikTok商店|我们在[/store/list/](1752267762718722.html)中新增了返回参数store_code,可用于获取与广告账户绑定的 TikTok Shop 的商店代码。|
|2023年9月1日|产品优化|广告度量|我们已将[/pixel/create/](1740858779758593.html)中的请求参数pixel_category改为可选,并在[/pixel/create/](1740858779758593.html) 和 [/pixel/list/](1740858697598978.html) 的返回中新增了参数pixel_category。|
|2023年9月1日|产品优化|报表管理|我们已将[/report/task/create/](1740302766489602.html)接口中的QPM(分钟级调用限制)和QPD(天级调用限制)分别增加至40和4500。详情请参考[频控规则-接口特定频控限制](https://business-api.tiktok.com/portal/docs?id=1740029171730433#item-link-接口特定频控限制)。|
|2023年9月1日|产品优化|工具|我们在自动规则接口([/optimizer/rule/create/](1738767670852610.html),[/optimizer/rule/update/](1738769123170306.html),[/optimizer/rule/get/](1738768750822466.html),[/optimizer/rule/list/](https://business-api.tiktok.com/portal/docs?rid=26qk2yup7te&id=1738768861976578),[/optimizer/rule/result/list/](https://business-api.tiktok.com/portal/docs?rid=26qk2yup7te&id=1738769076676609))中的exec_time_type字段下新增了SPECIFIC_TIME_ACCURATE_ONCE`枚举值,从而支持自动规则在指定时间运行一次。|
## 2023年8月
```xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
|2023年8月25日|产品优化|推广系列管理|我们已支持通过广告组接口([/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114),[/adgroup/update/](1739586761631745.html) 和 [/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922))中的`search_result_enabled`字段管理广告组层级的搜索广告开关。|
|2023年8月25日|产品优化|推广系列管理|我们已将[/identity/create/](1740654203526146.html)中的`image_uri`字段从必填改为可选,从而简化自定义用户身份的创建。|
|2023年8月25日|产品优化|推广系列管理|我们为[/tool/targeting/search/](1761236883355649.html) 和 [/tool/targeting/info/](1761237001980929.html) 中的请求参数`objective_type`新增了枚举`PRODUCT_SALES`,从而支持在购物广告中使用美国邮政编码定向。|
|2023年8月25日|产品优化|推广系列管理|我们已支持在以商品库为商品来源的视频购物广告中使用[优化目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-优化目标)`TRAFFIC_LANDING_PAGE_VIEW`。若想了解创建此类广告的步骤,请查看[优化视频购物广告中的落地页浏览量](1775099621140482.html)。|
|2023年8月25日|产品优化|报表管理|我们在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1751443956638721)中新增了维度`search_terms`,可用于检索按搜索词分组的数据。若想了解此维度支持的指标,请查看[基础报表中维度所支持指标](https://ads.tiktok.com/marketing_api/docs?id=1759239462689793#item-link-search_terms支持的指标)。|
|2023年8月25日|产品优化|工具|我们已上线[否定关键词 API](1775103049049090.html),可用于创建、更新、删除、检索和下载否定关键词。|
|2023年8月25日|产品优化|受众管理|我们在[/dmp/custom_audience/rule/create/](1739940509849601.html) 接口为广告互动受众支持了六个新筛选值:`ENGAGEMENT APP PROFILE CLICK`,`ENGAGEMENT APP PROFILE IMPRESSION`,`ENGAGEMENT TIKTOK INSTANT CLICK`,`ENGAGEMENT TIKTOK INSTANT IMPRESSION`,`ENGAGEMENT COLLECTION ADS CLICK和 ENGAGEMENT COLLECTION ADS IMPRESSION`。详情请参考[枚举值 - 受众类型 - 筛选字段值](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-筛选字段值)。|
|2023年8月25日|产品优化|受众管理|我们已支持两个新受众类型:企业号受众和商店活动受众。在[/dmp/custom_audience/rule/create/](1739940509849601.html) 接口中通过`audience_type`请求字段的`BUSINESS_ACCOUNT`和`TIKTOK_SHOP`枚举值进行设置。详情请参考[枚举值 - 受众类型](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-受众类型)。|
|2023年8月25日|产品优化|受众管理|我们在[/dmp/custom_audience/lookalike/create/](1739940511844353.html)接口中废弃了`audience_sub_type` 字段的`REACH_FREQUENCY`枚举值。此外,我们不再允许[/dmp/custom_audience/update/](1739940572667906.html) 接口中将`audience_sub_type`设置为`REACH_FREQUENCY`,也不允许在[/adgroup/rf/create/](1738235338194945.html) 和[/adgroup/rf/update/](1738235402874882.html) 接口中使用相似受众。|
| 2023年8月18日 | 产品优化 | 推广系列管理 | 我们支持了新推广对象类型TikTok 私信,社交媒体应用的电话通话,可通过[广告组](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)层级`promotion_type`字段的枚举`LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`,`LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE`和 `LEAD_GEN_CLICK_TO_CALL` 以及`optimization_event`字段的枚举`MESSAGE`,`MESSAGE_ACTION`和`PHONE_CONFIRM`进行设置。若想了解如何创建使用这些推广对象类型的线索广告,请查看[创建线索广告-使用案例](https://business-api.tiktok.com/portal/docs?id=1739470742024193#item-link-使用案例)。|
| 2023年8月18日 | 产品优化 | 推广系列管理 | 我们在广告接口([/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354),[/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018),和 [/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770))中新增了参数`phone_number`,`phone_region_calling_code`,和`phone_region_code`,可用于指定推广对象类型为电话通话的线索广告中受众可拨打的电话号码。|
| 2023年8月18日 | 产品优化 | 报表管理 | 我们为[基础报表](1751443975608321.html)和[DSA报表](1751625296192514.html)中的筛选字段`promotion_type`新增了枚举值`LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`, `LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE`,和`LEAD_GEN_CLICK_TO_CALL`。这些枚举值还可在[/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922)的请求字段`promotion_type`中用于筛选推广对象类型。|
| 2023年8月18日 | 产品优化 | 工具 | 我们上线了接口 [/tool/url_validate/](1774487686007810.html),可用于获取 URL 的验证结果。|
| 2023年8月18日 | 产品优化 | 工具 | 我们上线了接口 [/tool/phone_region_code/](1774488637039618.html),可用于获取电话号码可用的地区名称,地区代码和区号。|
| 2023年8月18日 | 产品优化 | 推广系列管理 | 我们已支持在在推广网站的视频购物广告中使用深度链接。若想了解相关设置,请查看[在推广网站的视频购物广告中指定目标页面和深度链接设置](1774519076905985.html)。 |
| 2023年8月18日 | 产品优化 | 受众管理 | 相似受众的种子受众规模数量要求从 1,000 减至 100。欲了解详细信息,请参考[/dmp/custom_audience/lookalike/create/](1739940511844353.html)接口中的`source_audience_id`字段。 |
| 2023年8月18日 | 产品优化 | 推广系列管理 | 我们已将`frequency_schedule`的时长延长至30天,并将覆盖(Reach)广告的`frequency`最大限制提高至1000次。欲了解详细信息,请参考[/adgroup/create/](1739499616346114.html)和[/adgroup/update/](1739586761631745.html)接口中的`frequency`和`frequency_schedule`字段。|
| 2023年8月18日 | 产品优化 | 广告度量 |我们支持了 TikTok 应用事件 SDK 中的[限制数据使用](1774559446000642.html)功能。 |
|2023年8月14日 | 产品优化 | Creator Marketplace |我们在[/tcm/order/create/v2/](https://business-api.tiktok.com/portal/docs?id=1747285331289089)中新增了请求参数 `order_source`, `deliverables`, `video_number` 和 `default_spark_ads_requested_authorization_days` ,可用于设置订单来源,可交付内容(视频)的要求,请求的 Spark Ads 授权天数,同时废弃了请求参数`need_invite_link`。此外,还在此接口中新增返回参数 `remaining_orders` ,可用于获取某一推广系列代码中剩余的订单配额。 |
|2023年8月14日 | 产品优化 |Creator Marketplace |我们在[/tcm/order/get/v2/](https://business-api.tiktok.com/portal/docs?id=1755415792685057)中新增了请求参数`campaign_code` 和 `invite_link`,并为请求参数 `query_type` 新增了枚举值`CAMPAIGN_CODE`和`INVITE_LINK`,从而支持通过推广系列代码和邀请链接检索订单。此外,还在此接口中新增了返回参数 `video_ids` ,`invite_link` 和 `quota`,可用于获取订单的更多信息,包括订单的视频配额信息。 |
|2023年8月14日 | 产品优化 | Creator Marketplace |我们在[/tcm/video/audit_status/get/](https://business-api.tiktok.com/portal/docs?id=1739934913205249)中新增了请求参数 `v2_order_id` ,可用于获取工作流程 2.0 订单中视频的审核状态。 |
|2023年8月11日|产品优化|推广系列管理|我们增加了一个新的优化目标 [PAGE_VISIT](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-优化目标),帮助您把流量导向除简介页面外其他的 TikTok 内部落地页。同时,我们在 [/ad/create/](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1739953377508354) 接口中添加了新的请求参数 `tiktok_page_category`,可以指定需要推广的 TikTok 页面的类别。|
|2023年8月11日|产品优化|推广系列管理|我们在[/campaign/get/](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1739315828649986), [/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1739314558673922) and [/ad/get/](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1735735588640770)接口中新增了`optimization_goal`的筛选条件。若您想了解更多关于优化目标的枚举值的更新,请参考[枚举值-优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-优化目标)。|
|2023年8月11日|产品优化|报表管理|我们在基础报表中新增了`optimization_goal`的筛选条件,以及 `tt_playlist_visit` 和 `tt_playlist_visit_rate` 两个新的指标。详情请参考[支持的筛选条件](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553)和[支持的指标](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553)。 |
|2023年8月11日|产品优化|工具|我们上线了新接口[/search/region/](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1773644763581441),可用于获取基于广告主ID的可以投放广告的地域。|
|2023年8月11日|产品优化|推广系列管理|我们在[/file/music/upload/](https://ads.tiktok.com/marketing_api/docs?id=1740052650395650)和[/file/music/get/](https://ads.tiktok.com/marketing_api/docs?id=1740053909509122)接口的请求参数`music_scene`中新增了枚举值`CATALOG_CAROUSEL`,用于上传和筛选可在购物广告类型的轮播广告中可用的音乐。此外,在[/file/music/get/](https://ads.tiktok.com/marketing_api/docs?id=1740053909509122)中新增请求参数`catalog_id`, `catalog_authorized_bc_id`, `sku_ids`, `product_set_id`, `item_group_ids`和 `carousel_image_index` ,支持基于购物广告类型的轮播广告中要使用的商品库商品获取推荐音乐。|
|2023年8月11日|产品优化|商品库管理|我们在[/catalog/available_country/get/](https://ads.tiktok.com/marketing_api/docs?id=1740491257516034)接口的返回参数`region_codes`支持了`HU`的取值,该值可传入[/catalog/create/](https://ads.tiktok.com/marketing_api/docs?id=1740306481704961)接口用于创建定向国家为匈牙利的商品库。|
|2023年8月4日|产品优化|推广系列管理|我们已支持通过[/campaign/status/update/](https://ads.tiktok.com/marketing_api/docs?id=1739320994354178)(推荐接口)和 [/campaign/create/](https://ads.tiktok.com/marketing_api/docs?id=1739318962329602) 中的新增参数`postback_window_mode`,为暂停状态的专属推广系列设置SKAdNetwork(SKAN)4.0 归因窗口期。此外,还为[/campaign/get/](https://ads.tiktok.com/marketing_api/docs?id=1739315828649986)中的[`secondary_status`](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-推广系列状态)字段新增了枚举值`CAMPAIGN_STATUS_AWAITING_RELEASE`,可用于筛选正在回传数据的 SKAN 4.0 专属推广系列。若想了解SKAN 4.0 专属推广系列详情,请查看 [专属推广系列](https://ads.tiktok.com/marketing_api/docs?id=1740029173531649) 和 [专属推广系列配额优化](https://ads.tiktok.com/marketing_api/docs?id=1752256248260610)。|
|2023年8月4日|产品优化|推广系列管理|我们在[/campaign/status/update/](https://ads.tiktok.com/marketing_api/docs?id=1739320994354178)中新增了返回参数`campaign_list`,可用于获取已更新操作状态的推广系列的详情。|
|2023年8月4日|产品优化|推广系列管理|我们为字段[`min_android_version`](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-最低Android版本)增加枚举值`13.0`,同时为字段[`min_ios_version`](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-最低iOS版本)增加枚举值`16.0`,`16.1`,`16.2`,`16.3`和`16.4`,从而增强了[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114) 接口的设备定向功能。|
|2023年8月4日|产品优化|工具|我们上线了新接口[/tool/content_exclusion/get/](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1769738074686465),可用于获取[类别排除](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1739381752981505#item-link-类别排除)或[行业敏感内容控制](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1739381752981505#item-link-行业敏感内容控制)类型,避免其出现在您的广告附近。我们在[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1739499616346114)接口中新增了请求参数`category_exclusion_ids`和`vertical_sensitivity_id`,以支持类别排除或行业敏感内容控制。|
|2023年8月4日|产品优化|创意管理|我们上线了新接口[/creative/asset/share/](https://ads.tiktok.com/marketing_api/docs?id=1773192725768193&rid=nmsgaz98b9),可用于与其他广告主分享创意资产。|
|2023年8月4日|文档优化|受众管理|我们在[/dmp/custom_audience/file/upload/](https://ads.tiktok.com/marketing_api/docs?id=1739940567842818&rid=x55kyercfcr)接口中新增提示,只有最初用于上传受众文件的广告主 ID,才能随后使用返回的 `file_path` 来创建受众。|
|2023年8月4日|文档优化|创意管理|我们在[/report/ad_benchmark/get/](https://ads.tiktok.com/marketing_api/docs?id=1738824501176321)接口中新增提示,告知您通过本接口返回的所有数据都有30~48小时的延迟。 |
2023年7月
``xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2023年7月31日 | 产品优化 | Creator Marketplace | 我们在[/tcm/creator/authorized/](https://ads.tiktok.com/marketing_api/docs?id=1735827374196738)接口中新增了字段location,topics,creator_badges,six_seconds_views_rate,six_seconds_views_rate_benchmark,followers_growth_rate_benchmark,average_views_benchmark,completion_rate_benchmark,engagement_rate_benchmark,engagements_benchmark以及sponsored_video,以提供创作者的所在地、视频主题类别、徽章、视频表现等的详情。 |
|2023年7月28日|产品优化|推广系列管理|我们已将单个广告组中允许的广告最大数量从20提高至50。若想了解最新的广告层级结构,请查看[这里](https://ads.tiktok.com/marketing_api/docs?id=1739381193120770)。|
| 2023年7月31日 | 产品优化 | Creator Marketplace | 我们在[/tcm/creator/public/](https://business-api.tiktok.com/portal/docs?id=1737093073921025)接口中新增了返回参数bio,可用于获取 TikTok 创作者个人主页的个人简介部分显示的文本。|
|2023年7月28日|产品优化|推广系列管理|我们在[/split_test/result/get/](https://ads.tiktok.com/marketing_api/docs?id=1742666557045761)中新增了返回参数test_variable,start_time,end_time,和object_info,可用于返回更详细的拆分对比测试信息。|
|2023年7月28日|产品优化|推广系列管理|我们扩大了品牌安全功能的支持范围,支持了更多推广目标和市场。若想了解当前品牌安全功能支持的推广目标和市场,请查看[品牌安全](https://ads.tiktok.com/marketing_api/docs?id=1739381752981505)。|
|2023年7月28日|产品优化|推广系列管理|我们支持了新的应用推广类型<b>应用预注册</b>,使广告主能够引导用户在游戏发布前预注册。若想了解如何创建应用预注册广告,请查看[这里](https://ads.tiktok.com/marketing_api/docs?id=1772549012687873)。 |
|2023年7月28日|产品优化|推广系列管理|我们已支持在商品来源为商品库的视频购物广告中启用推广系列预算优化。若想了解如何创建此类广告,请查看[创建商品来源为商品库的视频购物广告](https://ads.tiktok.com/marketing_api/docs?id=1750361698613249)。|
|2023年7月28日|产品优化|工具|我们在[/optimizer/rule/create/](https://ads.tiktok.com/marketing_api/docs?id=1738767670852610) 和 [/optimizer/rule/update/](https://ads.tiktok.com/marketing_api/docs?id=1738769123170306)接口conditions参数下的subject_type字段增加了8个枚举值,以支持可以配置ROAS的自动规则。欲了解传入不同subject_type时values的校验规则,请参考[values字段的校验规则](https://ads.tiktok.com/marketing_api/docs?id=1738767670852610#item-link-values字段的校验规则)。 |
|2023年7月28日|产品优化|推广系列管理|我们在[/campaign/get/](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1739315828649986)接口中新增了请求参数is_smart_performance_campaign,支持按照是否为智能效果推广系列筛选。同时,在接口[/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1739314558673922)中新增了返回参数is_smart_performance_campaign。 |
|2023年7月28日|产品优化 |广告度量|我们上线了用于设置事件 API 的 Google 跟踪代码管理器模版。若想了解该模版详情及使用方法,请查看[通过服务器端 Google 跟踪代码管理器设置事件 API](https://business-api.tiktok.com/portal/docs?id=1772372080226305)。 |
|2023年7月21日|产品优化|报表管理|我们降低了使用定向维度country_code的[数据延迟](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1738864894606337)。|
|2023年7月21日|产品优化|商务中心|我们在[/bc/advertiser/create/](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1739939020318721)接口中新增了qualification_id请求参数,支持复用其他广告账户的资质信息。您可以通过 [/bc/advertiser/qualification/get/](https://ads.tiktok.com/marketing_api/docs?id=1770118680584194) 接口获取广告账户的资质信息。|
|2023年7月21日|产品优化|推广系列管理|我们已支持新优化目标转化线索量,可通过[广告组](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)层级的[optimization_goal](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-优化目标)和[secondary_optimization_event](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889#item-link-深度转化事件类型) 字段新增枚举值CONVERSION_LEADS设置。若想了解如何使用优化目标转化线索量,可查看[使用即时表单创建线索广告](https://ads.tiktok.com/marketing_api/docs?id=1739470742024193#item-link-使用即时表单创建线索广告)。|
|2023年7月21日|产品优化|推广系列管理|我们已支持通过[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114), [/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745),和 [/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922)接口的placements字段返回自动版位广告组实际支持的版位。 |
|2023年7月21日|产品优化|通用|我们已支持在授权过程中配置多达 10 个重定向 URL(包括 localhost),以提高您的工作效率。 |
|2023年7月21日|产品优化 | 广告度量 |我们上线了事件 2.0 接口 [/event/track/](1771101303285761.html),可用于报告单个应用事件、网站事件或线下事件,或批量报告多个应用事件、网站事件或线下事件。若想了解事件 API 2.0 的详情,请查看[事件 API 2.0](1771100779668482.html)。 |
|2023年7月21日|文档优化|SDK|基于现有集成数据,我们添加了[报表管理案例的SDK集成时间](https://ads.tiktok.com/marketing_api/docs?id=1764231376750658#item-link-为什么要使用API for Business SDK?)。|
|2023年7月21日|文档优化|报表管理|我们在[常见问题](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1738864850353154)页面的“数据不一致”版块新增了一个问题,解释在同步报表中使用<strong>兴趣定向</strong>维度时的数据不一致。|
|2023年7月21日|文档优化|受众管理|我们将“受众细分API”和“文件API”分别改名为“流式API”和“客户文件API”。同时,我们更新了[申请访问流式API](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1739566528222210#item-link-如何申请访问流式API)的流程。|
|2023年7月14日|产品优化|工具|我们支持了通过[/file/music/upload/](https://ads.tiktok.com/marketing_api/docs?id=1740052650395650)上传可用于轮播广告的自定义音乐,以及通过[/file/music/get/](https://ads.tiktok.com/marketing_api/docs?id=1740053909509122)中search_type字段新增的枚举值SEARCH_BY_SOURCE筛选用户上传的可用于轮播广告的自定义音乐。|
|2023年7月14日|产品优化|报表管理|我们支持了四个基于广告展示的转化率指标:conversion_rate_v2(在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553),[受众分析报表](https://ads.tiktok.com/marketing_api/docs?id=1751454162042882),[试玩素材报表](https://ads.tiktok.com/marketing_api/docs?id=1751617882108929)和 [DSA报表](https://ads.tiktok.com/marketing_api/docs?id=1751625293044737)中支持),real_time_conversion_rate_v2(在基础报表和受众分析报表中支持),skan_conversion_rate_v2和skan_click_time_conversion_rate_v2(在基础报表中支持)。|
|2023年7月14日|产品优化|商品库管理|我们上线了新接口 [/diagnostic/catalog/](https://ads.tiktok.com/marketing_api/docs?id=1771117232728066), [/diagnostic/catalog/product/task/create/](https://ads.tiktok.com/marketing_api/docs?id=1771117279175682)和[/diagnostic/catalog/product/task/get/](https://ads.tiktok.com/marketing_api/docs?id=1771117294731266),可用于获取商品库诊断信息。若想了解如何使用商品诊断功能,请查看[创建商品库并添加商品 - 获取商品库诊断信息](https://ads.tiktok.com/marketing_api/docs?id=1754263112945665#item-link-获取商品库诊断信息)。|
|2023年7月14日|产品优化|创意管理|我们为[/creative/ads_preview/create/](https://ads.tiktok.com/marketing_api/docs?id=1739403070695426)接口ADS_CREATION类型的广告预览功能新增了字段(is_smart_performance_campaign和image_ids)和枚举值(objective_type字段新增枚举APP_PROMOTION和WEB_CONVERSIONS,ad_format新增枚举CAROUSEL_ADS),从而与广告创建参数保持一致,并支持预览非视频购物类型的轮播广告和目标为应用推广和网站转化量的广告。|
|2023年7月14日|产品优化|线索|我们修改了获取欧洲经济区/瑞士/英国市场线索数据的基础URL或header。请查看[/page/lead/task/](https://ads.tiktok.com/marketing_api/docs?id=1739052936772610)和[/page/lead/task/download/](https://ads.tiktok.com/marketing_api/docs?id=1739053563877378),了解获取不同国家或地区线索数据对应的路径。|
|2023年7月14日|产品优化|受众管理|我们在[枚举值-加密类型](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1737174886619138#item-link-加密类型)废弃枚举值first_normal。 |
|2023年7月14日|产品优化|报表管理|我们改进了验证逻辑,更新了[常见问题](https://ads.tiktok.com/marketing_api/docs?id=1738864850353154)。如果请求中的service_type与您的广告主账户类型不匹配,报表将返回 200 的成功代码,但数据列表为空([])。 |
|2023年7月14日|产品优化|报表管理|自7月6日起,为提供更好的用户体验,以下指标的名称已更新:点击量更名为点击量(目标页面)、CPC 更名为 CPC(目标页面)、CTR更名为CTR(目标页面)、互动总数更名为点击量(全部)、互动率更名为CTR(全部)。请注意,该更新只体现在异步报表的列名,同步报表不受影响。 |
|2023年7月7日 | 产品优化 | 报表管理 | 我们在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1751443956638721)中新增了维度skan_postback_sequence`,可用于获取按 SKAN 回传次序分组的 SKAN 指标数据。 |
|2023年7月7日| 文档优化|通用|我们将“术语解释”页面标题改为“概念解释”,并增添了一些常见概念的定义,帮助新近接触我们API文档的开发者了解网站中常出现的概念。|
|2023年7月3日 | 产品优化 | Creator Marketplace | 我们上线了用于获取和更新访问令牌的接口/tt_user/oauth2/token/和/tt_user/oauth2/refresh_token/。若想了解如何这些接口,请查看获取创作者授权(新)。|
|2023年7月3日| 文档优化| Creator Marketplace | 我们在获取创作者授权(新) - 第 1 步:与创作者分享授权 URL中新增了TikTok 账户持有人重定向 URL v2的验证规则。|
## 2023年6月
```xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2023年6月30日 | 产品优化 | 工具 | 我们上线了 [/tool/vbo_status/](https://ads.tiktok.com/marketing_api/docs?id=1770016073586753) 接口,可用于检查设置是否支持价值优化。若想了解如何启用价值优化,请查看[开启价值优化](https://ads.tiktok.com/marketing_api/docs?id=1770019181843458)。 |
| 2023年6月30日 | 产品优化 | 商品库管理 | 我们支持了新的商品库类型:目的地商品库,您可通过[/catalog/create/](https://ads.tiktok.com/marketing_api/docs?id=1740306481704961)和[/catalog/get/](https://ads.tiktok.com/marketing_api/docs?id=1740315452868610)中 `catalog_type` 字段的枚举 `DESTINATION`创建目的地商品库,以及获取目的地商品库的详情。 |
| 2023年6月30日 | 产品优化 | 商品库管理 | 我们支持了通过JSON结构向目的地商品库上传商品,请查看[通过JSON结构上传商品-v1.2与v1.3版本对比](https://ads.tiktok.com/marketing_api/docs?id=1740497429681153#item-link-v1.2与v1.3版本对比)小节了解对应的新增请求参数。此外,[/catalog/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1740564136678402) 同时新增了对应的返回参数,可用于获取已上传至目的地商品库的商品的详情。欲了解通过JSON结构向目的地商品库上传商品的详细步骤,请查看[通过JSON结构向不同类型的商品库上传商品](https://ads.tiktok.com/marketing_api/docs?id=1766862002851842)。 |
| 2023年6月30日 | 产品优化 | 商品库管理 | 我们在[/catalog/product/file/](https://ads.tiktok.com/marketing_api/docs?id=1740496787164161)文档中提供了新的商品库更新源模版,支持您使用CSV文件向目的地商品库上传商品。 |
| 2023年6月30日 | 产品优化 | 推广系列管理 | 我们已在[SDK]([SDK](https://ads.tiktok.com/marketing_api/docs?rid=7xusz43oh3h&id=1764231376750658)中加入ACO接口。 |
|2023年6月26日| 产品优化 | 账号 |账号 API 中现已支持评论 webhook 事件[comment.update](https://ads.tiktok.com/marketing_api/docs?id=1759979365064706#item-link-comment.update)。如需为您的应用配置 webhook 回调 URL,请提交[账号 API 工单](https://ads.tiktok.com/athena/requester/boards?identify_key=b25033ef7782d41050cbac74f751d547e9d8ad35a39a541a0f0efbbd51fe722f)。 |
|2023年6月26日| 产品优化 | 账号 |我们上线了四个用于验证 URL 资源所有权的接口:[/business/property/add/](https://ads.tiktok.com/marketing_api/docs?id=1769325280876545), [/business/property/verify/](https://ads.tiktok.com/marketing_api/docs?id=1769325308162050),[/business/property/delete/](https://ads.tiktok.com/marketing_api/docs?id=1769325351919617),和[/business/property/list/](https://ads.tiktok.com/marketing_api/docs?id=1769325368603650)。若想了解如何进行所有权验证,请查看[管理 URL 资源](https://ads.tiktok.com/marketing_api/docs?id=1769324038780930)。 |
|2023年6月26日| 产品优化 | 账号 |我们上线了用于获取和更新访问令牌的接口 `/tt_user/oauth2/token/`和`/tt_user/oauth2/refresh_token/` 。若想了解这些接口,请查看[账号 - 获取访问令牌2.0](https://ads.tiktok.com/marketing_api/docs?id=1738084387220481#item-link-获取访问令牌2.0)。 |
|2023年6月26日| 产品优化 | 账号 |我们更新了[/business/get/](https://ads.tiktok.com/marketing_api/docs?id=1762228399168514)接口中部分指标所需的权限。若想了解详细变化,请查看[字段所需权限更改日志](https://ads.tiktok.com/marketing_api/docs?id=1762228399168514#item-link-字段所需权限更改日志)。|
|2023年6月26日| 文档优化 | 账号|我们在[授权 - 流程2.0](https://ads.tiktok.com/marketing_api/docs?id=1738083939371009#item-link-流程2.0)中新增了<strong>TikTok 账户持有人重定向 URL v2</strong>的验证规则。 |
| 2023年6月16日 | 产品优化 |推广系列管理 |我们已支持创建和预览视频购物类型的轮播广告。若您想了解如何进行相关广告创建和预览,请查看[创建轮播广告-创建视频购物类型的轮播广告的步骤](https://ads.tiktok.com/marketing_api/docs?id=1766217791987713#item-link-创建视频购物类型的轮播广告的步骤)和[创建商品来源为商品库的视频购物广告](https://ads.tiktok.com/marketing_api/docs?id=1750361698613249)。 |
| 2023年6月16日 | 产品优化 |推广系列管理 |我们上线了新接口[/adgroup/quota/](https://ads.tiktok.com/marketing_api/docs?id=1768463039162369),若广告主投放中的竞价广告组存在动态配额限制,可使用此接口进行查询。 |
| 2023年6月16日 | 产品优化 |报表管理 |我们在[受众报表](https://ads.tiktok.com/marketing_api/docs?id=1751454103714818)中支持了 `province_id` 和一个ID维度(可选)以及一个时间维度(可选)共用的维度组合。 |
| 2023年6月16日 | 产品优化 | 广告度量|我们在[/app/info/](https://ads.tiktok.com/marketing_api/docs?id=1740859272887297)和[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786)接口中新增了返回参数 `self_attribution_enabled` ,用于区分应用是否开启了自归因。若应用已开启自归因,则无需在[/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354), [/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018), [/ad/aco/create/](https://ads.tiktok.com/marketing_api/docs?id=1739473063234626), [/ad/aco/update/](https://ads.tiktok.com/marketing_api/docs?id=1739473077112833), [/campaign/spc/create/](https://ads.tiktok.com/marketing_api/docs?id=1767334204047362) 和 [/campaign/spc/update/](https://ads.tiktok.com/marketing_api/docs?id=1767334250066945)中传入 `impression_tracking_url` 和 `click_tracking_url` 。|
| 2023年6月16日 | 产品优化 | 创意管理 |[创意素材表现数据 API ](https://ads.tiktok.com/marketing_api/docs?id=1738824477276162)和[一键优化 API ](https://ads.tiktok.com/marketing_api/docs?id=1739355078757377)现已全量发布。 |
| 2023年6月16日 | 文档优化 |通用 |我们在<strong>快速入门</strong>下新增了[预估集成时间](https://ads.tiktok.com/marketing_api/docs?id=1768657234981890)文档,帮助开发者了解一些常见 API 集成案例预估的所需集成时间。 |
| 2023年6月12日 | 产品优化 | Creator Marketplace |我们在[/tcm/creator/discover/](https://ads.tiktok.com/marketing_api/docs?id=1739935079726082)中新增了请求参数 `creator_categories` ,用于根据创作者类别筛选创作者。 |
| 2023年6月9日 | 产品优化 |推广系列管理 |我们支持通过[/campaign/spc/create/](https://ads.tiktok.com/marketing_api/docs?id=1767334204047362)、[/campaign/spc/update/](https://ads.tiktok.com/marketing_api/docs?id=1767334250066945)、 [/campaign/spc/get/](https://ads.tiktok.com/marketing_api/docs?id=1767334299811842)管理智能效果推广系列。欲了解创建智能效果推广系列的详细步骤,请参考[创建智能效果推广系列](https://ads.tiktok.com/marketing_api/docs?id=1768006268820546)。 |
| 2023年6月9日 | 产品优化 |推广系列管理 |我们在[/ad/aco/create/](https://ads.tiktok.com/marketing_api/docs?id=1739473063234626和[/ad/aco/update/](https://ads.tiktok.com/marketing_api/docs?id=1739473077112833)接口中新增了请求参数 `card_list` 和 `card_id` ,在[/ad/aco/create/](https://ads.tiktok.com/marketing_api/docs?id=1739473063234626)、[/ad/aco/update/](https://ads.tiktok.com/marketing_api/docs?id=1739473077112833) 、 [/ad/aco/get/](https://ads.tiktok.com/marketing_api/docs?id=1739473020978177)接口中新增了返回参数 `card_list` 和 `card_id` 。 |
| 2023年6月9日 | 产品优化 |推广系列管理 |我们在[/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922), [基础报表](https://ads.tiktok.com/marketing_api/docs?id=1751443975608321),和[受众报表](https://ads.tiktok.com/marketing_api/docs?id=1751454172429314)中新增了筛选字段 `bid_strategy` ,用于筛选广告组的竞价策略。 |
| 2023年6月9日 | 产品优化 |报表管理 |我们在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553)和[受众报表](https://ads.tiktok.com/marketing_api/docs?id=1751454162042882)中新增了属性指标 `billing_event` ,用于获取广告对应的计费点数据。 |
| 2023年6月9日 | 文档优化 |通用 |我们在[返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)中新增了常见返回码的推荐报错处理方式,报错信息示例,以及主要报错原因,帮助您对API调用进行故障排除。 |
| 2023年6月9日 | 文档优化 |报表管理 |我们在[报表-常见问题](https://ads.tiktok.com/marketing_api/docs?id=1738864850353154#item-link-数据不一致)中新增了问答,解释了报表数据不一致问题的可能原因。 |
|2023年6月5日 | 产品优化 | 账号|我们在[/business/get/](https://ads.tiktok.com/marketing_api/docs?id=1762228399168514)中新增了返回参数 `is_business_account` ,用于区分 TikTok 账号是否为TikTok 企业号。 |
| 2023年6月2日 | 产品优化 | 通用 | API for Business SDK已进入公开测试阶段。您可以通过[Github](https://github.com/tiktok/tiktok-business-api-sdk)链接直接下载SDK。欲了解SDK支持的编程语言和接口,请点击[这里](https://ads.tiktok.com/marketing_api/docs?rid=bk7ondyds2o&id=1764231376750658)。 |
| 2023年6月2日 | 产品优化 |推广系列管理 | 我们支持了<strong>智能创意</strong>广告的创建。欲了解创建智能创意广告的具体步骤,请查看[智能创意](https://ads.tiktok.com/marketing_api/docs?id=1767322784934914)。 |
| 2023年6月2日 | 产品优化 |报表管理| 我们在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1738864915188737)和[受众报表](https://ads.tiktok.com/marketing_api/docs?id=1738864928947201)中新增了筛选条件`creative_material_mode`和基础数据指标`is_aco`和`is_smart_creative`,用于筛选和区分智能创意广告。 |
| 2023年6月2日 | 产品优化 |报表管理 | 我们在基础报表中新增了50个离线事件指标。欲了解目前支持的离线事件指标,请查看[基础报表-线下事件指标](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553#item-link-离线事件指标)小节。
| 2023年6月2日 | 产品优化 |受众管理 | 我们在 [/dmp/custom_audience/create/](https://ads.tiktok.com/marketing_api/docs?id=1739940570793985)和[/dmp/custom_audience/rule/create/](https://ads.tiktok.com/marketing_api/docs?id=1739940509849601)中新增了请求参数`retention_in_days`,支持为通过文件或规则创建的受众自定义留存天数。 |
| 2023年6月2日 | 产品优化 | 广告度量 | 我们在事件报告接口中([/app/track/](https://ads.tiktok.com/marketing_api/docs?id=1740859196043266),[/app/batch/](https://ads.tiktok.com/marketing_api/docs?id=1740859218541569), [/pixel/track/](https://ads.tiktok.com/marketing_api/docs?id=1740858531237890), [/pixel/batch/](https://ads.tiktok.com/marketing_api/docs?id=1740858565852225),[/offline/track/](https://ads.tiktok.com/marketing_api/docs?id=1758428013689857),[/offline/batch/](https://ads.tiktok.com/marketing_api/docs?id=1758428053652482))的`properties`对象下新增了`brand`字段,支持报告事件时传入品牌相关信息。 |
| 2023年6月2日 | 文档优化 | 通用 |基于开发者反馈,我们在推广系列管理的“用户指南”下新增了[常见问题](https://ads.tiktok.com/marketing_api/docs?id=1767309272869890)文档。 |
```
## 2023年5月
```xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2023年5月26日|产品优化 | 商品库管理 |我们支持了新的商品库类型:酒店商品库和航班商品库,您可通过[/catalog/create/](https://ads.tiktok.com/marketing_api/docs?id=1740306481704961)和[/catalog/get/](https://ads.tiktok.com/marketing_api/docs?id=1740315452868610)中 `catalog_type` 字段的枚举 `HOTEL` 和 `FLIGHT` 创建酒店商品库和航班商品库,以及获取这些类型的商品库的详情。 |
| 2023年5月26日|产品优化 | 商品库管理 |我们支持了通过JSON结构向酒店商品库和航班商品库上传商品,请查看[通过JSON结构上传商品-v1.2与v1.3版本对比](https://ads.tiktok.com/marketing_api/docs?id=1740497429681153)小节了解对应的新增请求参数。此外,[/catalog/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1740564136678402)同时新增了对应的返回参数,可用于获取已上传至酒店商品库和航班商品库的商品的详情。欲了解通过JSON结构向酒店商品库和航班商品库上传商品的详细步骤,请查看[通过JSON结构向不同类型的商品库上传商品](https://ads.tiktok.com/marketing_api/docs?id=1766862002851842)。为使您灵活选择上传商品的方式,我们还在[/catalog/product/file/](https://ads.tiktok.com/marketing_api/docs?id=1740496787164161)文档中提供了新的商品库更新源模版,支持您使用CSV文件向酒店商品库和航班商品库上传商品。 |
| 2023年5月26日|产品优化 |创意管理 |我们上线了新接口[/creative/portfolio/list/](https://ads.tiktok.com/marketing_api/docs?id=1766324010279938),可用于获取广告账户下除行动引导文案素材包外所有类型的创意素材包信息。 |
| 2023年5月26日|产品优化 | 广告度量 |我们已支持向[/app/track/](https://ads.tiktok.com/marketing_api/docs?id=1740859196043266)接口的 `idfa` 和 `gaid` 参数传入SHA256加密的IDFA (广告主标识符)和GAID(谷歌广告ID),增强了事件追踪能力。 |
| 2023年5月26日 | 文档优化|通用|基于开发者反馈,我们在报表管理下的[常见问题](https://ads.tiktok.com/marketing_api/docs? id=1738864850353154)文档新增了有关<strong> “数据不一致”</strong>和<strong> “维度和指标”</strong>的问题。 |
| 2023年5月19日|产品优化|推广系列管理 | 我们发布了用于TikTok版位的新广告样式:轮播广告。欲了解创建轮播广告的步骤,请查看[这里](https://ads.tiktok.com/marketing_api/docs?id=1766217791987713)。为支持此样式,我们在广告接口([/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354),[/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018),和[/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770))中新增了参数`music_id`以及参数`ad_format`的枚举值`CAROUSEL_ADS`。此外, 我们在广告审核接口([/adgroup/review_info/](https://ads.tiktok.com/marketing_api/docs?id=1740554277061634),[/ad/review_info/](https://ads.tiktok.com/marketing_api/docs?id=1740559669226498))中新增了返回参数`carousel_music_content` 和`music_id`,以及返回参数`content_type`的枚举值`MODE_CAROUSEL_MUSIC`,可以用于获取轮播广告中音乐的审核结果。|
| 2023年5月19日|产品优化|推广系列管理 | 我们在全球化应用组合(`PLACEMENT_GLOBAL_APP_BUNDLE`)版位中新增了应用Capcut 和 Fizzo。此外,此版位的可投放国家列表中新增了越南、菲律宾、泰国、马来西亚、墨西哥、沙特阿拉伯和日本。欲了解全球化应用组合版位的详情,请查看[版位](https://ads.tiktok.com/marketing_api/docs?id=1745292441739265)和[枚举值-版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
| 2023年5月19日|产品优化|创意管理 | 我们在[/file/music/upload/](https://ads.tiktok.com/marketing_api/docs?id=1740052650395650)中新增了请求参数`music_scene`,`material_id` 和`material_action` ,优化了该接口的音乐管理功能。此外,[/file/music/get/](https://ads.tiktok.com/marketing_api/docs?id=1740053909509122)中新增请求参数`music_scene`,`search_type`,`keyword`,和`image_urls`,可搜索可用于轮播广告的音乐。我们还在[/file/music/upload/](https://ads.tiktok.com/marketing_api/docs?id=1740052650395650)和[/file/music/get/](https://ads.tiktok.com/marketing_api/docs?id=1740053909509122)中新增了返回参数`author`,`liked`,和`cover_url`,可用于获取可用于轮播广告的音乐的详情。另外还在[/file/image/ad/search/](https://ads.tiktok.com/marketing_api/docs?id=1740052016789506),[/file/image/ad/info/](1740051721711618.html)和[/file/image/ad/upload/](1739067433456642.html)中新增了返回参数 `is_carousel_usable`,可用于识别可用于轮播广告的候选图片。|
| 2023年5月19日|产品优化|报表管理 |我们在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1738864915188737)中新增了以下功能:[维度](https://ads.tiktok.com/marketing_api/docs?id=1751443956638721) `image_id` ,四个[指标](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553)(包括属性指标`image_mode`和互动数据指标`single_image_impressions`,`single_image_impression_rate`和`single_image_ctr`)以及[筛选条件](https://ads.tiktok.com/marketing_api/docs?id=1751443975608321)`image_mode` 。 |
| 2023年5月19日|文档优化| 广告度量| 我们新增了[外部 ID](https://ads.tiktok.com/marketing_api/docs?id=1765942670613506)章节,介绍如何通过Pixel SDK或事件API传入外部ID(`external_id`)。|
| 2023年5月19日|文档优化|通用 |基于开发者反馈,我们分别改进了[Marketing API](https://ads.tiktok.com/marketing_api/docs?id=1766037914914818)、[Accounts API](https://ads.tiktok.com/marketing_api/docs?id=1766042058952706)、[Creator Marketplace API](https://ads.tiktok.com/marketing_api/docs?id=1740027824155649)的OAuth授权的“常见问题”文档。 |
| 2023年5月15日 | 产品优化 | 账号 |我们上线了新接口[/tt_user/token_info/get/](https://ads.tiktok.com/marketing_api/docs?id=1765927978092545),可用于通过访问令牌获取TikTok用户已授予的TikTok账户权限范围。 |
| 2023年5月15日 | 产品优化 | Creator Marketplace | 我们上线了新接口[/tt_user/token_info/get/](https://ads.tiktok.com/marketing_api/docs?id=1765926674648065),可用于通过访问令牌获取已加入TTCM (TikTok Creator Marketplace) 的创作者授予的TikTok账户权限范围。 |
| 2023年5月12日| 产品优化|推广系列管理 | 我们在广告接口([/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354), [/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018), [/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770))和ACO接口([/ad/aco/create/](https://ads.tiktok.com/marketing_api/docs?id=1739473063234626), [/ad/aco/update/](https://ads.tiktok.com/marketing_api/docs?id=1739473077112833),[/ad/aco/get/](https://ads.tiktok.com/marketing_api/docs?id=1739473020978177))中新增了`tracking_offline_event_set_ids`参数,支持监测和衡量浏览广告或与之互动的用户的线下活动。|
| 2023年5月12日| 产品优化|广告度量 |我们上线了线下事件的新接口[/offline/update/](https://ads.tiktok.com/marketing_api/docs?id=1765596741157889), [/offline/delete/](https://ads.tiktok.com/marketing_api/docs?id=1765596790860802),和 [/offline/get/](https://ads.tiktok.com/marketing_api/docs?id=1765596808589313),用于管理线下事件组。欲了解如何管理线下事件组,请查看[快速入门](https://ads.tiktok.com/marketing_api/docs?id=1758051319816193)。|
| 2023年5月12日| 产品优化|创意管理 |我们在[/report/video_performance/get/](https://ads.tiktok.com/marketing_api/docs?id=1738825259075586)中新增了请求参数`report_type`, `material_ids`,`video_ids`,`start_time`,`end_time`,和`lifetime`,可用于生成视频素材的视频洞察报表及指定数据的时间区间。同时在视频洞察报表中支持了关键帧指标`clicks`,`conversions`,`drop_off`,`retain`,`ctr`和`cvr`。欲了解视频洞察,请查看[创意素材表现数据-视频洞察数据](https://ads.tiktok.com/marketing_api/docs?id=1749023065231362)。|
| 2023年5月8日| 产品优化|Creator Marketplace |我们在[/tcm/report/get/v2/](https://ads.tiktok.com/marketing_api/docs?id=1752366000747522)中新增了指标`engagement_rate_benchmark_p25`,`engagement_rate_benchmark_p50`,`video_complete_rate_benchmark_p25`,`video_complete_rate_benchmark_p50`,`video_view_retention`,`most_popular_country_state_distribution`,和`audience_interest_distribution`,可用于获取视频互动率和视频完播率的基准数据,视频留存率情况,州/省级别地域的分布信息,以及受众兴趣分布信息。|
| 2023年5月8日| 产品优化|账号 |我们在[/business/comment/list/](https://ads.tiktok.com/marketing_api/docs?id=1760232109619202)接口新增了请求参数`comment_ids`和`include_replies`,可用于指定想获取详情的评论以及是否返回第一层级评论的回复,同时新增返回参数`parent_comment_id`和`reply_list`,将返回评论ID及评论回复的详情。|
```
## 2023年4月
```xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2023年4月28日| 产品优化|推广系列管理 |我们在[/campaign/create/](https://ads.tiktok.com/marketing_api/docs?id=1739318962329602)中新增了可选请求参数`campaign_product_source`,可用于为[购物广告](https://ads.tiktok.com/marketing_api/docs?id=1741942179356738)在推广系列层级设置商品来源,同时在[/campaign/get/](https://ads.tiktok.com/marketing_api/docs?id=1739315828649986)中新增请求和返回参数 `campaign_product_source`,支持筛选推广系列的商品来源。 |
| 2023年4月28日| 产品优化|推广系列管理 | 我们在[/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770)中新增了请求参数 `destination`,用于筛选广告的目标页类型。 |
| 2023年4月28日| 产品优化|线索管理 |我们将用于获取欧洲经济区/瑞士/英国地区线索数据的基础URL从`https://business-api.tiktok.com/open_api/`变更为`https://ads.us.tiktok.com/open_api/`。请查看[/page/lead/task/](https://ads.tiktok.com/marketing_api/docs?id=1739052936772610)和[/page/lead/task/download/](https://ads.tiktok.com/marketing_api/docs?id=1739053563877378),了解获取不同国家或地区线索数据对应的路径。 |
| 2023年4月28日| 产品优化|线索管理 |我们在[/page/get/](https://ads.tiktok.com/marketing_api/docs?id=1737719918220290)中新增了返回参数 `destination_urls`,可用于获取自定义页面、即时表单(线索表单)和应用介绍页的目标URL。 |
| 2023年4月28日| 产品优化|报表管理 |我们在[/report/task/create/](https://ads.tiktok.com/marketing_api/docs?id=1740302766489602)中新增了请求参数 `enable_report_title_translation` 和 `advertiser_ids` 字段。前者用于在异步基础报表和异步受众分析报表中关闭报表标题的翻译,后者可用于同时为多个广告主ID请求异步基础报表或异步受众分析报表。 |
| 2023年4月28日| 产品优化|报表管理 |我们在同步[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1751443975608321)和同步[受众分析报表](https://ads.tiktok.com/marketing_api/docs?id=1751454172429314)中新增了筛选条件 `destination`,用于筛选广告的目标页类型。同时在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1751443975608321)中新增筛选条件 `campaign_product_source` ,用于筛选[购物广告](https://ads.tiktok.com/marketing_api/docs?id=1741942179356738)推广系列层级的商品来源。 |
| 2023年4月28日| 产品优化|工具 |我们在[/tool/action_category/](https://ads.tiktok.com/marketing_api/docs?id=1737166752522241)中新增了请求参数`language`,可用于指定返回的行为分类名称的语言。 |
| 2023年4月21日| 产品优化|推广系列管理 |我们在[/campaign/get/](https://ads.tiktok.com/marketing_api/docs?id=1739315828649986),[/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922),[/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770)和[/aco/get/](https://ads.tiktok.com/marketing_api/docs?id=1739473020978177)接口中新增了请求参数`exclude_field_types_in_response`,支持移除返回中值为null的字段。 |
| 2023年4月21日| 产品优化|报表管理 |我们在同步[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553)中支持了自定义app事件指标及自定义页面事件。此前,这些指标仅可在异步基础报表中使用。 |
| 2023年4月14日| 产品优化|推广系列管理 |我们在广告组接口([/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114), [/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745),[/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922), [/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353))新增了`isp_ids`参数,可用于互联网服务提供商定向。您可使用新接口[/tool/targeting/list/](https://ads.tiktok.com/marketing_api/docs?id=1762962378261506)获取可定向的互联网服务提供商ID标签,或使用[/tool/targeting/info/](https://ads.tiktok.com/marketing_api/docs?id=1761237001980929)通过请求参数`scene`的新枚举值`ISP`获取互联网服务提供商定向标签的信息。 |
| 2023年4月14日| 产品优化| 工具 |我们将预算效果预估和出价效果预估的效果预估结果更新为采用推荐预算或出价<strong>当天</strong>的广告组表现预估数据,预算效果预估的推荐预算调整比例更新为 <strong>-20%</strong>~50%,出价效果预估的推荐出价调整比例更新为<strong>-10%</strong>~30%。请查看[获取推荐预算](https://ads.tiktok.com/marketing_api/docs?id=1746463333984258)和[获取推荐出价](https://ads.tiktok.com/marketing_api/docs?id=1746463347473410),了解如何使用预算效果预估和出价效果预估。 |
| 2023年4月10日| 产品优化|Creator Marketplace|我们在[/tcm/creator/discover/](https://ads.tiktok.com/marketing_api/docs?id=1739935079726082)接口中新增了`languages` ,`max_campaign_count`,`min_campaign_count`,`has_responsive_badge` 和`query` 字段,支持根据语言,完成推广系列数量以及响应及时性筛选创作者,以及支持搜索创作者或视频。|
| 2023年4月7日| 产品优化| 广告度量| 我们在[/app/optimization_event/](https://ads.tiktok.com/marketing_api/docs?id=1740859338750977)接口中新增了请求参数`placement_type`,支持筛选支持自动版位的优化事件,并将`placement`字段从必填更新为条件必填。|
| 2023年4月7日| 文档优化|报表管理|我们在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1759239462689793),[受众分析报表](https://ads.tiktok.com/marketing_api/docs?id=1762404685488130),[试玩素材报表](https://ads.tiktok.com/marketing_api/docs?id=1762405483224065)和[合约广告报表](https://ads.tiktok.com/marketing_api/docs?id=1762405922636802)文档中新增了`country_code`维度支持的指标参照表。|
```
## 2023年3月
```xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2023年3月31日| 产品优化 | 推广系列管理 |我们在广告组接口([/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114), [/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745), [/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922), [/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353))新增了`zipcode_ids`参数,可用于邮政编码定向。邮政编码定向目前仅支持定向美国的地域,您可使用新接口[/tool/targeting/search/](https://ads.tiktok.com/marketing_api/docs?id=1761236883355649)通过关键词搜索邮政编码ID,或使用[/tool/targeting/info/](https://ads.tiktok.com/marketing_api/docs?id=1761237001980929)通过邮政编码ID获取邮政编码定向标签的信息。 |
| 2023年3月31日| 产品优化 |推广系列管理|我们新增了广告组二级状态枚举`ADGROUP_STATUS_ADGROUP_QUOTA_LIMIT`和广告二级状态枚举`AD_STATUS_AD_QUOTA_LIMIT`,可通过[/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922)或[/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770)的`secondary_status`字段返回。请查看[枚举值](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)和[一级状态下所支持的二级状态](https://ads.tiktok.com/marketing_api/docs?id=1757239620352002)了解新增的二级状态枚举的详细描述。|
| 2023年3月31日| 产品优化 |工具 |我们新增了地域ID,可用于定向更多英国(`CITY` 和 `DISTRICT` 层级), 德国(`CITY` 层级)、法国(`CITY`和 `DISTRICT` 层级)、美国(`CITY` 和 `DISTRICT` 层级)、菲律宾( `PROVINCE` 和 `CITY` 层级)、加拿大(`CITY` 层级)的地区。您可调用[/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713)查看能否定向这些新增的地域。|
|2023年3月23日|产品优化|推广系列管理| 我们在广告API([/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354),[/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018),[/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770))和ACO API([/ad/aco/create/](https://ads.tiktok.com/marketing_api/docs?id=1739473063234626),[/ad/aco/update/](https://ads.tiktok.com/marketing_api/docs?id=1739473077112833),[/ad/aco/get/](https://ads.tiktok.com/marketing_api/docs?id=1739473020978177))中新增了`tracking_app_id`参数,支持追踪站外应用事件。|
|2023年3月23日|产品优化|推广系列管理|我们在[/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745)中新增了请求参数`share_disabled`,支持在广告组层级更新是否允许将广告分享至第三方平台的设置。 |
|2023年3月23日|文档优化|报表管理| 我们更新了[报表数据延迟](https://ads.tiktok.com/marketing_api/docs?id=1738864894606337)文档,增加了合约广告报表的延迟数据。|
|2023年3月23日|功能废弃|推广系列管理|我们已废弃覆盖和频次广告的兴趣关键词定向功能。您已无法在[覆盖和频次广告API](https://ads.tiktok.com/marketing_api/docs?id=1738235311704065)中使用`interest_category_ids`参数。 |
|2023年3月17日|产品优化|工具|我们在[/tool/interest_keyword/get/](https://ads.tiktok.com/marketing_api/docs?id=1737180852720642)中新增了请求参数`filtering`和`audience_type`,使您能够通过ID获取购买意向关键词的信息。|
|2023年3月17日|文档优化|推广系列管理|我们在[品牌安全](https://ads.tiktok.com/marketing_api/docs?id=1739381752981505)和[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)文档中新增了说明,您可以通过`brand_safety_partner`字段的枚举值`OPEN_SLATE`将投前第三方品牌安全合作伙伴设置为<strong>DoubleVerify</strong>。 |
|2023年3月17日|文档优化|报表管理|我们更新了[报表数据延迟](https://ads.tiktok.com/marketing_api/docs?id=1738864894606337)文档,增加了试玩素材报表和DSA报表的延迟数据。基础报表中`voucher_spend`和 `cash_spend`指标目前数据延迟时间更新为11小时。 |
|2023年3月17日|更新预告|推广系列管理|我们将于2023年6月废弃推广目标`RF_TRAFFIC` 和`RF_VIDEO_VIEW`,并在[推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737585562434561)和[枚举值](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)文档中将这些目标标示为即将废弃。 |
|2023年3月17日|更新预告|推广系列管理| 我们将于2023年3月24日废弃覆盖和频次广告的兴趣关键词定向功能。您将无法在[覆盖和频次广告API](https://ads.tiktok.com/marketing_api/docs?id=1738235311704065)中使用`interest_category_ids`参数。|
|2023年3月13日 |产品优化|账号| 我们新增了四个webhook事件<code>post.publish.failed</code>,<code>post.publish.complete</code>,<code>post.publish.publicaly_available</code>以及<code>post.publish.no_longer_publicly_available</code>,且将在2023年8月1日前同时支持<strong>share.video.*</strong> 和<strong> post.publish.* </strong>事件。请查看[事件类型](https://ads.tiktok.com/marketing_api/docs?id=1759979365064706)了解share.video.* 和post.publish.* 事件的差异,也可浏览[支持的 webhook 事件](https://ads.tiktok.com/marketing_api/docs?id=1759992576757762)查看所有webhook事件的简要汇总。|
|2023年3月13日 |产品优化|Creator Marketplace| 我们在[/tcm/report/get/](https://ads.tiktok.com/marketing_api/docs?id=1739934876194818) and [/tcm/report/get/v2/](https://ads.tiktok.com/marketing_api/docs?id=1752366000747522)中新增了五个返回参数<code>video_views_organic</code>,<code>video_views_paid</code>,<code>video_boosted_date</code> ,<code>video_views_organic</code>(在<code>daily_stats</code>下)和<code>video_views_paid</code>(在<code>daily_stats</code>下)。|
|2023年3月10日 |产品优化|推广系列管理| 我们在[线索广告](https://ads.tiktok.com/marketing_api/docs?id=1739470742024193)中已新增支持三个网页优化事件(`optimization_event` = `ON_WEB_ADD_TO_WISHLIST`,`ON_WEB_SEARCH`,或`ON_WEB_SUBSCRIBE`) ,事件描述请参阅[转化事件 - Pixel 事件类型](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)。
|2023年3月3日 |产品优化|推广系列管理| V1.3现已支持<strong>推广系列预算优化(CBO)</strong>,帮助广告主动态控制推广系列预算,以达到最好的推广系列投放效果。详情请参阅[推广系列预算优化](https://ads.tiktok.com/marketing_api/docs?id=1739381757818881)。
|2023年3月3日 |产品优化|推广系列管理| 我们在`budget_mode`中新增枚举值`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`,支持设置<strong>动态日预算</strong>,即一周七日的平均预算。详情请参阅[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。
|2023年3月3日 |产品优化|推广系列管理| 我们上线了新接口[/v1.3/identity/delete/](https://ads.tiktok.com/marketing_api/docs?id=1759155939236865),支持删除自定义用户认证身份。此外,[/v1.3/identity/get/](https://ads.tiktok.com/marketing_api/docs?id=1740218420781057)新增字段`filtering`和`keyword`,支持通过传入显示名称进行模糊匹配。
|2023年3月3日 |产品优化|推广系列管理| 我们上线了新接口[/v1.3/file/name/check/](https://ads.tiktok.com/marketing_api/docs?id=1759130033155073),支持查验文件名是否已用于现有图片或视频的命名。
|2023年3月3日 |产品优化|推广系列管理| 我们已支持通过`product_source`的新增枚举`SHOWCASE`以及新增对象`showcase_products`创建商品来源为橱窗的视频购物广告。枚举值`SHOWCASE`新增在广告组API([/v1.3/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114),[/v1.3/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745),以及[/v1.3/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922))中,对象`showcase_products`新增在广告API([/v1.3/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354),[/v1.3/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018),以及[/v1.3/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770))中。
|2023年3月3日 |产品优化|推广系列管理| 我们新增了三个<strong>橱窗</strong>接口[/v1.3/showcase/identity/get/](https://ads.tiktok.com/marketing_api/docs?id=1759233549899778),[/v1.3/showcase/region/get/](https://ads.tiktok.com/marketing_api/docs?id=1759233561597954),以及[/v1.3/showcase/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1759233576199169)可用于获取橱窗中商品的信息。
|2023年3月3日 |产品优化|推广系列管理| 以`VO_MIN`为优化策略的价值优化目前仅支持推广目标`PRODUCT_SALES`,不再支持其他推广目标。
|2023年3月3日 |产品优化|推广系列管理| 优化目标`TRAFFIC_LANDING_PAGE_VIEW`现已全量发布。详见[枚举值 - 优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。了解使用落地页浏览量的有效设置,请参阅[转化事件 - 应用事件类型](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)。
|2023年3月3日 |产品优化|创意管理| 我们在[/v1.3/creative/portfolio/create/](https://ads.tiktok.com/marketing_api/docs?rid=wtljluwz8r&id=1739091950439426)中新增了`product_source`的枚举`SHOWCASE`以及对象`showcase_products`,支持创建可用于商品来源为橱窗的视频购物广告的商品卡片。
|2023年3月3日 |产品优化|报表管理| 当企业用户使用报表API生成同步报表时,用户调用API的方式可能会导致频繁超时,进而影响了报表产品的整体性能。为确保所有用户能够顺利集成,我们现在对以下四个场景进行了改善。详情请参阅[改善报表性能](https://ads.tiktok.com/marketing_api/docs?rid=httwim2pluw&id=1757262274182145)。
|2023年3月3日 |产品优化|报表管理| 我们在基础报表中新增维度`ad_type`,支持按广告类型分组。详见[基础报表 - 支持的维度](https://ads.tiktok.com/marketing_api/docs?id=1751443956638721)。
|2023年3月3日 |产品优化|商务中心| 从即日起至2023年8月15日,我们将在[/bc/balance/get/](https://ads.tiktok.com/marketing_api/docs?id=1739939128198145)的`tax`字段返回0,并在2023年8月15日之后完全移除该字段。
|2023年3月3日 |产品优化|通用| 所有在TikTok上投放广告的企业都必须遵守我们的反歧视政策。请提醒您的广告主登陆[TikTok广告管理平台](https://ads.tiktok.com/i18n/home),<strong>在2023年9月1日前同意反歧视广告政策</strong>。否则,您将不能在其TikTok for Business 用户账号下使用API进行相关操作。详见[TikTok 反歧视广告政策](https://ads.tiktok.com/marketing_api/docs?id=1759238111603713&rid=122nmjgatwro)。
2023年2月
``xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
|2023年2月24日 |产品优化|推广系列管理| 我们已支持使用<strong>第三方网站表单</strong>创建线索广告。您需在调用 [/v1.3/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)时使用新参数promotion_target_type,具体创建步骤请查看[创建线索广告 - 使用第三方网站表单创建线索广告](https://ads.tiktok.com/marketing_api/docs?id=1739470742024193)。
|2023年2月24日 |产品优化|推广系列管理| 我们在 [/v1.3/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922)的请求中新增了筛选字段promotion_type,支持筛选不同的推广对象类型。
|2023年2月24日 |产品优化|推广系列管理|我们在 [/v1.3/ad/aco/create/](https://ads.tiktok.com/marketing_api/docs?id=1739473063234626),[/v1.3/ad/aco/update/](https://ads.tiktok.com/marketing_api/docs?id=1739473077112833),[/v1.3/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354),[/v1.3/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018)的tracking_pixel_id字段中新增支持的推广目标APP_PROMOTION,PRODUCT_SALES和ENGAGEMENT。
|2023年2月24日 |产品优化|受众管理|我们在新增了两个与<strong>受众应用</strong>相关的接口。您可以使用 [/v1.3/dmp/custom_audience/apply/](https://ads.tiktok.com/marketing_api/docs?id=1758615097524225)将自定义受众应用到多个广告组,或断开受众与广告组之间的关联。您可以使用[/v1.3/dmp/custom_audience/apply/log/](https://ads.tiktok.com/marketing_api/docs?id=1758615737388033)获取自定义受众的最新应用记录。
|2023年2月24日 |产品优化|受众管理| 我们新增了接口[/v1.3/dmp/custom_audience/lookalike/update/](https://ads.tiktok.com/marketing_api/docs?id=1758616888158209) ,支持手动刷新相似受众。
|2023年2月24日 |产品优化|受众管理|我们在[/v1.3/dmp/custom_audience/list/](https://ads.tiktok.com/marketing_api/docs?id=1739940506015746)和 [/v1.3/dmp/custom_audience/get/](https://ads.tiktok.com/marketing_api/docs?id=1739940507792385)新增返回参数is_creator。您可以使用该字段和shared判断自定义受众所属情况和分享状态。此外,[/v1.3/dmp/custom_audience/get/](https://ads.tiktok.com/marketing_api/docs?id=1739940507792385)新增返回参数create_time,表示受众创建的时间。
|2023年2月24日 |产品优化|受众管理| 我们在[/v1.3/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353)中新增了请求参数product_source和promotion_type,使您可以在商品销量场景下进行更细化的受众预估。
|2023年2月24日|产品优化|报表管理|我们在基础报表中新增了指标类型<strong>线下事件指标</strong>。详情请参阅[基础报表 - 支持的指标](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553)。
|2023年2月24日 |产品优化|创意管理| 我们已支持通过[/v1.3/creative/portfolio/create/](https://ads.tiktok.com/marketing_api/docs?rid=wtljluwz8r&id=1739091950439426) 的请求中新增creative_portfolio_type字段的枚举值PRODUCT_CARD以及18个新字段创建商品卡片素材包,同时支持通过[/v1.3/creative/portfolio/get/](https://ads.tiktok.com/marketing_api/docs?id=1739092113671170)返回中新增的creative_portfolio_type字段枚举值PRODUCT_CARD以及新字段card_show_price,card_tags,和card_image_index获取商品卡片素材包详情。
|February 24th, 2023 |产品优化|工具| 我们在[/v1.3/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713)新增请求参数promotion_target_type,支持指定线索收集推广目标下的推广对象类型。
|2023年2月24日 |产品优化|广告度量| 我们上线了[事件API:线下事件](https://ads.tiktok.com/marketing_api/docs?id=1758049779688450),支持监测<strong>线下转化事件</strong>。
|2023年2月24日|文档优化|通用| 我们修订了TikTok API for Business的常见[使用案例](https://ads.tiktok.com/marketing_api/docs?id=1735713713137730),包括[创建推广系列](https://ads.tiktok.com/marketing_api/docs?id=1758526151905281)、[受众整合](https://ads.tiktok.com/marketing_api/docs?id=1758526010304514)、[获取线索](https://ads.tiktok.com/marketing_api/docs?id=1739289524101122)、[生成报表](https://ads.tiktok.com/marketing_api/docs?id=1758528841973762)和[订阅Webhook](https://ads.tiktok.com/marketing_api/docs?id=1738964126095362)。
|2023年2月17日|产品优化 |推广系列管理|您现在可以通过[/v1.3/tt_video/authorize/](https://ads.tiktok.com/marketing_api/docs?id=1738376435339265)应用提及了其他视频的源视频的授权码。此外,我们在 [/v1.3/tt_video/info/](https://ads.tiktok.com/marketing_api/docs?id=1738376324021250) 中新增了返回参数mentioned_item_ids。
|2023年2月17日|产品优化 |目录管理|我们在 [/v1.3/catalog/product/file/](https://ads.tiktok.com/marketing_api/docs?id=1740496787164161) 接口的请求参数新增字段update_mode,支持通过文件URL上传商品时选择覆盖更新或增量更新模式。
|2023年2月17日|产品优化 |通用|我们在获取访问令牌新增接口/v1.3/oauth/token/,支持Content-Type设置为"application/x-www-form-urlencoded"或"application/json"。详情请参阅[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1739965703387137)。
|2023年2月17日|产品优化 |报表管理|我们在异步基础报表新增维度custom_event_type和12个自定义事件指标。详情请参阅[支持的维度](https://ads.tiktok.com/marketing_api/docs?id=1751443956638721)。
|2023年2月17日|产品优化 |创意管理|我们在[/v1.3/file/video/ad/info/](https://ads.tiktok.com/marketing_api/docs?id=1740050161973250)接口的返回参数新增字段preview_url_expire_time,表示视频预览链接过期时间。
|2023年2月17日|文档优化 |广告度量|我们修订了[广告度量](https://ads.tiktok.com/marketing_api/docs?id=1739583617914881)指南,帮助您更好地理解广告度量相关功能以及如何使用事件API管理应用事件和网页事件。
|2023年2月10日|产品优化 |推广系列管理|我们在[/comment/list/](https://ads.tiktok.com/marketing_api/docs?id=1738086301876225&rid=8pbhupp08sd)接口的返回参数中添加了video_play_url,video_cover_url,user_avatar_url和user_name字段。|
|2023年2月10日 |产品优化|商务中心|我们在[/bc/billing_group/get/](https://ads.tiktok.com/marketing_api/docs?id=1738944324279297)接口的请求和返回中新增了参数status。您可以使用该字段筛选有效的帐单组。
|2023年2月10日 |产品优化|广告度量|我们在[/pixel/list/](https://ads.tiktok.com/marketing_api/docs?id=1740858697598978)的请求中新增了参数filtering和available_for_catalog_only,可用于筛选可作为事件源与商品库绑定的Pixel。
|2023年2月10日 |产品优化|推广系列管理|我们新增了secondary_optimization_event的枚举值DAY7_RETENTION。您可以查看[转化事件 - 深度转化事件类型](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889),了解如何使用该新增深度转化事件。
|2023年2月10日 |产品优化|推广系列管理|我们在[枚举值 - 优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)中新增了优化目标TRAFFIC_LANDING_PAGE_VIEW,同时在[转化事件 - 应用事件类型](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)中新增对应应用转化事件LANDING_PAGE_VIEW。您可以查看[转化事件 - 应用事件类型](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889),了解如何使用该新增应用转化事件及优化目标。
|2023年2月10日 |产品优化|推广系列管理|我们在[枚举值 - 深度事件出价类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)中新增了deep_bid_type的枚举值AEO。
|2023年2月10日 |产品优化|推广系列管理|我们在[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)中新增了请求参数share_disabled,您可以使用该参数禁止将竞价广告组中的广告分享到第三方平台。此前,仅在覆盖和频次广告组中支持此功能。
|2023年2月3日|产品优化|推广系列管理 |TikTok APP端已不再支持置顶评论。为了提升应用体验,为所有用户创造良好的环境,API也不再支持置顶评论功能。[/comment/pin/](https://ads.tiktok.com/marketing_api/docs?id=1738957749292033&rid=sxdhaaz882k)和[/comment/pinned/get/](https://ads.tiktok.com/marketing_api/docs?id=1738957797483522&rid=sxdhaaz882k)接口现已标注为<strong>废弃</strong>。请检查您的API集成,并作相应调整。
|2023年2月3日|产品优化|受众管理 |我们在[/v1.3/dmp/custom_audience/file/upload/](https://ads.tiktok.com/marketing_api/docs?id=1739940567842818&rid=ghrv306q4rj)的calculate_type字段中新增枚举值MULTIPLE_TYPES` ,表示支持上传带有多个ID类型的文件。参考创建客户文件受众-客户文件API了解详细步骤和文件示例。
|2023年2月3日|产品优化 |受众管理 |我们目前在/v1.3/dmp/custom_audience/file/upload/中支持的最大文件大小已从50MB增加为250MB,以支持客户上传更大的文件。
## 2023年1月
```xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
|2023年1月20日|产品优化 |推广系列管理|我们支持了更多品牌安全功能,包括支持出价前品牌安全筛选中的<strong>标准库存</strong>选项,出价后第三方品牌安全监测新增两家合作伙伴(DoubleVerify和 IAS),以及支持选择三家合作伙伴(Moat,DoubleVerify和IAS)进行出价后第三方可见性监测。您可以查看[品牌安全](https://ads.tiktok.com/marketing_api/docs?id=1739381752981505),了解如何使用目前可用的品牌安全功能。 |
|2023年1月20日|产品优化 |推广系列管理|我们上线了新接口[/tool/vast_option/](https://ads.tiktok.com/marketing_api/docs?id=1755436556897281),用于获取可用的出价后第三方监测合作伙伴。|
|2023年1月20日|产品优化 |广告度量|我们已支持将TikTok应用事件SDK设置为调试模式,并使用测试事件工具在发布前测试SDK集成情况。请查看[iOS集成步骤](https://ads.tiktok.com/marketing_api/docs?id=1739585432134657)和[安卓集成步骤](https://ads.tiktok.com/marketing_api/docs?id=1739585434183746)中的<strong> "步骤4"</strong>,了解如何进行相关操作。|
|2023年1月13日|产品优化 |报表管理|我们在[/v1.3/report/integrated/get/](https://ads.tiktok.com/marketing_api/docs?id=1740302848100353)和[/v1.3/report/task/create/](https://ads.tiktok.com/marketing_api/docs?id=1740302766489602)新增了请求参数 `query_lifetime` 。您可以使用该参数在同步和异步基础报表,以及同步试玩素材报表中请求Lifetime指标。
|2023年1月13日 |产品优化|报表管理|我们在基础报表中新增了六个互动数据指标、三个网页事件数据指标、三个基础数据指标 (SKAN);在受众分析报表中新增了三个网页事件数据指标。参阅[基础报表-支持的指标](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553)和[受众分析报表-支持的指标](https://ads.tiktok.com/marketing_api/docs?id=1751454162042882)中的<strong> "v1.2与v1.3版本对比"</strong> 小节,了解新增支持指标。
|2023年1月13日 |产品优化|推广系列管理|我们更新了用户指南,自2023年2月16日起,您将不能创建[精品栏广告](https://ads.tiktok.com/marketing_api/docs?id=1738963942132738&rid=ksomb79l4k)和[Dynamic Showcase Ads](https://ads.tiktok.com/marketing_api/docs?id=1739470724723714&rid=ksomb79l4k)。同时我们新增了[迁移至视频购物广告](https://ads.tiktok.com/marketing_api/docs?id=1754726939130882)章节,介绍如何将已有的精品栏广告或Dynamic Showcase Ads迁移至视频购物广告。
|2023年1月13日 |文档优化 |商务中心 |我们修订了[商务中心](https://ads.tiktok.com/marketing_api/docs?id=1738864498580481&rid=ksomb79l4k)指南,介绍如何使用商务中心API高效管理多个TikTok广告账户、用户、资产和财务。
|2023年1月13日|文档优化|商品库管理|我们修订了[商品库管理](https://ads.tiktok.com/marketing_api/docs?id=1739578433846274&rid=ksomb79l4k)指南,帮助您更好地理解商品库相关功能以及如何使用商品库管理API创建和管理商品库。
|2023年1月9日 |产品优化|Creator Marketplace|我们在[/v1.3/tcm/order/create/v2/](https://ads.tiktok.com/marketing_api/docs?id=1747285331289089) 中新增了请求参数 `need_invite_link` 和返回参数 `invite_link` ,使您能在使用订单创建工作流2.0时生成邀请链接。 我们还上线了两个新接口[/tcm/invite/link/](https://ads.tiktok.com/marketing_api/docs?id=1754158360958978) 和 [/tcm/invite/link/update/](https://ads.tiktok.com/marketing_api/docs?id=1754158411228161),可用于为现有推广系列代码生成邀请链接,以及更新邀请链接的状态。|
|2023年1月6日|产品优化 |推广系列管理|我们现已支持创建<strong>直播购物广告</strong>。参阅[此处](https://ads.tiktok.com/marketing_api/docs?id=1754162402455554)了解创建流程。
|2023年1月6日|产品优化 |推广系列管理|我们在[/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354),[/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018),[/ad/get/](https://ads.tiktok.com/marketing_api/docs?id=1735735588640770)接口的 `vertical_video_strategy` 字段新增枚举值 `LIVE_STREAM` , 代表您在商品销量场景中使用的视频类型为直播视频。
|2023年1月6日|文档优化 |通用|我们新增了[附录-权限范围](https://ads.tiktok.com/marketing_api/docs?id=1753986142651394)章节,阐述[/oauth2/access_token/](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口返回的权限范围ID(`scope`)对应的权限。
2022年
2022年12月
``xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
|2022年12月26日|产品优化 |Creator Marketplace|我们上线了新接口[/tcm/report/get/v2/](https://ads.tiktok.com/marketing_api/docs?id=1752366000747522),您可以使用该接口请求通过[/tcm/order/create/v2/](https://ads.tiktok.com/marketing_api/docs?id=1747285331289089)创建的订单的报表数据。|
|2022年12月23日| 产品优化 |推广系列管理|我们新增支持版位<strong>全球化应用组合</strong>(PLACEMENT_GLOBAL_APP_BUNDLE)。详见[版位](https://ads.tiktok.com/marketing_api/docs?id=1745292441739265)。|
|2022年12月23日| 产品优化 |商务中心|我们上线了新接口[/bc/advertiser/disable/](https://ads.tiktok.com/marketing_api/docs?id=1752349244331009),您可以使用该接口永久停用商务中心中的广告账户。
|2022年12月23日| 文档优化 |通用|我们修订了[快速入门](https://ads.tiktok.com/marketing_api/docs?id=1735713609895937)指南,帮助您快速集成TikTok API For Business。
|2022年12月16日| 产品优化 |推广系列管理|我们完善了<strong>拆分对比测试</strong>的功能,新增了支持的推广目标(视频播放量、商品销量)和优化目标(观看6秒次数、观看15秒次数)。欲了解更多详情,请查看[拆分对比测试](https://ads.tiktok.com/marketing_api/docs?id=1742668394531842)。|
|2022年12月16日| 产品优化 |推广系列管理|我们推出了iOS 14专属推广系列配额优化功能,允许您在每个广告网络中为单个 iOS 应用分别创建11个 iOS 14 专属推广系列。请查看[iOS 14 专属推广系列配额优化](https://ads.tiktok.com/marketing_api/docs?id=1752256248260610),了解在推广系列层级和广告组层级的变化,以及对现有 iOS 14 专属推广系列的影响。|
|2022年12月16日| 产品优化 |TikTok商店|我们新增了接口[/store/list/](https://ads.tiktok.com/marketing_api/docs?id=1752267762718722),您可以使用本接口获取广告账户下可用的商店列表。|
|2022年12月16日| 产品优化 |商务中心|我们更新了接口[/bc/advertiser/create/](https://ads.tiktok.com/marketing_api/docs?id=1739939020318721),支持在代理商商务中心和直客商务中心中创建合约广告账户或竞价广告账户。|
|2022年12月16日| 产品优化 |推广系列管理|我们在[/campaign/create/](https://ads.tiktok.com/marketing_api/docs?id=1739318962329602), 和[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)中新增了字段request_id,允许您创建重名推广系列或广告组。|
|2022年12月16日| 产品优化 |报表管理|我们在异步报表中支持了11月18日在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553),[受众分析报表](https://ads.tiktok.com/marketing_api/docs?id=1751454162042882),和 [DSA报表](https://ads.tiktok.com/marketing_api/docs?id=1751625293044737)中新增的指标。此前这些新增指标仅在同步报表中支持。|
|2022年12月16日|文档优化|报表管理|我们在[/report/task/create/](https://ads.tiktok.com/marketing_api/docs?id=1740302766489602)和[受众分析报表-支持的维度](https://ads.tiktok.com/marketing_api/docs?id=1751454103714818)中新增提示,异步报表不支持查询UV类指标在受众维度下的数据。|
|2022年12月16日|文档优化|商务中心|我们在[/advertiser/transaction/get/](https://ads.tiktok.com/marketing_api/docs?id=1739939116353538)的bc_id字段描述中新增提示,您仅可使用该接口获取类型(type) 非NORMAL的商务中心下广告账户的资金流水。|
|2022年12月12日| 产品优化 |账号|我们在[/business/video/publish/](https://ads.tiktok.com/marketing_api/docs?id=1740001122130945)中新增了请求参数thumbnail_offset,您可使用该参数指定所发布视频中的一帧作为视频封面。|
|2022年12月9日| 产品优化 |推广系列管理|我们在[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114&rid=4tvcyoykuxf), [/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745&rid=4tvcyoykuxf), [/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353&rid=4tvcyoykuxf)中新增spending_power(消费能力)定向选项,您可以通过该字段选择高消费人群进行定向投放。获取广告组层级所有定向选项,请参阅[受众定向 - 手动定向选项](https://ads.tiktok.com/marketing_api/docs?id=1739381236849665&rid=4tvcyoykuxf)。
|2022年12月9日| 产品优化 |其他 |我们在[/user/info/](https://ads.tiktok.com/marketing_api/docs?id=1739665513181185)中新增返回参数avatar_url,您可以通过该字段获取用户头像URL。
|2022年12月9日| 文档优化 |报表管理 |我们修订了[报表管理](https://ads.tiktok.com/marketing_api/docs?id=1738864739862530)指南,详细介绍可用的报表类型,以及使用同步模式或异步模式生成报表的具体步骤。
|2022年12月5日| 产品优化 |Creator Marketplace|我们发布了两个新接口[/tcm/tt_video/apply/](https://ads.tiktok.com/marketing_api/docs?id=1751098904942594) 和 [/tcm/tt_video/status/](https://ads.tiktok.com/marketing_api/docs?id=1751098935842817),支持为现有订单申请Spark Ads授权码或获取现有订单授权状态。|
|2022年12月5日| 文档优化 |Creator Marketplace |我们在[快速入门](https://ads.tiktok.com/marketing_api/docs?id=1740027686310914)中新增了<strong>非推广系列代码订单</strong>和 <strong>推广系列代码订单</strong>的定义,并在 [获取Spark Ads授权](https://ads.tiktok.com/marketing_api/docs?id=1740027794580481)中增加了使用新接口/tcm/tt_video/apply/和/tcm/tt_video/status/的步骤。|
|2022年12月2日| 产品优化 |推广系列管理| 我们下线了BuzzVideo和Babe版位(PLACEMENT_TOPBUZZ)。您现在无法在BuzzVideo和Babe上投放广告,且选择了PLACEMENT_TOPBUZZ版位的现存推广系列将不会在BuzzVideo和Babe上继续投放。此外,如果您更新仅选择了PLACEMENT_TOPBUZZ版位的现存广告组,且投放地区包括JP或TW` ,系统会报错。详见版位。|
|2022年12月2日| 文档优化 |推广系列管理| 我们在出价中新增小节"出价限制" ,解释了出价的校验机制。了解出价金额上线,请查看附录-出价限制。
## 2022年11月
```xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
|2022年11月25日|产品优化|商品库管理|我们上线了新接口[/catalog/feed/switch/](https://ads.tiktok.com/marketing_api/docs?id=1750349624999937),您可以使用该接口修改更新源的计划状态。参考[/catalog/feed/get/](https://ads.tiktok.com/marketing_api/docs?id=1740665183073281)中新增返回参数 `status` 的描述,了解更新源计划状态。
|2022年11月25日| 产品优化 |推广系列管理| 我们在[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114),[/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922),[/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745)的 `product_source` 字段中新增枚举值 `STORE` ,支持您创建商品来源为TikTok Shopping的视频购物广告。参阅[此处](https://ads.tiktok.com/marketing_api/docs?id=1750361719059457) 了解创建流程和示例。
|2022年11月25日|产品优化|商务中心|我们在[/bc/asset/get/](https://ads.tiktok.com/marketing_api/docs?id=1739432717798401),[/bc/asset/admin/get/](https://ads.tiktok.com/marketing_api/docs?id=1739433007779841),[/bc/asset/assign/](https://ads.tiktok.com/marketing_api/docs?id=1739438211077121)中新增参数 `store_role` ,并在`asset_type` 字段中新增枚举值 `TIKTOK_SHOP` 、`STOREFRONT` 。您现在可以在商务中心中获取或分配 TikTok Shop 和 TikTok Storefront。
|2022年11月25日|产品优化|商品库管理| 我们在[/catalog/feed/update/](https://ads.tiktok.com/marketing_api/docs?id=1740665197662210&rid=5dyeivzp8wu)的请求参数 `update_mode` 中新增枚举值 `SUPPLEMENT` 。您可以使用该枚举值更新现有商品的指定字段。
|2022年11月25日|文档优化|推广系列管理| 我们在[/ad/aco/create/](https://ads.tiktok.com/marketing_api/docs?id=1739473063234626)中新增提示:每次调用该接口时最多可创建450个程序化创意广告,且单个广告主账户中每天最多可创建5000个广告。
|2022年11月25日| 文档优化|广告度量| 我们修订了[事件API:网页事件](https://ads.tiktok.com/marketing_api/docs?id=1739584809311234),帮助您快速了解如何通过事件API管理网页事件。
|2022年11月21日| 产品优化| 账号| 我们发布了新接口[/business/hashtag/suggestion/](https://ads.tiktok.com/marketing_api/docs?id=1749827124568130) ,能够根据您指定的关键词返回TikTok账号视频的推荐话题标签列表。|
|2022年11月18日|产品优化|受众管理|我们在[/segment/mapping/](https://ads.tiktok.com/marketing_api/docs?id=1739940585975809)中新增了三个请求参数:`action` ,`id_schema` ,`batch_data` 。您可以使用本接口添加或删除受众细分群的映射。支持的映射包括单一ID映射(每个用户或设备对应一个受众ID)和多个ID映射(每个用户或设备对应多个受众ID)。|
|2022年11月18日|产品优化|报表管理|我们在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1738864915188737),[受众分析报表](https://ads.tiktok.com/marketing_api/docs?id=1738864928947201),[DSA报表](https://ads.tiktok.com/marketing_api/docs?id=1738864960144385)中新增了多个指标。请参考具体文章下的<strong>“v1.2与v1.3版本对比”</strong>小节,了解各个报表新增的指标。请注意这些指标目前已支持同步报表,且将在十二月上旬支持异步报表。|
|2022年11月18日|文档优化 |通用|我们新增了[附录-HTTP状态码](https://ads.tiktok.com/marketing_api/docs?id=1749734684478466),帮助您了解如何处理不同的HTTP状态码。|
|2022年11月11日| 产品优化|商务中心|我们上线了[商务中心-资产组](https://ads.tiktok.com/marketing_api/docs?id=1749001426121730)API,您可以使用该系列接口创建、更新、获取、删除资产组。您可以在一个资产组中添加多个广告主账号,并快速设置有权访问资产组的成员。了解更多关于资产组的细节,请参阅[资产组](https://ads.tiktok.com/marketing_api/docs?id=1754705410074626) 。|
|2022年11月11日| 产品优化|推广系列管理|我们上线了<strong>购买意向定向</strong>功能。您可以使用[/tool/interest_keyword/recommend/](https://ads.tiktok.com/marketing_api/docs?id=1737180852720642)接口,将`audience_type`设置为`PURCHASE_INTENTION` ,并将返回的 `keyword_id`传入[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114),[/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745),[/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922),[/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353)中的 `purchase_intention_keyword_ids` 字段。|
|2022年11月11日| 产品优化|推广系列管理|我们在[枚举值 - 二级状态 - 广告组状态](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)中新增枚举值 `ADGROUP_STATUS_LIVE_NOT_START` ,表示广告组已到投放时间但直播未开始。|
|2022年11月11日| 产品优化|创意管理|我们更新了[/creative/ads_preview/create/](https://ads.tiktok.com/marketing_api/docs?id=1739403070695426)中`display_name` 字段的长度限制,使其与 [/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354)和[/ad/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953405142018) 中的 `display_name`长度限制保持一致。|
|2022年11月11日| 文档优化|创意管理| 我们修订了[创意管理](https://ads.tiktok.com/marketing_api/docs?id=1736271785207810)指南,帮助您快速了解创意管理的各项功能,并使用创意管理API管理创意资产、使用创意工具、生成创意报表。|
|2022年11月11日| 文档优化|推广系列管理|我们将在2022年11月底下线BuzzVideo和Babe版位(`PLACEMENT_TOPBUZZ`)。欲了解更多详情,请查看[枚举值-版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|2022年11月11日| 文档优化|推广系列管理|我们在[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)的 `placement_type` 和`placements` 字段描述中新增了提示, `placement_type` 和`placements` 字段在广告组创建完成后不支持更新。|
|2022年11月4日| 产品优化|创意管理|我们在[/creative/portfolio/create/](https://ads.tiktok.com/marketing_api/docs?id=1739091950439426)和[/creative/portfolio/get/](https://ads.tiktok.com/marketing_api/docs?id=1739092113671170)的 `creative_portfolio_type` 中新增枚举值 `DOWNLOAD_CARD`(下载卡),并新增了相关字段。您现在可以在素材包中添加下载卡。|
|2022年11月4日| 产品优化|推广系列管理|优化目标`ENGAGED_VIEW`(互动播放)现已全量发布。您无需再为此功能申请白名单。参阅[枚举值 - 优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)获取支持的优化目标。|
|2022年11月4日| 产品优化|推广系列管理|[/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354),[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114),[/campaign/create/](https://ads.tiktok.com/marketing_api/docs?id=1739318962329602)中的 `operation_status` 字段现已全量发布。您无需再为此功能申请白名单。|
|2022年11月4日| 文档优化|商务中心|我们在[/bc/advertiser/create/](https://ads.tiktok.com/marketing_api/docs?id=1739939020318721)中新增提示:本接口不支持在同一商务中心中同时创建多个广告账户。|
|2022年11月4日| 文档优化| 创意管理|我们在[创意素材包](https://ads.tiktok.com/marketing_api/docs?id=1739361803446273)中新增了在广告中使用倒计时贴纸和下载卡的指南。|
|2022年11月4日| 文档优化|报表管理|我们在[受众分析报表](https://ads.tiktok.com/marketing_api/docs?id=1738864928947201),[试玩素材报表](https://ads.tiktok.com/marketing_api/docs?id=1738864940608513),[DSA报表](https://ads.tiktok.com/marketing_api/docs?id=1738864960144385),[合约广告报表](https://ads.tiktok.com/marketing_api/docs?id=1738864971714562)中新增提示:CHUNK模式仅支持同步基础报表。|
2022年10月
xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
|2022年10月31日| 文档优化|账号|我们在[/business/comment/reply/list/](https://ads.tiktok.com/marketing_api/docs?id=1738083325918210)中新增提示:该接口目前不支持获取对隐藏评论的回复。 |
|2022年10月31日| 文档优化|Creator Marketplace|我们在[/tcm/creator/discover/](https://ads.tiktok.com/marketing_api/docs?id=1739935079726082)中新增提示:本接口目前只最多返回30个创作者的数据。|
|2022年10月28日| 产品优化|推广系列管理|我们上线了<strong>内容相关定向</strong>和<strong>TikTok Pulse</strong>,帮助广告主根据指定的内容话题或标签,在相关TikTok视频中展示广告。参阅[内容相关定向](https://ads.tiktok.com/marketing_api/docs?id=1745292519923713)和[关于覆盖和频次广告-TikTok Pulse](https://ads.tiktok.com/marketing_api/docs?id=1744571201117186),获取详细信息。|
|2022年10月28日| 产品优化|商务中心|我们在[/advertiser/balance/get/](https://ads.tiktok.com/marketing_api/docs?id=1739939106470913)中新增了返回参数 `transferable_amount` ,代表您广告账户中的实际可转金额。|
|2022年10月28日| 产品优化| 创意管理|我们在[/creative/portfolio/create/](https://ads.tiktok.com/marketing_api/docs?id=1739091950439426)和[/creative/portfolio/get/](https://ads.tiktok.com/marketing_api/docs?id=1739092113671170) 的 `creative_portfolio_type` 字段中增加了新的枚举值 `STICKER`(倒计时贴纸),您现在可以在素材包中添加倒计时贴纸。|
|2022年10月28日| 产品优化|推广系列管理|我们更新了[/delivery/bid/recommend/](https://ads.tiktok.com/marketing_api/docs?id=1746463732779009),支持为iOS 14专属推广系列获取推荐出价。参阅[获取推荐出价](https://ads.tiktok.com/marketing_api/docs?id=1746463347473410)了解使用该接口的前提条件。|
|2022年10月28日| 文档优化|通用|我们修订了[概览](https://ads.tiktok.com/marketing_api/docs?rid=4ueuvnq4zsp&id=1735712062490625),帮助您快速了解TikTok API for Business的优势与适用人群。 |
|2022年10月28日| 文档优化|推广系列管理|我们在[创建精品栏广告](https://ads.tiktok.com/marketing_api/docs?id=1738963942132738)中新增提示:精品栏广告将于2023年下半年下线,为保证流畅的API体验,建议您创建[购物广告](https://ads.tiktok.com/marketing_api/docs?id=1741942179356738)。|
|2022年10月28日|文档优化|推广系列管理|我们在"[创建广告 - 创建多图轮播广告](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354)"中新增提示:多图轮播广告只适用于TopBuzz版位,且只可用于对日本进行地域定向。 |
|2022年10月24日|产品优化|推广系列管理|我们上线了新的推广目标:<strong>应用推广</strong>和<strong>网站转化量</strong>,帮助您简化广告创建流程。参阅[应用推广](https://ads.tiktok.com/marketing_api/docs?&id=1747553433902082)和[网站转化量](https://ads.tiktok.com/marketing_api/docs?&id=1747553507237889)了解新旧推广目标的不同以及如何创建新目标的推广计划。|
| 2022年10月24日 | 产品优化 | Creator Marketplace | 我们发布了新的订单创建接口[/tcm/order/create/v2/](https://ads.tiktok.com/marketing_api/docs?id=1747285331289089),帮助您简化整体工作流程。您可使用新接口为在创作者创建订单,无论创作者是否在TikTok Creator Marketplace平台注册,且创建订单时您无需先自行创建一个推广系列。您可查看[创建推广系列和订单-工作流程 2.0](https://ads.tiktok.com/marketing_api/docs?id=1740027770662913)了解新的工作流程详情。 |
| 2022年10月24日 | 产品优化 | Creator Marketplace | 我们将[/tcm/creator/public/video/list/](https://ads.tiktok.com/marketing_api/docs?id=1737093147077634)中的 `comments_count` , `likes_count` ,`shares_count` ,和`video_views_count` 字段名更新为 `comments` , `likes` , `shares` ,和 `video_views` ,并将 `create_time` 的数据类型更新为字符串类型,从而与 [/tcm/creator/authorized/video/list/](https://ads.tiktok.com/marketing_api/docs?id=1735827480228865)接口保持一致。 |
| 2022年10月24日 | 文档优化 | Creator Marketplace | 我们在[快速入门](https://ads.tiktok.com/marketing_api/docs?id=1740027686310914)中将<strong>创作者</strong>的定义从TikTok Creator Marketplace平台注册的创作者在更新为 "TikTok上可接受广告主邀请创作视频、推广产品或品牌的创作者(TikTok个人账户,非企业号)"。 |
| 2022年10月24日 | 文档优化 | Creator Marketplace | 我们在[获取创作者授权](https://ads.tiktok.com/marketing_api/docs?id=1740027719016450)中新增了(使用[/tcm/creator/authorized/](https://ads.tiktok.com/marketing_api/docs?id=1735827374196738)和[/tcm/creator/authorized/video/list/](https://ads.tiktok.com/marketing_api/docs?id=1735827480228865))获取授权后洞察数据的步骤。 |
|2022年10月21日|产品优化|推广系列管理|我们在[/campaign/get/](https://ads.tiktok.com/marketing_api/docs?id=1739315828649986)的返回参数中新增字段 `is_smart_performance_campaign` ,帮助您区分推广系列是否为智能效果推广系列。|
|2022年10月21日|产品优化|推广系列管理|为了减少请求超时的情况,目前[/adgroup/review_info/](https://ads.tiktok.com/marketing_api/docs?id=1740554277061634)最多支持传入20个广告组ID(`adgroup_ids`)。|
|2022年10月21日|产品优化|商务中心|我们在[/bc/asset/admin/delete/](https://ads.tiktok.com/marketing_api/docs?id=1739657251102722)的请求参数 `asset_type` 中增添了新枚举值 `CATALOG` 、`ADVERTISER` 、`PIXEL` 、`TT_ACCOUNT` 。商务中心管理员用户现在可以使用此接口从商务中心删除商品库、广告账号、Pixel和TikTok账号。|
|2022年10月21日|产品优化|报表管理|我们在v1.2的[/reports/integrated/get/](https://ads.tiktok.com/marketing_api/docs?id=1715587780630529)接口和v1.3的[/report/integrated/get/](https://ads.tiktok.com/marketing_api/docs?id=1740302848100353)接口中的推广系列、广告组、广告层级的 `BASIC` ,`AUDIENCE` ,`CATALOG`报表类型中增加了默认筛选值`STATUS_NOT_DELETE` ,以减少请求超时的情况并提高报表性能。参阅[枚举值-广告管理-一级状态](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)获取所有一级状态筛选值。|
|2022年10月21日|产品优化|通用|我们为开发者授权开启了<strong>双重认证</strong>,要求广告主在执行该操作时登录广告账户,以确保执行授权的用户拥有该广告账户的相关操作权限。了解具体授权过程,请参阅[OAuth授权](https://ads.tiktok.com/marketing_api/docs?id=1738373141733378)。|
|2022年10月21日|文档优化|报表管理|我们在[基础报表-支持的筛选条件](https://ads.tiktok.com/marketing_api/docs?id=1738864915188737)中新增了 `IN` 和`BETWEEN`筛选类型的示例,帮助您减少格式错误。|
|2022年10月21日|文档优化|受众管理|我们修订了[受众管理](https://ads.tiktok.com/marketing_api/docs?id=1739566496956417)指南,帮助您快速了解受众管理功能并使用相关API管理受众。
|2022年10月17日| 文档优化| 账号|在 [/business/get/](https://ads.tiktok.com/marketing_api/docs?id=1737944804538370) 和[/business/video/list/](https://ads.tiktok.com/marketing_api/docs?id=1737946728285186)接口文档中增加提示,所返回指标数据受其相关数据在TikTok Analytics中是否存在影响。|
|2022年10月17日| 文档优化| 账号| 我们新增了文档总结[/business/get/](https://ads.tiktok.com/marketing_api/docs?id=1737944804538370)和[/business/video/list/](https://ads.tiktok.com/marketing_api/docs?id=1737946728285186)接口的数据延迟。欲了解更多详情,请查看[账号洞察数据延迟](https://ads.tiktok.com/marketing_api/docs?id=1746624508278786)。|
|2022年10月14日|产品优化|推广系列管理|我们上线了<strong>效果预估(EDR)</strong>功能,为您提供出价和预算推荐,以提升广告组的表现。欲了解更多详情,请查看[效果预估](https://ads.tiktok.com/marketing_api/docs?id=1746463274713089)。|
|2022年10月14日|产品优化| 推广系列管理| 您现在可以使用v1.2或v1.3版本的API更新<strong>应用推广</strong>和<strong>网站转化量</strong>推广系列。|
|2022年10月14日|产品优化|推广系列管理|为了帮助您快速获取拒审原因,我们在[/adgroup/review_info/](https://ads.tiktok.com/marketing_api/docs?id=1740554277061634)和[/ad/review_info/](https://ads.tiktok.com/marketing_api/docs?id=1740559669226498)返回参数中的 `reject_info`下增加以下三个字段:`forbidden_locations` ,`forbidden_ages` ,`forbidden_placements` 。|
|2022年10月14日|产品优化|商务中心| 为了帮助您快速获取广告主账号的类型,我们在[/advertiser/info/](https://ads.tiktok.com/marketing_api/docs?id=1739593083610113),[/bc/asset/admin/get/](https://ads.tiktok.com/marketing_api/docs?id=1739433007779841),[/bc/asset/get/](https://ads.tiktok.com/marketing_api/docs?id=1739432717798401),[/bc/partner/asset/get/](https://ads.tiktok.com/marketing_api/docs?id=1739662828320769)的返回参数中增加了新字段 `advertiser_account_type` 。|
|2022年10月14日|文档优化| 推广系列管理| 我们修订了[推广系列管理](https://ads.tiktok.com/marketing_api/docs?id=1735713781404673)指南,帮助您快速了解推广系列管理功能并快速进行广告创编。
|2022年10月14日| 文档优化| 受众管理| 新增使用`/dmp/custom_audience/create/` 和`/dmp/custom_audience/update/`进行通过文件创建受众和更新受众操作时的限制条件提示。欲了解更多详情,请查看[通过文件创建受众](https://ads.tiktok.com/marketing_api/docs?id=1739940570793985)和[修改受众](https://ads.tiktok.com/marketing_api/docs?id=1739940572667906)。|
|2022年10月14日| 文档优化| 推广系列管理| 在[/ad/aco/update/](https://ads.tiktok.com/marketing_api/docs?id=1739473077112833)接口文档中新增提示,目前不支持修改智能效果推广系列中的程序化创意。|
|2022年10月14日| 文档优化| 创意管理| 新增使用[/creative/ads_preview/create/](https://ads.tiktok.com/marketing_api/docs?id=1739403070695426)预览已有的常规广告时支持 `TRAFFIC` 、`REACH` 、`VIDEO_VIEWS` 和 `PRODUCT_SALES` 的推广目标的提示。 该提示可在[广告预览 - 预览已有广告](https://ads.tiktok.com/marketing_api/docs?id=1739403070695426)部分`preview_type` 的描述中查看。|
|2022年10月14日| 文档优化| 报表管理| 在[报表管理](https://ads.tiktok.com/marketing_api/docs?id=1738864739862530)中新增小节“报表管理与创意报表对比”,比较报表管理与创意报表在接口数量、数据层级和数据分组方面的差异。|
|2022年10月14日| 文档优化| 报表管理| 在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1738864915188737),[受众分析报表](https://ads.tiktok.com/marketing_api/docs?id=1738864928947201),和[试玩素材报表](https://ads.tiktok.com/marketing_api/docs?id=1738864940608513) 中的“Lifetime指标支持情况”部分新增提示,Lifetime指标在1.3版本的报表管理接口中暂不支持。|
|2022年10月14日| 文档优化| 报表管理|在[基础报表-支持的普通指标](https://ads.tiktok.com/marketing_api/docs?id=1738864915188737)下的指标标题中新增提示,基础报表中应用内事件指标、归因指标和Onsite事件指标不支持`country_code`维度。|
## 2022年9月
xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
|2022年9月30日|产品优化|创意管理|我们在[/creative/ads_preview/create/](https://ads.tiktok.com/marketing_api/docs?id=1739403070695426)中新支持了 `TRAFFIC` , `REACH` 和`VIDEO_VIEW`推广目标 ,同时也新增了 `placment` , `preview_format` , `ad_format` 和 `image_id`请求参数 ,帮助您更灵活地实现边创编边预览。|
|2022年9月30日| 产品优化 |推广系列管理| 我们新增了一个推广系列的优化目标 `ENGAGED_VIEW_FIFTEEN`(观看 15 秒次数) , 帮助您提高广告的视频播放量和互动量。欲了解更多详情,请查看[枚举值-优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br>相应地,我们在[基础报表](https://ads.tiktok.com/marketing_api/docs?id=1738864915188737)中新增了视频播放指标`engaged_view_15s`(观看 15 秒次数)。 |
|2022年9月30日| 文档优化|推广系列管理| 我们将`promotion_type`更新为条件必填字段,当推广目标(`objective_type`) 不是`REACH` ,`VIDEO_VIEWS`或`ENGAGEMENT`时必填。欲了解更多详情,请查看[创建广告组](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)。|
|2022年9月23日|产品优化|商品库管理|我们在[/catalog/create/](https://ads.tiktok.com/marketing_api/docs?id=1740306481704961)请求参数 `region_code` 的字段描述中新增了提示,说明创建商品库时如何传入有效的地区代码。|
|2022年9月23日|产品优化|推广系列管理|目前暂不支持创建暂停状态的覆盖和频次广告,因此我们更新了 [/campaign/create/](https://ads.tiktok.com/marketing_api/docs?id=1739318962329602)和[/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354) 中`operation_status` 字段的描述,强调创建覆盖和频次广告或推广系列时,`operation_status`不可设置为`DISABLE` 。|
|2022年9月23日| 文档优化|推广系列管理| 我们将[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114), [/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745), [/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739314558673922), 以及[/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353) 中的请求参数 `ios14_targeting`标记为条件必填项,并增加了相应提示。|
|2022年9月23日| 文档优化|商品库管理|我们在商品库指南中增加了使用案例。欲了解更多详情,请查看[商品库管理](https://ads.tiktok.com/marketing_api/docs?id=1739578433846274)。|
|2022年9月22日|文档优化|推广系列管理|我们修订了[覆盖和频次广告](https://ads.tiktok.com/marketing_api/docs?id=1739470723315713)指南,详细介绍如何使用v1.3接口快速使用覆盖和频次广告功能,创建覆盖和频次推广系列。
|2022年9月22日|产品优化|推广系列管理|我们更新了 `pixel_id` 的描述,说明其在广告组层级只支持 `CONVERSIONS` , `CATALOG_SALES` , `PRODUCT_SALES` 和`SHOP_PURCHASES` 的推广目标。如果您想追踪其他目标的事件,请在广告层级使用`tracking_pixel_id` 。欲了解更多详情,请查看 [/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114) 和 [/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354)。 |
|2022年9月19日| 文档优化|Creator Marketplace| 我们在 `/tcm/report/get/`接口的 `end_time` 字段描述中新增了提示,说明了如何指定有效的查询结束日期。 欲了解更多详情,请查看[请求TTCM 报表](https://ads.tiktok.com/marketing_api/docs?id=1739934876194818)。|
|2022年9月16日| 产品优化| 通用| 我们新增了<strong>Postman合集</strong>。 欲了解更多详情,请查看[概览-Postman合集](https://ads.tiktok.com/marketing_api/docs?id=1735712062490625)。|
|2022年9月16日| 产品优化| 通用| 目前已支持语言代码`el` (希腊语),且此枚举值已添加至[枚举值-受众语言](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|2022年9月16日| 产品优化| 广告度量| 我们修改了[/pixel/list/](https://ads.tiktok.com/marketing_api/docs?id=1740858697598978)中`pixel_setup_mode` 字段的描述,提示2022年9月15日后使用 [/pixel/create/](https://ads.tiktok.com/marketing_api/docs?id=1740858779758593)接口创建的所有Pixel将都是开发者模式。 |
|2022年9月16日|产品优化| 创意管理 |为了提升字段命名的一致性,我们将[/creative/ads_preview/create/](https://ads.tiktok.com/marketing_api/docs?id=1739403070695426)中的请求参数 `placement`重命名为`placements` 。|
|2022年9月16日|文档优化| 创意管理 |我们更新了 `/creative/ads_preview/create/` 中`preview_type` 字段的描述,增加了根据广告创建参数预览广告所支持的推广目标。欲了解更多详情,请查看[广告预览-根据广告创建参数预览广告](https://ads.tiktok.com/marketing_api/docs?id=1739403070695426)。|
|2022年9月16日| 文档优化|商务中心| 我们修改了 [/bc/advertiser/create/](https://ads.tiktok.com/marketing_api/docs?id=1739939020318721) 和 [/bc/advertiser/update/](https://ads.tiktok.com/marketing_api/docs?id=1739939050770434) 中 `promotion_link` 字段的描述,提示开发者推广链接的长度需小于255个字符。|
|2022年9月12日| 产品优化| Creator Marketplace|[/tcm/report/get/](https://ads.tiktok.com/marketing_api/docs?id=1739934876194818)接口中新增了指标,并新增了小节“指标数据的时间区间”。此外,更新后您若未在请求中指定指标(`metrics`),则仅会返回默认指标。|
|2022年9月12日| 产品优化| Creator Marketplace| 为了提升字段命名的一致性,我们已将[/tcm/creator/public/video/list/](https://ads.tiktok.com/marketing_api/docs?id=1737093147077634)和 [/tcm/creator/authorized/video/list/](https://ads.tiktok.com/marketing_api/docs?id=1735827480228865)接口中的 `item_ids` 和`item_id` 字段更名为`video_ids` 和`video_id` 。|
| 2022年9月9日 | 产品优化 |商品库管理 |我们更新了[/catalog/product/update/](https://ads.tiktok.com/marketing_api/docs?id=1740562287852546)接口支持增量更新和自定义标签。|
|2022年9月9日| 文档优化 | 推广系列管理| 我们更新了[/ad/aco/create/](https://ads.tiktok.com/marketing_api/docs?id=1739473063234626)中的“所支持的推广目标”部分,提示ACO接口目前不支持覆盖人数(`REACH`)和参与度(`ENGAGEMENT` )的推广目标。|
|2022年9月9日| 文档优化 | 推广系列管理| 我们更新了[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114) 中`pixel_id` 字段的描述,提示`pixel_id` 字段仅支持`CONVERSIONS` , `TRAFFIC` , `CATALOG_SALES` , `PRODUCT_SALES` , 或 `SHOP_PURCHASES` 为推广目标 (`objective_type`)。 |
|2022年9月9日| 文档优化 | 报表管理| 我们在报表的[最佳实践](https://ads.tiktok.com/marketing_api/docs?id=1738864817670145)中新增了如下提示:在同步报表请求中使用筛选字段 `campaign_status` ,`adgroup_status` ,`ad_status` ,或`playable_status` 可以降低系统负载,提高整体效率。|
|2022年9月9日| 文档优化 | 推广系列管理| 我们为`device_model_ids` 字段新增了提示:仅创建广告时需确保对应设备处于活跃状态( [/tool/device_model/](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)接口返回中`is_active` 为 `True` 。<br>[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114),[/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745),[/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353),[/adgroup/rf/create/](https://ads.tiktok.com/marketing_api/docs?id=1738235338194945),[/rf/inventory/estimate/ ](https://ads.tiktok.com/marketing_api/docs?id=1738235487941633),以及 [/adgroup/rf/update/](https://ads.tiktok.com/marketing_api/docs?id=1738235402874882) 中均可看到此新增提示。|
| 2022年9月5日 | 产品优化 | Creator Marketplace |接口[/tcm/spark_ad/apply/](https://ads.tiktok.com/marketing_api/docs?id=1739935099488258)中新增请求参数 `authorization_days` 。该字段可用于在授权申请时指定授权的有效天数,或请求更新已批准授权有效天数。 欲了解更多详情,请查看[申请Spark Ads授权码](https://ads.tiktok.com/marketing_api/docs?id=1739935099488258)。|
| 2022年9月2日 | 产品优化 | 推广系列管理 |拆分对比测试API v1.2 版本已废弃,并升级为v1.3版本,从而减少其与TikTok广告管理平台的功能差异,并提供更多功能及灵活性。欲了解更多使用案例及提示,请查看[拆分对比测试](https://ads.tiktok.com/marketing_api/docs?id=1742668394531842)。您可以点击[此处](https://ads.tiktok.com/marketing_api/docs?id=1742666215544834)查看相关接口。|
## 2022年8月
xtable
| 日期{20%} | 更新类型{15%} | API类别{15%} | 更新内容{50%} |
|---|---|---|
| 2022年8月29日 |文档优化| Creator Marketplace|新增小节介绍如何通过Webhooks订阅TCM订单状态的实时更新。欲了解更多详情,请查看[通过Webhooks获取通知](https://ads.tiktok.com/marketing_api/docs?id=1738964126095362)的“订阅TCM订单状态”部分。|
| 2022年8月26日 | 产品优化 | 推广系列管理| 新增购物广告功能。购物广告整合了视频购物广告和产品目录广告功能,能够使可供购买的视频广告出现在推荐页,从商品库直接拉取产品信息,并在TikTok平台的“推荐产品”和“相关产品”界面推广您的产品。欲了解更多详情,请查看[购物广告](https://ads.tiktok.com/marketing_api/docs?id=1741942179356738)。|
|2022年8月26日 | 产品优化|报表管理| 试玩素材报表中增加了5个新指标 (`playable_page_view_count` , `playable_first_scene_view_count` , `playable_second_scene_view_count` ,`playable_third_scene_view_count` ,`playable_cta_click`) ,以帮助广告主针对试玩素材投放表现获取更深入、更详细的数据洞察。欲了解更多详情,请查看[试玩素材报表-支持的指标](https://ads.tiktok.com/marketing_api/docs?id=1738864940608513)。|
| 2022年8月26日| 产品优化 | 广告度量| 为提升用户体验,更新了游戏广告的兴趣分类方法。欲了解更多新兴趣分类名称和ID详情,请查看[游戏相关兴趣分类](https://ads.tiktok.com/marketing_api/docs?id=1738865051947010)。|
| 2022年8月26日 |产品优化|商务中心| 已支持巴西和墨西哥的营业执照。因此,当您使用[/bc/advertiser/create/](https://ads.tiktok.com/marketing_api/docs?id=1739939020318721) 或[/advertiser/update/](https://ads.tiktok.com/marketing_api/docs?id=1739939050770434)接口在商务中心中创建或更新广告账户时,若广告账户注册地为中国大陆,中国香港地区,巴西或墨西哥,则`license_no` 字段必填。 |
| 2022年8月26日 |文档优化| 通用| 返回码章节已更新,增加了更多您在使用v1.3接口时可能遇到的返回码。 欲了解更多详情,请查看[返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
| 2022年8月26日 |文档优化| 通用|频控列表中新增14个特殊接口的合作级频次限制。欲了解更多详情,请查看[频控规则](https://ads.tiktok.com/marketing_api/docs?id=1740029171730433)的“接口特定频控级别”部分。|
| 2022年8月19日 |产品优化 | 创意管理 | 新增智能修复功能。智能修复可以自动检测您潜在的广告复审问题,比如视频大小,分辨率,背景乐和长度,并自动修复这些问题。欲了解更多详情,请查看[智能修复](https://ads.tiktok.com/marketing_api/docs?id=1741472523309058)。 <br>相关接口: [/file/video/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1737587322856449), [/video/fix/task/create/](https://ads.tiktok.com/marketing_api/docs?id=1741468875279361) 以及 [/video/fix/task/get/](https://ads.tiktok.com/marketing_api/docs?id=1741469487859714)。 |
| 2022年8月15日 | API版本迭代 | /| TikTok API for Business已从v1.2更新至v1.3版本。欲了解更多详情,请查看 [v1.3](https://ads.tiktok.com/marketing_api/docs?id=1740579480076290)。 |