Inseller 使用指南
/
EN 打开 Inseller

指南 › 日常使用 › 达人数据每日上传

达人数据 — 每天的手动上传

Shopee 给了我们真正的 affiliate API，那边的达人数据自己就会同步进来。TikTok 没有：它的 Affiliate 模块至今没有开放 API，所以有三个导出文件必须人工搬运。每天大约五分钟， 而这五分钟决定了你能不能知道——到底是哪个达人帮你赚到了钱。

开始之前

1

为什么偏偏这一块要手动

值得先搞清楚这个缺口在哪，因为它决定了你漏传一天会坏掉什么。TikTok 的订单流和结算流是 全自动的 —— 它们唯一不带的东西，是这单是谁卖出去的。

渠道达人归因是怎么进来的
Shopee 有真正的 affiliate API。Inseller 直接同步，归因率大致 100%，你什么都不用做。
TikTok 没有开放的 Affiliate API。结算数据里能看到「付过佣金」，所以我们能推断这是一笔 达人单，但它从头到尾不写达人是谁。整个系统里唯一能把达人名字写到订单上的东西， 就是你导出的那个文件。
注意 —— 归因率是个时间戳

一个店铺的达人归因率，本质上就是最近一次有人导过数据是什么时候。从来没人传过的店铺 就停在 0% —— 那些达人带来的销售额全都在营收里，但没有任何达人挂在上面。Inseller 会在每一张 达人维度的表上主动披露「未归因」的那部分，就是为了不让合计数悄悄骗人。

已经自动化的部分 —— 别重复做

样品寄出这块已经不用管了。Sample orders 现在直接从 Order API 同步， 「哪个达人寄了什么」不再需要手动传文件。剩下要手动的只有下面三个分析类导出—— 那些只存在于 Affiliate Center 内部的表现、ROI 和佣金数据。

根治办法是 TikTok 的 Affiliate Seller API，也就是 seller.affiliate_collaboration.read 这个 scope。我们的申请还卡在 TikTok Partner Center，在批下来之前接口一律返回授权错误。等它通了，这一页就可以删掉， 三个上传会变成后台自动同步。

2

从 Affiliate Center 导出三个文件

三个都是从 Seller Center → Affiliate 进去，然后进 Affiliate Center。 每一个都有自己的 Export 按钮和自己的日期选择器 —— 日期要一个一个设，它们不共用。

a · Sample Analysis（样品分析）

Affiliate Center›Analytics›Samples›Creators›Export

谁收了样品、样品成本多少、回报是什么：Content GMV 以及 TikTok 口径的 45 天 / 90 天 ROI。就是靠它，把「我们寄出去 40 个包裹」变成一个回本数字。

TikTok Affiliate Center 的 Samples 分析页，Details 区选中 Creators 标签，右侧是 Export 按钮 1 2 3 4
① Analytics › Samples。② 选 Creators 标签，不是 Products。 ③ 日期范围设成昨天。④ Export。 图中达人名与金额已打码。

b · Transaction Analysis（交易分析）

Affiliate Center›Analytics›Performance›Creators›Export

订单级别的佣金，而且带达人用户名。如果三个里你只肯传一个，就传这个 —— 修归因的就是它。

TikTok Affiliate Center 的 Performance 分析页，Details 区选中 Creators 标签，右侧是 Export 按钮 1 2 3 4
① Analytics › Performance —— 最容易找错的就是这一项，因为「Performance」 听起来不像是导佣金的地方。② Creators 标签。③ 日期范围。 ④ Export。

c · Affiliate Orders（达人订单）

Affiliate Center›Affiliate orders›Export orders› 选日期范围

佣金背后的订单明细，用来跟结算流对账。

TikTok Affiliate Center 的 Affiliate orders 页，含 Export orders 按钮与订单创建日期筛选 1 2 3
① Affiliate orders —— 它是顶层菜单项，不在 Analytics 底下。 ② Export orders；旁边的 Exported 是取已导好文件的地方。 ③ Order creation date —— 这个默认是一大段范围，导之前记得收窄到昨天。
注意 —— 下载下来的文件不要改名

Inseller 是从文件名里读日期区间的。TikTok 导出时会把范围写进文件名， 例如 …_20260810-20260810.xlsx。你要是改成 affiliate-latest.xlsx，导入程序就不知道这个文件覆盖了哪几天， 月度覆盖表也就没法把那些天标成已完成。

小技巧

三个文件先全部下到同一个文件夹，再开始上传。以后想搞清楚「周二到底传了没有」， 翻一个文件名规范的文件夹，比翻浏览器下载记录轻松得多。

3

选昨天，不要选今天

三个日期范围全部设成昨天，一个完整的自然日。顺手把今天也一起勾上很有诱惑力，别这么做。

范围你会拿到什么
昨天 ✓ 一个已经收口的日子。佣金和 GMV 都定型了，导进去是什么数，以后还是什么数。
今天 ✗ 还在滚动的一天。你拿到的是半天数据，而且 Affiliate Center 自己的数字还在回修 —— 结果就是你导进来一个连 TikTok 自己后来都不认的数。

Affiliate Center 按 GMT+8 出数，并且会在面板上标一个「Updated on…」的时间。 如果那个时间戳比你要的区间还早，说明这份导出根本还没算完 —— 等一等， 别去导一个 TikTok 还没算完的区间。

变成固定动作

固定的人、固定的时间、每天早上导昨天。中间断了几天？把这个缺口当成一个区间导出来就行—— 导入程序是按文件名里的整段区间处理的，一个补数文件能把它覆盖的每一天都补上。 但只补真正漏掉的那几天：补数区间如果盖到了你已经传过的日子，那几天会多出第二行， 而不是把原来那行替换掉。

4

上传到 Inseller

Settings›Data Import›Affiliate Data —— 或者走 Affiliate›Management。

Import Affiliate Data 下面有三个上传卡片，顺序跟你导出的顺序一致。 每个卡片下面都写着它对应的 Affiliate Center 路径，方便你确认这个文件该喂给哪个口。

卡片喂什么给它格式
Sample AnalysisSamples → Creators 那个导出.csv · .xlsx
Transaction AnalysisPerformance → Creators 那个导出.csv · .xlsx
Affiliate OrderAffiliate orders 那个导出.csv · .xlsx

导入程序必须找到的列

你不需要动文件 —— TikTok 自己导出来就带这些列。它们的意义在于出错时： 报错信息会直接点名它没找到哪一列。

含义能识别的列名
订单 ID Order ID · Order Id · order_id · OrderID · 订单ID
达人用户名 Creator Username · Creator username · creator_username · 达人用户名
实际佣金 Actual Commission Payment · Commission Payment · commission_payment · 实际佣金

中文界面导出的文件也能用 —— 中英两套列名都认。它做的是精确匹配，这是故意的： 实际佣金（佣金本身）、实际计佣金额（算佣金的基数）、 实际店铺广告佣金付款（店铺广告佣金，完全是另一笔钱）—— 三个长得几乎一样的名字，指的是三个毫不相干的数。要是放松成模糊匹配， 就会悄无声息地导错那一列。

5

确认导进去了

同一个页面上有三个地方能告诉你今天这一轮到底算没算数。关掉标签页之前先看一眼 —— 「报成功但什么都没变」才是真正要抓的那种失败。

看哪里正常应该是什么样
Current Data Summary Upload Coverage 统计你已经覆盖了多少个周期。它应该往上走，而且不该再把你刚传的那天算成缺失。
Data Upload Status (by Month) 一个月一行，一种文件一列。当月三列都应该显示已上传 —— 怀疑哪里漏了，就扫这张表。
Import History 会多出一行，带文件名、类型和导入行数。导入行数 0 却标着成功，说明文件是读进去了但一条都没匹配上 —— 按失败处理。

再确认数字动了

  • 打开 Affiliate，达人行上挂着昨天的佣金，而且未归因的那部分是变小了，不是变大了。
  • Sample payback 和 blended ROAS 显示的是数字而不是 N/A —— 这两张卡严格只用本期自己的样品成本，所以某一期没传，它就按设计显示 N/A，而不是拿旧数字顶上。
  • 你心里的头部达人排在你预期的位置。如果某个你明知道卖得好的达人整个不见了，那他的订单还在未归因那堆里 —— 说明你传了 Sample Analysis，但没传 Transaction Analysis。

疑难排查

报「Missing required columns: Creator username…」

几乎都是文件传错了口。Affiliate Center 里好几张表看起来都像达人列表，但只有 Analytics → Performance → Creators 那个才带订单级佣金和用户名。报错里会列出它实际读到的表头 —— 跟上面那张表一对，通常能发现你导的是商品维度的表或者外联名单。

导入成功了，但归因率没变好

你只传了 Sample Analysis。它说明样品花了多少、赚回多少，但它不负责把达人挂到订单上 —— 干这件事的是 Transaction Analysis。把同一区间的 Performance 导出补传，再看一次未归因的那部分。

月度覆盖表还是把那天算成缺失

文件名上的日期区间丢了。Inseller 从文件名解析周期（…_20260810-20260810.xlsx），所以改过名的文件——或者被浏览器存成 export (3).xlsx 的——行数是导进去了，但一天也认领不了。重新下载，原样上传。

Sample payback / blended ROAS 显示 N/A 或 RM 0

那个周期内没有导入过样品成本。这两张卡是刻意不去回退到累计数的：拿一个旧数字当分母，会把「导入其实早就断了」这件事盖住，还顺便把回本率美化一遍。把覆盖那个周期的 Sample Analysis 导入，卡片就有数了。

能不能一个文件传一整月？

可以 —— 文件名声明多长的区间，导入程序就按多长处理。之所以推荐按天，是因为收口的一天以后不会再变，而月中导出来的整月数据以后还得重导一次。补历史用大区间，维持日常用按天。

同一天重复上传会不会重复计算？

重传同一个文件永远是安全的。但换个区间就是另一回事了，而且三个文件的行为并不一样：

  • Affiliate Orders 以订单 ID 为键 —— 它是把达人名重新盖到同一批订单上，所以不管你选什么区间都是幂等的。
  • Sample Analysis 和 Transaction Analysis 以达人 + 文件名里读到的日期区间为键。同一个区间传两次是覆盖；但两个不同却覆盖同几天的区间 —— 比如先传 8 月 1–10 日，再单独传 8 月 5 日 —— 会为同一批销售各建一行。

所以拿不准昨天传没传，再传一次是安全的。要避免的是对已经导过的时段换粒度重导：定一个节奏——每天一个文件——然后一直照做。

为什么 Shopee 完全不用做这些？

Shopee 开放了 affiliate API，Inseller 直接同步达人归因，它自己就能维持在接近 100%。这一页的手动流程之所以存在，纯粹是因为 TikTok 的 Affiliate 模块目前还没有对应的开放接口。

上一篇 ← 直播与达人