> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/zh-cn/startguide/connect/columns.md).

# 列映射指南

连接数据时，需要将自营商城数据的各个项目逐一映射到 Laplace 的标准项目。这项工作称为**列映射**。

本文档整理了各个项目**分别代表什么值**。如果在连接页面上不确定该选择哪个名称，请先在本文档中确认。

本文档将连接页面上选择的列称为**项目**。

{% hint style="info" %}
**本文档中的项目名称与连接页面上显示的名称相同**。请在页面上找到相应名称，并与自营商城数据进行映射。

**无需更改自营商城使用的列名**。只需在连接页面上指定对应关系即可。
{% endhint %}

## 在页面上映射的方法

在列匹配页面的「Laplace 列」中确认 Laplace 项目，然后在「数据源列」中选择自营商城数据的键。如果有之前保存的映射，可以通过「加载列映射」一次性加载。

<figure><img src="https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-8d2f8dd04a40d6f7e092b01bf6b5c24cbe8fc9fe%2Fstartguide__connect__columns__01.png?alt=media" alt="列匹配页面中的「Laplace 列」和「数据源列」" width="432"><figcaption></figcaption></figure>

* **通过电子表格连接时**：在连接窗口的标签页列表中点击「匹配」即可打开此页面。如需在连接后修改映射，请点击连接器页面表格中该表格行右侧的 ⋯（「更多操作」） › 「列映射设置」。
* **EasyAdmin**：也可以在「设置」 › 「数据」 › 「数据源」中，通过 EasyAdmin 行菜单的「列匹配」打开。

## 可以连接哪些数据

| 发送什么                                                                                         | 通过电子表格上传 |
| -------------------------------------------------------------------------------------------- | -------- |
| [订单](/guide/zh-cn/startguide/connect/columns/order.md)：什么时候以多少钱卖出了什么（42 个）                   | 可以       |
| [广告](/guide/zh-cn/startguide/connect/columns/ad.md)：各渠道的广告费和展示·点击·转化（23 个）                   | 可以       |
| [基础商品（成本）](/guide/zh-cn/startguide/connect/columns/cogs.md)：各商品的成本（5 个）                      | 可以       |
| [基础商品选项匹配](/guide/zh-cn/startguide/connect/columns/cogs_relation.md)：销售选项由哪些基础商品、各几个组成（11 个） | 不可以      |

括号中的数字是可映射的项目数。无需全部填写，大部分都是可选项目。

## 开始前必须了解的三件事

### 1. 请按照 Laplace 规定的含义发送

如果按照自营商城的标准随意理解项目含义进行映射，仪表板的数值就会出现偏差。

仪表板指标是以各项目的含义为前提计算的。如果标准不同，**连接会成功，也不会出现错误信息，只有数值会出错。**

例如，如果在 `付款金额` 中填入扣除运费后的值，即使销售额低于实际，页面上也不会显示警告。之后即使发现数值异常，也很难追溯原因。

### 2. 请确认用于区分记录的项目

每类数据都有**判断“两行是同一条记录还是不同记录”的基准项目**。本文档将其称为**识别键**。

* 订单为 `订单编号` + `商品订单编号`
* 基础商品为 `品牌` + `基础商品编号` + `基础商品名称` + `生效开始日期`
* 基础商品选项匹配为 `品牌` + `销售渠道` + `商品编号` + `商品名称` + `选项代码` + `选项信息` + `基础商品品牌名称` + `基础商品编号` + `基础商品名称`

各类别的识别键已写在各页面的最上方。

电子表格每次都会重新导入整张表格，因此即使此项目为空，行也不会被合并。但如果订单编号为空，将无法计算订单级指标（每单支付金额、交叉销售），因此建议填写。

### 3. 修改表格即可反映取消·修改

**通过电子表格上传时**，每次都会**重新反映表格的全部内容**。之前的内容不会保留，修改时只需修改相应的行即可。

## 各页面表格的阅读方法

请在页面上找到下表中的名称，并映射到相应的项目。

| 列    | 含义                                                                  |
| ---- | ------------------------------------------------------------------- |
| 页面显示 | 连接页面上原样显示的名称。用此名称查找即可                                               |
| 类型   | 值的格式。请参阅下方的[值的格式](#value-format)                                    |
| 必填   | **必填**表示没有此项目就无法保存连接。\*\*必填（识别键）\*\*是适用上述第 2 条规则的项目，在电子表格中留空也可以保存连接 |
| 常量输入 | **可以**表示可以直接输入固定值来代替要映射的项目                                          |

### 什么是常量输入

对于自营商城中没有对应值的项目，可以不选择要映射的项目，而是**只输入一次所有行都相同的固定值**。在列匹配页面中选择「（直接输入）」即可。

典型的例子是只有一个品牌时，直接在 `品牌` 中填入商号。

原则上识别键不能使用常量输入。因为填入固定值后，所有行都会拥有相同的键，数据会合并为一条。只有广告存在例外，请参阅[广告页面](/guide/zh-cn/startguide/connect/columns/ad.md)。

不能使用常量输入的识别键，必须映射每行值都不同的自营商城列。例如，`类目 ID` 连接 `category_code`，`销售渠道` 连接 `sales_channel`。

### 不会被保存的项目

如果连接页面上有**没有显示名称、直接显示英文键名的项目**，则实际上是不会被保存的项目。即使映射也不会保留值，可以留空。

## 值的格式 <a href="#value-format" id="value-format"></a>

### 日期和时间

以 `日期/时间` 或 `日期时间` 结尾的项目。以下格式均可识别。

```
2026-08-24
2026-08-24 14:06
2026-08-24 14:06:28
2026-08-24T14:06:28
20260824
20260824140628
```

分隔符 `.` `/` `-` 均可使用，也可识别 `2026-8-4` 这样一位数的月·日。也支持 `2026-08-24T14:06:28.123+09:00` 这样的形式。

{% hint style="warning" %}
**时差标记（`+09:00`）不会参与计算，而是被去除**。即使带有时差标记，也会直接使用前面的时刻，因此**必须以韩国时间（KST）发送**，仪表板的日期才会准确。
{% endhint %}

无法识别的值会按空值处理。

### 数字

即使显示格式混杂，大部分也能自动识别。

| 发送的值                 | Laplace 读取的值                      |
| -------------------- | --------------------------------- |
| `1,234`              | 1234                              |
| `₩1,234` · `1 234韩元` | 1234                              |
| `(500)`              | -500（括号是会计中使用的负数表示法）              |
| `1.234.567`          | 1234567                           |
| `12.5%`              | **空值**：无法确定是 12.5 还是 0.125，因此不予接收 |

**百分比或倍数请去掉符号，只发送数字**。带有货币符号以外单位的值无法读取。

## 状态变更说明

订单取消·退款·退货·换货请参阅[订单列](/guide/zh-cn/startguide/connect/columns/order.md)。

## 项目留空会导致哪些指标无法显示 <a href="#blank-fields" id="blank-fields"></a>

即使留空也可以连接，但使用该项目的指标将无法计算。以下是各指标所需的项目。名称均与连接页面的显示名称相同。

| 指标                         | 所需项目                                              |
| -------------------------- | ------------------------------------------------- |
| 支付金额                       | `付款金额` · `付款日期/时间`                                |
| 实际付款金额                     | `付款金额` · `付款日期/时间` · `积分` · `预存金`                 |
| 净销售额                       | `付款金额` · `付款日期/时间` · `取消完成日期/时间` · `退款日期/时间`      |
| 每单支付金额（AOV）                | `付款金额` · `付款日期/时间` · `订单编号`（订单编号是计算单数的单位）         |
| 商品购买金额                     | `商品价格` · `选项价格` · `数量`                            |
| 客单价（ARPPU） · 复购率 · 同期群 LTV | `付款金额` · `付款日期/时间` · 用于区分购买者的值（见下文）               |
| 交叉销售                       | `订单编号` · `商品编号`（按相同订单编号将行分组并统计组合）                 |
| 各商品销售额                     | `付款金额` · `商品编号`                                   |
| 各类目销售额                     | `付款金额` · `类目 ID` 或 `类目名称`                         |
| 点击率（CTR） · 千次展示成本（CPM）     | `展示次数` · `点击次数` · `广告费（含 VAT）`                    |
| 单次转化成本（CPA）                | `广告费（含 VAT）` · `转化`                               |
| 点击转化率（CVR）                 | `点击次数` · `转化`                                     |
| 展示转化率（CVR）                 | `展示次数` · `转化`                                     |
| 广告支出回报率（ROAS）              | `广告费（含 VAT）` + 订单的 `付款金额`（转化 ROAS 使用 `转化价值`）      |
| 毛利                         | `付款金额` + 基础商品的 `成本`                               |
| POAS                       | `付款金额` · `广告费（含 VAT）` + 基础商品的 `成本`                |
| 贡献利润                       | `付款金额` · 基础商品的 `成本` · `广告费（含 VAT）` · `手续费` · `运费` |

**用于区分购买者的值**：复购率、客单价等以“一个人”为单位计数的指标，需要用于区分购买者的值。通过电子表格上传时，按 `下单人电话号码` → `会员 ID` → `下单人电子邮件地址` 的顺序，使用最先有值的项目。即使没有会员 ID，只要有电话号码或电子邮件也能计算。

完整的计算公式请参阅[了解计算公式](/guide/zh-cn/dashboard/formula.md)。

## 联系专属经理 <a href="#contact" id="contact"></a>

关于列映射还有其他疑问吗？

> 💬 [在官网咨询](https://www.analytics.laplacetec.com/contact)

**邮件咨询：** [**product@laplacetec.com**](mailto:product@laplacetec.com)