小程序如何接入火山引擎埋点数据

记录火山引擎埋点涉及的主要文档及注意点

一、基本概念与准备工作

• SaaS云原生/非云原生&私有化环境
  • 私有化版文档
• 基本概念
  • 通用版
    
  • 私有化
    

二、接入流程

步骤 1：在火山引擎后台创建 / 配置应用

• 通用版
  

• 私有化
  

步骤 2：配置元数据

配置一般事件、事件属性、用户属性

步骤 3：接入数据

• 开发必读
  

• 小程序接入
  

  • 预置事件、事件公共属性
    

  • 小程序预置事件及属性
    

  • 用户属性
    

• 注意点：

  • 1）导入入口文件需要使用单一平台，否则会出现超包无法上传；并且在node_modules和node_modules文件夹中必须同步删除无用的文件（包文件结构说明），例如只用到了Auto插件，那么保留以下文件即可

  // 导入明确的某个小程序平台入口文件
  import WXSDK from '@datarangers/sdk-mp/esm/wx';
  // 导入所需插件，比如 auto 插件
  import Auto from '@datarangers/sdk-mp/esm/plugin/auto';
  WXSDK.usePlugin(Auto); // 实例化SDK
  const $$sdk = new WXSDK();
  $$sdk.init({// 请更换成自己的app_idapp_id: 0,auto_report: {click: true //点击事件}, // 开启预置事件采集
  });
  $$sdk.send();
  

  ├─ @datarangers
  │  ├─ sdk-mp                     
  │  │  ├─ esm 
  │  │  │  ├─ plugin
  │  │  │  │  ├─ auto.js
  │  │  │  ├─ wx.js
  │  │  ├─ package.json 
  │  │  ├─ README.md
  │  │  ├─ sdk.d.ts   
  

  • 2）在火山上user_unique_id和user_id都是代表用户的实名id，所以两者设置方式一样（即：user_unique_id修改后，user_id自动同步更新）

  	$$sdk.config({user_unique_id: '{{USER_UNIQUE_ID}}'});
  

  • 3）服务器域名可在火山引擎后台“增长分析 > 数据管理 > 埋点实时验证 > 微信小程序”中查询到
    

步骤 4：测试 & 验证上报

• 埋点数据验证
  

• 通用埋点验证操作指引
  

• 埋点实时验证
  

• 注意点：使用“埋点实时验证”时，需要导入“实时验证”插件，并且node_modules和node_modules文件夹保留对应文件

  // 导入入口文件
  import WXSDK from '@datarangers/sdk-mp/esm/wx';
  // 导入所需插件，verify
  import verify from '@datarangers/sdk-mp/esm/plugin/verify'
  WXSDK.usePlugin(verify); // 实例化SDK
  const $$sdk = new WXSDK();
  $$sdk.init({// 请更换成自己的app_idapp_id: 0,
  });
  $$sdk.send();
  

  ├─ @datarangers
  │  ├─ sdk-mp                     
  │  │  ├─ esm 
  │  │  │  ├─ plugin
  │  │  │  │  ├─ verify.js
  │  │  │  ├─ wx.js
  │  │  ├─ package.json 
  │  │  ├─ README.md
  │  │  ├─ sdk.d.ts