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

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

一、基本概念与准备工作

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

二、接入流程

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

步骤 2：配置元数据

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

步骤 3：接入数据

开发必读
小程序接入

注意点：

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

javascript 复制代码

// 导入明确的某个小程序平台入口文件
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_id
  app_id: 0,
  auto_report: {
  	click: true //点击事件
  }, // 开启预置事件采集
});
$$sdk.send();

tree 复制代码

├─ @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自动同步更新）

javascript 复制代码

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

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

步骤 4：测试 & 验证上报

埋点数据验证
通用埋点验证操作指引
埋点实时验证

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

javascript 复制代码

// 导入入口文件
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_id
  app_id: 0,
});
$$sdk.send();

tree 复制代码

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