Youzan Traffic

店铺流量指标、流量维度、维度值和推广分析原始数据查询;不提供推广链接或监控配置的远端数据变更能力,不做趋势研判、异常诊断、转化漏斗、画像、推荐或经营结论。

ahang1598 Updated 94 repo stars

File contents

流量与推广分析

使用本 skill 前,确认当前授权范围和店铺上下文。页面、广告和内容配置使用 youzan-feature-page,订单详情使用 youzan-order。

查询数量限制

  • 列表查询必须显式传入页码和每页数量,不得依赖接口默认分页;每页最多查询 20 条。
  • 批量查询每批最多传入 20 个对象或标识;超过 20 个时必须拆分为多个批次依次查询,且每批均不得超过 20 个。

支持能力

  • 查询页面浏览量、独立访客数、点击等历史或实时流量指标。
  • 查询可用的流量分析维度和维度值。
  • 按页面、商品、渠道、地域等维度分组、过滤、排序和分页查询原始指标。
  • 查询推广分析来源、推广记录和可识别的推广跟踪信息。
  • 返回原始指标和维度数据,不替代业务口径进行趋势或异常判断。

字段提示

  • 查询参数和返回结果中的字段必须使用中文字段名,不展示接口英文原始字段名。

必填信息

  • 查询流量指标时必须提供指标名称;历史指标还必须提供开始日期,实时指标不需要历史日期。
  • 按维度筛选时必须提供目标维度及其合法维度值;维度列表和维度值可先查询确认。
  • 查询推广分析记录时必须提供店铺标识或推广对象标识,具体取决于查询范围。

非必填信息

  • 流量列表查询的分组维度、过滤条件、排序方式和实时或历史范围可选;分页参数必须按“查询数量限制”传入。
  • 推广分析查询可补充渠道、关键词、时间范围、标签和状态条件。
  • 未指定指标或维度时不能自行猜测,需先根据可用字典让用户选择。

使用案例

  • 用户说“看近 7 天店铺页面浏览量和独立访客数”时,使用历史指标并补齐开始日期和结束日期;查询今天的快照时改用实时指标。
  • 用户说“按渠道看独立访客数”时,先确认该指标支持的维度和合法维度值,再按维度值分组查询。
  • 用户说“查某商品的访问量”时,使用商品维度的商品标识,不要把商品标题或页面类型标签当作维度值。
  • 用户说“创建推广链接或设置监控”时,说明本 skill 只支持读取流量和推广分析数据。

边界

  • 推广链接创建、跟踪标识写入、推广监控维护和其他远端数据变更不在本入口范围内。
  • 不把流量原始指标直接解释为成交、收入或投入产出比。
  • 不做异常归因、转化漏斗、用户画像、推荐和经营决策。

ahang1598/doubao-workbuddy-qwenwork-skills commit 41f2858110

Frequently asked questions

npx get-skill add ahang1598/youzan-traffic