ZEPETO 分析

zepeto分析是一个使统计api易于使用的包。 目前，google analytics可用。 👍 支持google analytics v4规范 步骤 1 安装 窗口 → 包管理器 → 请先安装zepeto world包1 21 14版本。 之后，安装zepeto分析包。 步骤 2 创建google analytics数据流 📘 google analytics https //analytics google com/ https //analytics google com/ 创建google analytics帐户后，您必须创建一个数据流以在world中使用。（平均需要1天激活初始帐户。） 建议您为每个worldid创建和管理一个数据流。 zepeto分析使用httpservice发送数据，因此请确保选择“web”平台。 请在您写入url的地方写下worldid。 数据流创建完成后，您可以验证测量 id。 要生成 api 密钥值，您必须输入测量协议 api 密钥菜单。 在右侧按下创建按钮后，完成昵称输入以生成密钥值。 请复制测量 id 和密钥值以进行下一个过程。 步骤 3 如何使用 在层次窗口中，单击 zepeto → zepeto analytics 选项卡。 一个名为 zepeto analytics 的对象会自动创建，如下所示： zepetoanalyticscomponent 是负责在场景中发送统计信息的组件。 在检查器窗口中，您可以输入发送统计信息所需的设置。 请选择 google analytics 作为分析类型，并输入 api 密钥和测量 id。 当您播放添加了 zepeto analytics 组件的场景时，累计停留时间值会自动累积到 google analytics 中。 您可以从报告 > 实时概览菜单查看参与时间值。（报告项目（不包括实时选项卡）需要一定时间才能反映。） 如果场景发生变化并且组件被删除，统计数据将不会被发送。因此，如果您想保留它，请处理为不销毁。 ❗️ 注意 如果您在编辑器测试期间检查调试模式，数据将不会发送到仪表板。 当您想堆叠数据时，请确保调试模式已关闭。 添加自定义事件 您可以基于自定义事件堆叠统计数据。 下面是一个示例代码，当您按下按钮时，它会向 google analytics 仪表板发送自定义事件。 import { zepetoscriptbehaviour } from 'zepeto script'; import { analyticstype, zepetoanalyticscomponent } from 'zepeto analytics'; import { button } from 'unityengine ui'; export default class customevent extends zepetoscriptbehaviour { public zepetoanalytics zepetoanalyticscomponent; public mybutton button; start() { this mybutton onclick addlistener(() => { // 当按钮被点击时，一个随机事件被发送到 google analytics const ga = this zepetoanalytics analytics(analyticstype googleanalytics); interface customevent { param 01 string; param 02 number; } const event customevent = { param 01 "param string val 01", param 02 3, } ga logevent\<customevent>("custom sub param", event); }); } } 确保在编写脚本后连接 zepeto analytics 组件。 下面的截图是一个配置好的组件示例，以使示例脚本正常工作。 从报告 > 实时概览菜单中，您可以看到自定义事件的值实时堆叠。 启用调试模式 google analytics 验证您发送的 customevent 的 payload body。（如果无效，将不会发送） 检查调试模式可以轻松查看您在控制台窗口中发送的 payload 的验证结果。 ❗️ 注意 如果您在编辑器测试期间检查调试模式，数据将不会发送到仪表板。 当您想要堆叠数据时，请确保调试模式已关闭。 如果您创建的自定义事件不符合您的 google 规范，则在调试模式下验证将失败。 有关 google 规范和调试模式的信息，请访问： 📘 有关 google 规范和调试模式的信息，请访问： 有关 google 规范和调试模式的信息，请访问： google analytics https //developers google com/analytics/devguides/collection/protocol/ga4/sending events?hl=en\&client type=gtag https //developers google com/analytics/devguides/collection/protocol/ga4/sending events?hl=en\&client type=gtag google analytics 开发工具 https //ga dev tools web app/ga4/event builder/ https //ga dev tools web app/ga4/event builder/ zepetobaseanalytics api 功能 描述 logevent 允许您将自定义事件发送到链接的 google analytics 仪表板。 支持单个参数（字符串、数字、布尔值）和通用有效负载。 对于通用格式的有效负载，仅允许 google analytics 转移的表单可以被传输。 https //developers google com/analytics/devguides/collection/protocol/ga4/validating events?client type=gtag https //developers google com/analytics/devguides/collection/protocol/ga4/validating events?client type=gtag setanalyticscollectionenabled 启用/禁用 zepeto analytics 组件的事件传输功能。可用于动态控制。 默认情况下，启用时 analytics 组件为 true，禁用时为 false。 （基本停留时间从 zepeto analytics 组件启用时自动记录。） sendduration 对于特定事件名称，您可以传输以毫秒（ms）为单位的停留时间。 可用于手动记录特定事件的参与时间。（独立于自动测量的停留时间。） 例如）用于手动记录“我在特定区域停留了 3 秒（3000 ms）” setuserproperty 对于您正在发送的事件，您可以添加自定义用户属性。 https //developers google com/analytics/devguides/collection/protocol/ga4/user properties?hl=en\&client type=gtag https //developers google com/analytics/devguides/collection/protocol/ga4/user properties?hl=en\&client type=gtag setuserid 对于您正在发送的事件，您可以设置 google analytics 的 userid 以进行区分。后续数据将在 google analytics 仪表板的用户部分单独收集。 https //support google com/analytics/answer/9213390 https //support google com/analytics/answer/9213390 默认情况下，每个用户通过映射到 (ga4) 会话单位在 zepeto userid 单位中自动收集。