TikTok Shop 定向合作样品字段更新:旧参数仍可提交,但内容偏好不再生效
定向合作样品旧字段被忽略,接口兼容不再等于内容偏好有效,接入方需要同步检查请求与回读。
TikTok Shop更新定向合作样品设置。官方变更说明标注发布日期为 2026 年 11 月 12 日,涉及 202508 版本的定向合作接口。旧字段 preferred_content_type 仍不会令现有客户端因本次变更直接失败,但其值会被忽略。仅看接口提交成功,已经不能证明样品内容偏好按原配置生效。
新字段 sample_fulfillment_content_type 用于表达样品履约内容类型,创建接口接受的值包括 NO_PREFERENCE 和 SHOPPABLE_LIVE。省略时默认为前者,后者对应可购物直播履约。官方同时说明拍卖类型样品也可通过常规直播完成履约,因此不能把这个值改写成只能通过拍卖直播履约。
另一个新增布尔字段是 use_product_sample_setting,位于 free_sample_rule 下,与样品免审核字段同级。官方要求开发者在创建、更新、搜索和详情查询流程中支持它。创建与查询涉及的具体字段并不完全相同,不能把某个接口的新参数直接复制到全部接口请求中。
这项变化主要影响通过应用或 ERP 管理TikTok Shop 联盟计划的商家和开发团队。卖家可提供店铺、合作记录与期望内容类型,要求服务商核对实际请求版本、字段映射及详情回读。合作商品的 SKU 也应对应清楚,避免把不同商品的样品规则误当作同一配置。
编辑部观察:兼容性更新容易留下业务结果未变更的错觉。旧参数不报错与新偏好已经保存,是两项不同检查。官方明确旧值会被忽略,因而有必要把接口响应和查询到的实际设置放在一起比较,不把自动化任务显示成功当作最终验收。
现有接入可优先排查仍发送旧字段的流程,再按接口文档调整新字段,并检查创建后的合作详情。本文讨论的是接口样品设置,不推导所有市场新增商家资格或统一样品费用。账号权限、合作可用范围及商品样品条件,仍需结合目标店铺与对应接口说明确认。