元数据管理
输入“/”快速插入内容
元数据管理
元数据管理
用户3707用户3707用户6255用户62552025年10月23日修改
‼️
在数据上报之前，请务必确认您需要上报的元事件+属性是否都已经在引力创建过了，需要先创建后上报，暂不支持自由上报。
若元事件+属性未创建至今上报，会导致对应的事件&属性上报不成功或后台不显示。
在使用分析、映射、报表功能之前，您需要根据业务场景和回传、分析等需求，确认埋点上报的事件和属性。事件与属性的增删改查，均在元数据管理功能内完成。
1.
前期准备
在您开始接入之前，需要对您的项目进行理解和分析，了解您需要监控的指标和需要分析的事件，从而决定要上报什么样的数据；在开始之前，我们会先为您介绍 Event & User 模型
1.1
Event - User （事件-用户）模型介绍
日常生活中，我们想清楚地描述用户行为时，通常会包括几个要点：谁、在什么时间、在什么地点、通过什么方式、做了什么内容。
在引力中，用户行为会被组织成行为事件相关数据和用户相关数据，并分别存入事件表Event和用户表User中。
•
事件数据用于描述与具体行为事件相关的信息；
•
用户数据主要用于描述用户的状态和不会经常发生变化的属性
事件-用户模型
示例
例如：用户小明(id: 123)在2023年12月12日的16:30分，在深圳，通过微信支付了6元的游戏礼包。在引力存入的事件数据和用户数据，如图所示：
在上述例子中，描述用户行为的Who（谁）、When（时间）、Where（地点）、How（方式）、What（内容）都是事件属性，用户ID和用户最新状态（如累计付费金额）都是用户属性。两种属性的区别和设置，将会在后续为您介绍。
1.2
整理分析需求
在理解了 Event & User 模型之后，您可以开始着手整理分析需求，如果您对于该流程不太熟悉，可以参考以下建议：
整理业务分析指标，能帮助您梳理埋点方案，在技术做好埋点上报后，可以直接使用引力的分析功能进行数据分析。
分析指标的梳理，可以根据用户使用产品的行为路径或者内部对业务/功能模块的划分：
•
用户行为路径：进入某游戏app的用户，可能会经历：启动app-注册/登录-进入主玩法-参与活动-购买礼包-支付成功的路径，您可以根据每个节点，考虑需要统计的数据，例如支付成功的总金额、购买礼包的次数等。
•
业务模块：运营更关注用户参与活动、商城/礼包付费、优惠券使用等模块，优化师更关注用户注册、付费、留存等指标。您可以根据不同业务角色的具体需求来明确分析指标。
整理分析指标时，建议您优先明确基础的分析指标，例如注册、登录、付费等，如果没有特殊的分析需求，推荐使用引力 SDK 内提供的预置接口上传数据
分析指标可以参考下面表格的形式，便于不同角色查阅和后续维护。
指标名称 | 指标定义 | 分析维度 | 指标关联事件 |
付费率 | 付费用户数/注册用户数 | 时间/归因平台/付费项目 | 用户付费 |
1.3
梳理埋点方案
在确定好基础的分析指标之后，建议您考量指标关联应用内的用户行为转化为 Event & User 的形式，即事件、事件属性、用户属性。在梳理前，您需要先了解事件、事件属性和用户属性。
引力SDK内提供了预置（带有“$”符号）的事件、事件属性、公共属性和用户属性，可前往设置-元数据查看。如果有不满足您分析需求的事件和属性，引力支持您进行自定义埋点上报。
1.3.1
事件
用户在应用内触发的浏览、点击、支付等行为都可转化为事件。在设置事件埋点时，有多种形式：
•
关键行为：推荐一个行为设定为一个 Event，再根据您的分析点进行属性的设置。例如注册、付费、主玩法、升级等事件：
事件英文名 | 事件显示名 | 触发时机 | 属性英文名 | 属性显示名 | 属性类型 | 属性值示例 |
VipLevelUp | VIP升级 | 用户完成vip升级时 | vip_type | 会员类型 | 文本 | 青铜，白银，黄金...... |
| | | vip_level | 当前会员等级 | 整数 | 1，2，3，4，5...... |
| | | vip_reason | 升级途径 | 文本 | 直接充值，兑换码....... |
•
其他行为；比如只需要分析参与次数、参与人数的行为，您可以将多个这样的行为设置成一个 Event，再通过属性的方式标识具体的行为，比如设置一个 Event 叫次要事件，再通过一个属性事件类型来说明追踪的是哪个行为。例如产品页面中有不同按钮需要统计点击行为，可以统一汇总为「按钮点击」事件，并通过按钮id和名称进行区分：
事件英文名 | 事件显示名 | 触发时机 | 属性英文名 | 属性显示名 | 属性类型 | 属性值示例 |
ButtonClick | 按钮点击 | 点击按钮时 | button_name | 按钮名称 | 文本 | 添加，签到，查看...... |
| | | button_id | 按钮id | 文本 | 01，02，03...... |
| | | page_name | 所在页面 | 文本 | 会员权益，日常活动，排行榜........ |