You need to enable JavaScript to run this app.
导航
业务维度(item)数据接入使用实践
最近更新时间:2025.05.12 17:43:24首次发布时间:2025.05.12 17:43:24
我的收藏
有用
有用
无用
无用

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

示例业务数据

本示例中,示例账号为 ++小羊** 的账户在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

    当前时间

    数量

    忽略

    收货人

    商品名称

item数据接入实践

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\"}]}]",
    ...
},