Youzan Traffic

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

# 流量与推广分析

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

## 查询数量限制

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

## 支持能力

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

## 字段提示

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

### 必填信息

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

### 非必填信息

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

## 使用案例

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

## 边界

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