**版本：202601**

# 查询落地页数据分析

**POST** `/openapi/2026-01/data-analysis/land-page`

按落地页 URL 分组获取落地页分析数据，包括页面浏览量、独立访客数、加购率、结账漏斗、订单数、销售额、跳出率和平均访问时长。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `begin_time` string (required)

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

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

  分页游标
- `page_size` int32

  每页记录数

  **默认值：** `10`
- `page` int32

  页码（从 1 开始），与 cursor 互斥
- `sort_by` string

  排序字段，可选值：

  *   `pv`：页面浏览次数
  *   `uv`：独立访客数
  *   `add_cart_uv`：加购独立访客数
  *   `begin_checkout_uv`：发起结账独立访客数
  *   `add_payment_info_uv`：提交支付信息独立访客数
  *   `orders`：订单数量
  *   `sales`：总销售额
  *   `conversion_rate`：转化率
  *   `escape_rate`：跳出率
  *   `avg_elapse`：页面平均停留时长
  *   `product_uv`：浏览商品详情页的用户数
  *   `order_customers`：下单客户数
- `time_zone` int32

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

  排序方向，可选值：`asc`（升序）、`desc`（降序）
- `dimensions` string[] (required)

  维度列表，可选值：

  *   `land_url_path`：落地页 URL 路径
  *   `last_template_name`：页面类型
  *   `last_referrer_show`：最后互动来源
  *   `last_referrer_first_show`：流量类型
- `filters` string

  高级筛选条件（JSON 字符串），为一棵嵌套筛选树：

  *   数组节点 `[ ... ]`：子条件之间为 OR（或）
  *   对象节点 `{ ... }`：各字段之间为 AND（且）
  *   叶子节点：{"operator": "...", "value": ...}，挂在某个筛选 key 下 要传的 `value` 类型由 operator 决定（大小写不敏感）：
  *   `in`、`not in` -> value 为数组，例如 \["a", "b"\]；传标量不会匹配，这两个 运算符务必传数组。
  *   `like`、`not like` -> value 为字符串，例如 "google"
  *   `=`、`>`、`>=`、`<`、`<=` -> value 为标量（字符串或数字），例如 10 value 会按目标字段类型自动转换。常用 key：`land_url_path`、`last_template_name`（页面 类型）、`last_referrer_show`（流量渠道）、`last_referrer_first_show`（流量类型）。 未识别的 key 或不支持的运算符会被静默忽略，筛选「不生效」时优先核对 key 与 operator 的拼写。 例如：AND：{"land\_url\_path": {"operator": "like", "value": "/"}} OR ：\[{"last\_referrer\_show": {"operator": "like", "value": "google"}}, {"last\_referrer\_show": {"operator": "like", "value": "facebook"}}\]
- `filter_crawler_type` string

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

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

```json
{
  "begin_time": "string",
  "end_time": "string",
  "cursor": "string",
  "page_size": 10,
  "page": 0,
  "sort_by": "string",
  "time_zone": 0,
  "sort_direction": "string",
  "dimensions": [
    "string"
  ],
  "filters": "string",
  "filter_crawler_type": "string"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `count` int32

    记录总数
  - `last_updated_at` string

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

    分页游标
  - `has_more` boolean

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

    落地页分析数据列表

    *   Array \[

    - `last_referrer_show` string

      最后互动来源，如 "Direct"（直接访问）
    - `land_url_path` string

      落地页 URL 路径，如 "/"
    - `last_template_name` string

      页面类型显示名称，如 "Home Page"（首页）
    - `last_template_name_original` string

      页面类型枚举值，如 "index"
    - `pv` string

      页面浏览次数，格式化字符串，如 "3"
    - `uv` string

      店铺唯一访客数，格式化字符串，如 "1"
    - `conversion_rate` string

      转化率，格式化字符串，如 "0.00%"
    - `add_cart_uv` string

      已加购用户数，格式化字符串
    - `begin_checkout_uv` string

      已发起结账用户数，格式化字符串
    - `add_payment_info_uv` string

      已提交支付信息用户数，格式化字符串
    - `orders` string

      下单数量，格式化字符串
    - `sales` string

      总销售额，格式化字符串，如 "0.00"
    - `avg_elapse` string

      平均访问时长，格式化字符串，如 "22m42s"
    - `escape_rate` string

      跳出率，格式化字符串，如 "50.00%"
    - `pv_original` int32

      页面浏览次数，数值型
    - `uv_original` int32

      店铺唯一访客数，数值型
    - `conversion_rate_original` float

      转化率，数值型，如 0
    - `add_cart_uv_original` int32

      已加购用户数，数值型
    - `begin_checkout_uv_original` int32

      已发起结账用户数，数值型
    - `add_payment_info_uv_original` int32

      已提交支付信息用户数，数值型
    - `orders_original` int32

      下单数量，数值型
    - `sales_original` float

      总销售额，数值型
    - `avg_elapse_original` float

      平均访问时长（微秒），数值型
    - `escape_rate_original` float

      跳出率，数值型，如 50（表示 50%）
    - `last_referrer_first_show` string

      流量类型
    - `product_uv` string

      浏览商品详情页用户数
    - `product_uv_original` int32

      浏览商品详情页用户数，数值型
    - `order_customers` string

      下单客户数
    - `order_customers_original` int32

      下单客户数，数值型
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "count": 0,
    "last_updated_at": "string",
    "cursor": "string",
    "has_more": true,
    "data": [
      {
        "last_referrer_show": "string",
        "land_url_path": "string",
        "last_template_name": "string",
        "last_template_name_original": "string",
        "pv": "string",
        "uv": "string",
        "conversion_rate": "string",
        "add_cart_uv": "string",
        "begin_checkout_uv": "string",
        "add_payment_info_uv": "string",
        "orders": "string",
        "sales": "string",
        "avg_elapse": "string",
        "escape_rate": "string",
        "pv_original": 0,
        "uv_original": 0,
        "conversion_rate_original": 0,
        "add_cart_uv_original": 0,
        "begin_checkout_uv_original": 0,
        "add_payment_info_uv_original": 0,
        "orders_original": 0,
        "sales_original": 0,
        "avg_elapse_original": 0,
        "escape_rate_original": 0,
        "last_referrer_first_show": "string",
        "product_uv": "string",
        "product_uv_original": 0,
        "order_customers": "string",
        "order_customers_original": 0
      }
    ]
  }
}
```