以下以一个具体的业务场景为例，为您介绍业务维度（item）数据的上报实践。

在DataFinder上创建并上报使用业务维度（Item）数据时，通用的操作流程要点如下。您可先了解以下为您介绍的流程要点，再参考下文中的详细示例，了解具体的操作步骤。

SaaS-云原生环境

1. 您需要先根据实际需要上报的维度情况，在DataFinder控制台的 数据管理 > 元数据管理 > 业务维度 页面创建业务维度，并定义其属性，将待上报的业务维度及其属性录入DataFinder元数据中，详情请参见创建/编辑业务维度。
2. 业务维度和属性录入元数据后，您可以开始上报业务维度的属性，当前支持直接通过文件上传业务维度的属性，也支持通过代码上报。
   • 文件上传：此种方式仅SaaS-云原生环境支持，详情请参见 业务维度（item）数据接入（本地文件上传）。
   • 代码上报：SaaS-云原生环境请参见 HTTP API--增长分析 DataFinder-火山引擎 。
3. 创建好的业务维度需要与某个用户行为事件关联才可以用于后续的分析，因此您需要在事件上报前，将Item与上报的事件进行关联。事件关联可通过界面配置和代码上报两种方式：
   • （推荐）界面配置：此种方式仅SaaS-云原生环境支持，推荐使用此种方式进行关联，配置更灵活，详情请参见 创建/编辑业务维度。
   • 代码上报：代码上报需在事件的params中添加__items字段（格式为JSON字符串，包含item名称和对应的ID列表）。 SaaS-云原生环境请参见 HTTP API--增长分析 DataFinder-火山引擎 。
4. 完成上述流程后，您即可在数据上报后在DataFinder控制台的 分析工具 > 高级分析 > 业务维度分析 页面进行业务维度分析，事件通过关联item的ID引入这些维度，详情请参见业务维度分析。

SaaS-非云原生环境

1. 您需要先根据实际需要上报的维度情况，在DataFinder控制台的 数据管理 > 元数据管理 > 业务维度 页面创建业务维度，并定义其属性，将待上报的业务维度及其属性录入DataFinder元数据中，详情请参见创建/编辑业务维度。
2. 业务维度和属性录入元数据后，您可以开始上报业务维度的属性。当前SaaS-非云原生环境仅支持直接通过代码上报，详情请参见 业务维度（item）数据接入（SaaS-非云原生版）。
3. 创建好的业务维度需要与某个用户行为事件关联才可以用于后续的分析，因此您需要在事件上报前，将Item与上报的事件进行关联。
   进行关联时，需在事件的params中添加__items字段（格式为JSON字符串，包含item名称和对应的ID列表），详情请参见 业务维度（item）数据接入（SaaS-非云原生版）。
4. 完成上述流程后，您即可在数据上报后在DataFinder控制台的 分析工具 > 高级分析 > 业务维度分析 页面进行业务维度分析，事件通过关联item的ID引入这些维度，详情请参见业务维度分析。

本示例中，示例账号为 小羊 的账户在App内做了购买事件，购买产品名称为【❤️性价比推荐❤️】天选5 15.6英寸高性能游戏本 笔记本电脑，购买商品数量为 3 ，总价为 20000，收货人是 张三 。
示例中涉及到的业务维表和埋点需求如下：

• 维表1：商品

  product_id	product_cn	second_grad	amall_product_name	third_garde
  C01	90NRM200	天选	【❤️性价比推荐❤️】天选5 15.6英寸高性能游戏本 笔记本电脑	天选5
  i01	90pad1233	迷你pc	++【❤️性价比之王❤️】小米pad ++	minipc
  t01	90phone678	外购	【❤️学生必选❤️】oppo拍照	采购

• 维表2：收货人

  account_id（账号id）	consignee__name	nick_name	Address（地址）	phoneNum（电话）
  001	小羊	张三	河南洛阳	156797759081
  002	黄昏晓	张五	河北石家庄	156797222281
  003	常青树	李四	北京海淀	157766568659

• 数据埋点需求

  事件名	事件时间	事件属性	其他设备信息
  pay	当前时间	数量	忽略
  		收货人
  		商品名称

step1：创建业务维度表

创建业务维度表的操作详情请参见业务维度，配置要点如下。

实际创建效果如图：

• 商品维表

  

• 收货人维表

  

step2：上报维度表属性数据

上报方式有两种，可根据需要二选一

• 文件上传：业务维度（item）数据接入（本地文件上传）
• 代码上报：详见：HTTP API--增长分析 DataFinder-火山引擎

  curl --location '上报地址' \
  --header 'Content-Type: application/json' \
  --header 'X-MCS-AppKey: appkey' \
  --data '{
      "user": {
          "user_unique_id": "__rangers"
      },
      "events": [
          {
              "event": "__item_set",
              "local_time_ms": 1721044941000,
              "params": "{\"item_name\":\"product\",\"item_id\":\"C01\",\"product_cn\": \"90NRM200\",\"product_name\":\"【❤️性价比推荐❤️】华硕天选5 15.6英寸高性能游戏本 笔记本电脑\",\"third_garde\": \"天选5\"}"
          }
      ],
      "header": {
          "app_name": "AAA"
      }
  }'
  

step3：事件上报

详见：HTTP API--增长分析 DataFinder-火山引擎

curl --location '上报地址' \
--header 'Content-Type: application/json' \
--header 'X-MCS-AppKey: appkey' \
--data '{
    "user": {
        "user_unique_id": "001"
    },
    "header": {
        "app_name": "test",
        "app_package": "com.ss.android.article.news",
        "app_version": "5.1.3",
        "custom":{
             "__is_history": "true"
              }
    },
    "events": [
        {
            "event": "lhy_test",
            "params": "{\"user_is_login\":1,\"num\":3，\"color\":\"C01\"，\"consignee\":\"\"001}",
            "local_time_ms": 1733395152000
        }
    ]
}'

step4：上报事件和维表绑定

详见：HTTP API--增长分析 DataFinder-火山引擎

...
"event": "lhy_test",
"params": {
    "__items": "[{\"product\":[{\"id\":\"C01\"}]},{\"consignee\":[{\"id\":\"001\"}]}]",
    ...
},