TikTok官方-店铺数据分析

TikTok Shop ERP 数据分析（Analytics）业务技能，经 /tiktokShop/developerProxy（appType=erp）转发 Analytics Open API：获取店铺视频表现（Get Video Performances）。依赖 linkfox-tiktok-shop-auth 选店（传 openId；token 后台化，勿手动 refresh）。当用户提到 TikTok 视频表现、店铺视频数据、视频 GMV、Get Video Performances、shop_videos/performance、视频销量/浏览量分析、analytics video 时触发。**不含授权**；**不含达人侧视频发布**（用 linkfox-tiktok-video）；商品/店铺绩效等可后续扩展本 skill。

版本: 1.0.1分类: 文档处理

中文

SKILL.md

TikTok Shop ERP 数据分析（Analytics）

本 skill 调用 TikTok Shop 卖家 ERP 分析开放接口。统一经 LinkFox 网关：

linkfox-tiktok-shop-auth  →  openId（选店）
        ↓
POST /tiktokShop/developerProxy
  appType = erp
  openId  = <ERP openId>
  path / method / queryString
        ↓
401 或 token 失效 → 网关自动 refresh 并重试一次

📌 前置依赖：linkfox-tiktok-shop-auth 📌 勿手动刷新 token 📌 官方入口：Get Video Performances 📌 完整参考：references/apis/<api>.md

Prerequisites

python scripts/check_auth_dependency.py；exit 42 → 先完成 linkfox-tiktok-shop-auth。
需要时间范围：start_date / end_date（通常 YYYYMMDD）。

Core Concepts

概念	说明
path 白名单	`analytics/`、`authorization/`
Get Video Performances	`GET analytics/202403/shop_videos/performance`
时间窗	Query：`start_date`、`end_date`（必填）
分页	`page_size` / `page_token`

Available Scripts

脚本	作用
`check_auth_dependency.py`	检测 auth skill
`analytics_api.py`	具名 API
`analytics_proxy.py`	通用 path/method
`get_authorized_shops.py`	取 `shop_cipher`
`get_video_performances.py`	视频表现列表

Usage Examples

python scripts/get_video_performances.py '{
  "openId": "...",
  "start_date": "20240301",
  "end_date": "20240331",
  "page_size": 20
}'

python scripts/analytics_api.py '{
  "api": "get_video_performances",
  "openId": "...",
  "start_date": "20240301",
  "end_date": "20240331"
}'

Important Limitations

当前以 Get Video Performances（202403） 为主；单视频详情/商品绩效等可后续扩展。
不含达人可购物视频发布（linkfox-tiktok-video）。

Feedback：skillName = linkfox-tiktok-shop-analytics。

评论与讨论

0/2000

还没有评论，分享你的体验吧。