版本：202601

查询流量渠道数据分析

POST /openapi/2026-01/data-analysis/traffic-channel

按流量类型和流量渠道分组获取流量渠道分析数据，包括访问用户数、销售额、订单量及三者占总计的比例。

请求

application/json

请求体
示例

请求体必填

begin_timestring必填

开始时间，Unix 时间戳（秒），以字符串形式传递，例如 "1748736000"

end_timestring必填

结束时间，Unix 时间戳（秒），以字符串形式传递，例如 "1781481600"；应大于 begin_time

dimensionsstring[]必填

分组维度，可选值：

last_referrer_first_show：流量类型（渠道一级分类）
last_referrer_show：流量渠道（渠道二级分类）

metricsstring[]必填

查询指标，可选值：

uv：访问用户数
sales：销售额
orders：订单量
uv_rate：访问用户数占总计行的比例
sales_rate：销售额占总计行的比例
orders_rate：订单量占总计行的比例

time_zoneint32

时区偏移（小时）；推荐范围 -12 至 14

cursorstring

分页游标

page_sizeint32

每页记录数

默认值： 10

sort_bystring

排序字段，需为所传 metrics 中的指标；uv_rate、sales_rate、orders_rate 按对应原值排序

sort_directionstring

排序方向，可选值：asc（升序）、desc（降序）

has_summaryboolean

是否额外返回 summary 汇总行

filtersstring

维度筛选条件（JSON 字符串），以维度名为 key： {"<维度名>": {"operator": "<运算符>", "value": <值>}} 要传的 value 类型由 operator 决定（大小写不敏感）：

in、not in -> value 为数组，例如 ["Social"]；传标量不会匹配，这两个运算符务必传数组。
like、not like -> value 为字符串，例如 "google"
=、>、>=、<、<= -> value 为标量（字符串或数字）支持的 key 即两个维度：last_referrer_first_show、last_referrer_show；多个 key 之间为 AND。未识别的 key 或不支持的运算符会被静默忽略，筛选「不生效」时优先核对 key 与 operator 的拼写。维度的合法取值即流量渠道枚举值接口返回的取值。例如：{"last_referrer_first_show": {"operator": "in", "value": ["Social"]}, "last_referrer_show": {"operator": "in", "value": ["Facebook", "TikTok"]}}

filter_crawler_typestring

爬虫过滤策略，控制统计是否剔除爬虫/机器人流量。可选值：

no_filter_crawler：不过滤，统计全部流量（默认）
official_crawler：过滤掉已知爬虫/机器人

{
  "begin_time": "string",
  "end_time": "string",
  "dimensions": [
    "string"
  ],
  "metrics": [
    "string"
  ],
  "time_zone": 0,
  "cursor": "string",
  "page_size": 10,
  "sort_by": "string",
  "sort_direction": "string",
  "has_summary": true,
  "filters": "string",
  "filter_crawler_type": "string"
}

响应

application/json

数据结构
示例

数据结构

codestring

错误码

messagestring

错误信息

data object

countint32

维度组合总数（分页总数）

last_updated_atstring

统计数据最后更新时间，例如 2026-03-26T00:00:00Z

cursorstring

分页游标

has_moreboolean

是否有更多记录

data object[]

流量渠道报表数据列表

Array [

last_referrer_first_showstring

流量类型（渠道一级分类），例如 "Social"；仅当 dimensions 包含 last_referrer_first_show 时返回

last_referrer_showstring

流量渠道（渠道二级分类），例如 "Facebook"；仅当 dimensions 包含 last_referrer_show 时返回

uvstring

访问用户数，带千分位的格式化字符串，例如 "1,234"

uv_originalint64

访问用户数，数值型

salesstring

销售额，带千分位的格式化字符串，例如 "5,678.90"

sales_originaldouble

销售额，数值型

ordersstring

订单量，带千分位的格式化字符串，例如 "89"

orders_originalint64

订单量，数值型

uv_ratestring

访问用户数占总计行的比例，格式化字符串，例如 "45.6%"

uv_rate_originaldouble

访问用户数占总计行的比例，数值型，例如 45.6（表示 45.6%）

sales_ratestring

销售额占总计行的比例，格式化字符串，例如 "32.1%"

sales_rate_originaldouble

销售额占总计行的比例，数值型，例如 32.1（表示 32.1%）

orders_ratestring

订单量占总计行的比例，格式化字符串，例如 "28.7%"

orders_rate_originaldouble

订单量占总计行的比例，数值型，例如 28.7（表示 28.7%）

]

summary object

汇总行，has_summary 为 true 时返回