使用说明与用户手册

初始面板上显示两个按钮"新建Bridge文件" 和"打开已有Bridge文件"

请在Data工作表的B列开始，第一行输入数据类型，第二行输入字段名，和第三行开始往下所有的行输入数据。A列为自动生成的第一行到第三行需要输入数据的标识说明，A列本身对数据和分析不产生影响。

2.1 数据类型选择

请在"Data"工作表的第一行生成的下拉菜单中，从B列开始，选择数据的类型，类型根据数据需要表示的含义而定。程序将根据数据的类型进行自动分析。

数据的类型分为5种： Dimension, Key, SumY, SumN, Result。每一个字段必须定义一种数据类型，可以使用下拉菜单选择数据类型。

现在以我们的模拟超市的数据为例，讲解每种数据类型的含义，每种类型的定义如下：

2.1.1 Dimension

表示数据的维度，例如日期，时间，区域等数据的维度和切面，这些字段不参与计算，只用来筛选数据。

2.1.2 Key

Key是Dimension的一种，只能有一个字段被标为Key。被标为Key的字段会作为分析的最小颗粒度，并在这个维度上计算每个因素对最终结果(Result)的影响。可以改变其他dimension 为Key 字段，进行不同颗粒度的分析。

例如：如果将"Prodect Name"选为Key，则程序将会计算每个变量在这个"Prodect Name"这个维度上的变化对最终结果(Result)的影响。

2.1.3 SumY

同一列字段的数据不同行之间可以相加并且加总后的数据有意义。是否正确的设置SumY或者SumN将影响最终的分析结果。

例如：每一行不同产品的Quantity可以加总， 加总后含义为总商品的数量。因此Quantity的Type可以设置为SumY。

SumY中可以直接输入数值，也可以使用公式通过其他的字段计算出数值。但是公式中只能使用Excel公式中的加减乘除四则运算符号以及括号，也就是：加+，减-，乘*，除/，左括号"("，右括号")"。公式使用注意事项

2.1.4 SumN

同一列字段的数据不同行之间不可以相加，并且加总后的数据没有意义。是否正确的设置SumY或者SumN将影响最终的分析结果。

例如：不同的产品的Price并不一样，如果要计算所有产品的平均Price，并不能直接将A产品的Price 加上B 产品的Price从而直接得到整体的Price。因此Price的Type可以设置为SumN。

SumN中可以直接输入数值，也可以使用公式通过其他的字段计算出数值。但是公式中只能使用Excel公式中的加减乘除四则运算符号以及括号，也就是：加+，减-，乘*，除/，左括号"("，右括号")"。公式使用注意事项

2.1.5 Result

只能有一个字段被选择为Result作为我们需要分析的数据结果。Result这一列这里必须输入公式，通过其他的变量计算出Result字段。

例如：如果Result字段的内容是sales，那么单元格需要输入 = Price * Quantity。或者是margin%，那么单元格需要输入=profit / revenue。

Result里的公式是程序用来关联变量及结果，以及分析逻辑依赖的重要信息。请确保在每一行的Result单元格中都含有可以计算出Result的公式，公式应该简洁清晰。Result 会分析公式中每个变量对Result的影响，而不在公式中的变量则并不在分析范围内。Result 公式中至少应该有一个字段的Data Type 是 SumY，这样才能把不同行的数据进行汇总分析。

Result公式中只能使用Excel公式中的加减乘除四则运算符号以及括号，也就是：加+，减-，乘*，除/，左括号"("，右括号")"。公式使用注意事项

2.2 字段名设置

在"Data"工作表的B列开始往右的第二行输入字段名，字段名所代表的数据的含义应该和第一行的数据类型相对应。字段名不能重复。

当点击“New Bridge File” 或者“Select Bridge File”打开文件后，在面板上将会出现蓝色按钮New Bridge和Refresh Bridge。

下拉菜单将会分两个区域，Baseline 和 Comparison

Baseline 和 Comparison下拉菜单中的字段，每个字段包含的选项完全一样。用户可以根据需要在下拉菜单中筛选那些选项作为Baseline数据，那些选项作为Comparison的数据,以此作为Bridge两端的对比和分析的数据。注意：当初始的时候，默认Baseline和Comparison下拉菜单中的字段是全选的，因此Baseline和Comparison得到的是完全一样的数据集，因此得到的是没有差异的Bridge。

4.1 Baseline下拉菜单 -选择分析比较的基础数据，例如我们经常将某些年份的数据作为比较的基础，则这里选择2023年

4.2 Comparison下拉菜单 - 选择分析比较的目标数据，例如这里选择2024年作为我们感兴趣的年份和2023年进行对比。

Bridge 工作表是展示最终分析结果，包括Bridge图和Contribution Analysis表格的工作表

5.1 Bridge 数据源 - 在左上角B3单元格开始，会出现字段名和数据，这是生成Bridge图表使用的数据。

5.2 Bridge图 - 显示经过程序运行后分析得到的Bridge，左边的蓝色柱子为Baseline，中间为每个变量贡献的影响，右边柱子Chart为Comparison.

5.3 Contribution Analysis 表格 - 在Bridge 图像的正下方，将会显示Contribution Analysis表格，其中显示了对Key字段的每个Item，在不同的因素下对整体变化的贡献。

通过Bridge图 和Contribution Analysis表格，将能够很快地找到影响变化的最主要Item（SKU），以及变化的因素（价格？成本？还是数量Mix？）

可以通过修改2.1 数据类型选择中，选择哪个字段是Key，哪个字段是Result，来分析不同维度，不同的result数据。并且可以根据3下拉菜单来筛选那些数据为Baseline和Comparison，点击Refresh Bridge生成更新的Bridge图和Contribution Analysis表格，以便对实际业务情况进行分析，并提出改进的建议

Added Data（新增数据） —— 仅出现在 Comparison 期，而在 Baseline 期不存在的记录。它们代表全新的事物，例如新上市的产品线、新开的门店、新签的客户。

Removed Data（移除数据） —— 仅出现在 Baseline 期，而在 Comparison 期已不存在的记录。它们代表退出、停产、流失或关闭的事物。

因为 Added Data 没有"之前"的值，Removed Data 没有"之后"的值，所以它们的影响无法被归因到任何单一因子（如价格变化、数量变化、成本变化等）。它们必须被独立隔离，作为 Bridge 图表上单独的柱子来呈现。

如果将 Added Data 和 Removed Data 混入常规的价格 / 数量 / 组合差异计算中，结果在数学上将毫无意义：

• 新上市的产品没有 Baseline 价格，"价格差异"无从定义。
• 已停产的产品没有 Comparison 数量，"数量差异"无从定义。
• 强行用 0 值代入公式，会人为放大或缩小其他因子，扭曲整个 Bridge 分析的结论。

先把这两类数据剥离出来，剩下的"同口径"项目才能干净地按价格、数量、组合、成本、汇率等真正的驱动因素进行拆解。

现实中最常见的 Added / Removed Data 体现，就是产品生命周期里的 NPI / EOL：

• NPI — New Product Introduction（新品上市）：今年（Comparison）刚推向市场、去年（Baseline）还不存在的产品。它的全部销售额、成本和毛利都归入 Added Data 这根柱子。
• EOL — End of Life（产品退市）：去年（Baseline）还在销售、今年（Comparison）已经停产并从产品目录中下架的产品。它失去的销售额和毛利归入 Removed Data 这根柱子。

同样的模式适用于许多其他业务场景：

• 零售 / 门店网络：新开门店 = Added Data；关闭门店 = Removed Data。
• 客户 / 订阅业务：本期新签客户 = Added Data；流失客户 = Removed Data。
• 地域扩张：新进入的国家 / 地区 = Added Data；退出的市场 = Removed Data。
• 并购重组：新收购的业务单元 = Added Data；剥离出售的业务单元 = Removed Data。
• 员工分析：新入职员工 = Added Data；离职员工 = Removed Data。

假设某公司正在分析销售收入的同比变化：

程序会自动通过对比 Baseline 与 Comparison 两张数据表的 Key 列（如 Product ID、Customer ID、Store ID）来识别 Added 和 Removed 记录：

• 仅出现在 Comparison 表中的 Key 值 → 视为 Added Data。
• 仅出现在 Baseline 表中的 Key 值 → 视为 Removed Data。
• 同时出现在两张表中的 Key 值 → 走正常的因子分解流程（价格、数量、成本等）。

无需手工打标签 —— 只要确保 Key 列（如产品编码）在两期之间保持一致，Bridge Analysis 就能正确处理 NPI / EOL 等结构性变化。