You need to enable JavaScript to run this app.
导航
业务维度(item)数据接入(本地文件上传)
最近更新时间:2024.10.18 14:28:48首次发布时间:2024.10.17 19:12:13

如果您需要通过维度数据扩展事件分析的数据范围,您需要在定义好数据分析所需的业务维度信息后,将相关的业务维度数据和行为数据一起接入DataFinder,相关数据成功上报后,您即可在DataFinder中查询分析维度数据。本文为您介绍如何通过上传本地CSV文件的方式上传业务维度数据。

限制与注意事项
  • 当前仅SaaS-云原生环境支持此功能,SaaS-非云原生环境暂不支持。
  • 仅拥有数据接入-可管理权限的用户可使用本地上传功能。授权操作请参见权限管理
  • 业务维度数据支持多次更新,且支持使用本地文件上传、API上报两种方式更新上报数据,数值以最新一次上报结果为准。

前提条件

您需要先根据业务需求,规划并创建完成item及其关联属性,否则本地文件上传后也无法生效。创建业务维度和属性的操作请参见业务维度

注意

您创建的业务维度属性需与后续上传的业务维度数据数据格式保持一致,否则可能导致本地文件上传后,后续无法正常查询使用对应的数据。

本地文件上传item属性
  1. 登录DataFinder控制台后,单击顶部的数据管理>数据集成>数据接入,在外部数据数据源页签中,找到本地文件方式,单击接入按钮。
    Image

  2. 在弹出的侧边栏中配置本地上传参数。
    Image

    参数

    配置说明

    数据类型

    当前仅支持“维度表”。

    业务维度

    在下拉框中选择已创建好的业务维度。

    选择文件

    选择需要上传的文件。您可以单击下载模板下载一个本地文件模板,跟进模板中的示例数据填写待上传的业务维度数据。
    上传的文件中必须包含以下item相关数据:

    • 关联的itemid:即业务维度的维度id。
      例如,创建了一个商品相关的业务维度,业务维度名称为:goods;则关联id即为商品id,如商品id1、商品id2、……。
    • 关联属性名称:即关联的业务维度的属性名称。
      例如,商品相关业务维度中,创建了属性:商品一级分类、商品二级分类、商品名称。
    • 关联属性值:即关联的属性的取值。注意,此处的属性值的数据类型需要与创建业务维度属性时设置的数据类型一致。

    您可参考以下示例图,检查您的待上传item数据是否正确。
    Image

  3. 检查待上传数据是否符合预期。
    完成本地文件选择后,您可以在页面中查看预览的待上传数据,且界面会展示能正常解析上传的数据条目数,您可根据预览和解析数据判断待上传的数据是否符合预期。

    注意

    您可重点关注下数据预览中的数据格式是否与创建的业务维度属性数据格式一致,如果不一致,会导致数据上传后无法正常查询使用。

    Image

  4. 确认数据无误后,单击页面右下方的上传按钮,开始上传业务维度数据。

后续步骤

后续步骤:(可选)关联item属性与事件

  • 如果您此前已经将item与事件完成关联,仅使用本地文件上传方式将已有的item属性数据进行更新修改,则仅需完成本地文件上传操作即可,无需再次将item属性与事件关联。
  • 如果您此前未将item与事件进行关联,您是使用本地文件上传方式首次将item数据进行上报,则您还需进行item属性与事件关联的操作。
    创建好的 item 对象需要与事件关联才可以使用。您需要在配置数据接入时,同时配置好业务维度和事件数据的关联规则,即将某一个或多个具体item的item id 值配置到事件的属性中,通过代码埋点的方式,在埋点SDK的params中将业务维度配置为某个事件的属性,详细操作请参见各个端埋点与事件相关文档,例如iOS SDK 埋点与属性Android SDK 埋点与属性Web/JS SDK 埋点与属性等。

后续步骤:业务维度数据分析

当已经完成数据上报,并且属性没有被禁用的情况下。就可以在属性筛选、分组等处使用这些属性了。针对业务维度,我们还提供了业务维度分析功能,可以以业务维度为主体进行分析。业务维度数据分析的操作指导详情请参见业务维度分析