**版本：202701**

# 查询流量渠道数据分析

**POST** `/openapi/2027-01/data-analysis/traffic-channel`

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

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `begin_time` string (required)

  开始时间，Unix 时间戳（秒），以字符串形式传递，例如 "1748736000"
- `end_time` string (required)

  结束时间，Unix 时间戳（秒），以字符串形式传递，例如 "1781481600"；应大于 begin\_time
- `dimensions` string[] (required)

  分组维度，可选值：

  *   `last_referrer_first_show`：流量类型（渠道一级分类）
  *   `last_referrer_show`：流量渠道（渠道二级分类）
- `metrics` string[] (required)

  查询指标，可选值：

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

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

  分页游标
- `page_size` int32

  每页记录数

  **默认值：** `10`
- `sort_by` string

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

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

  是否额外返回 `summary` 汇总行
- `filters` string

  维度筛选条件（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_type` string

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

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

```json
{
  "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"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `count` int32

    维度组合总数（分页总数）
  - `last_updated_at` string

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

    分页游标
  - `has_more` boolean

    是否有更多记录
  - `data` object[]

    流量渠道报表数据列表

    *   Array \[

    - `last_referrer_first_show` string

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

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

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

      访问用户数，数值型
    - `sales` string

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

      销售额，数值型
    - `orders` string

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

      订单量，数值型
    - `uv_rate` string

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

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

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

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

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

      订单量占总计行的比例，数值型，例如 28.7（表示 28.7%）
    *   \]
  - `summary` object

    汇总行，`has_summary` 为 true 时返回

    - `last_referrer_first_show` string

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

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

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

      访问用户数，数值型
    - `sales` string

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

      销售额，数值型
    - `orders` string

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

      订单量，数值型
    - `uv_rate` string

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

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

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

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

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

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

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "count": 0,
    "last_updated_at": "string",
    "cursor": "string",
    "has_more": true,
    "data": [
      {
        "last_referrer_first_show": "string",
        "last_referrer_show": "string",
        "uv": "string",
        "uv_original": 0,
        "sales": "string",
        "sales_original": 0,
        "orders": "string",
        "orders_original": 0,
        "uv_rate": "string",
        "uv_rate_original": 0,
        "sales_rate": "string",
        "sales_rate_original": 0,
        "orders_rate": "string",
        "orders_rate_original": 0
      }
    ],
    "summary": {
      "last_referrer_first_show": "string",
      "last_referrer_show": "string",
      "uv": "string",
      "uv_original": 0,
      "sales": "string",
      "sales_original": 0,
      "orders": "string",
      "orders_original": 0,
      "uv_rate": "string",
      "uv_rate_original": 0,
      "sales_rate": "string",
      "sales_rate_original": 0,
      "orders_rate": "string",
      "orders_rate_original": 0
    }
  }
}
```