DataFinder为您提供Node.js SDK，便于您对一些非网页进行埋点，例如Chrome插件进行埋点等场景。本文为您介绍Node.js SDK集成的操作指导。

获取Appid #

在开始集成前，首先需要在集团中拥有一个应用，进行 SDK 集成前，您需要获取对应应用的 appid 信息。

• SaaS-云原生场景下，您可以在「项目中心」->「项目管理」->「项目详情」-> 接入应用的「详情」->「应用 ID」中可查看您的 appid，详情请参见项目管理。
  
• SaaS-非云原生场景下，您可以在「应用列表」-> 接入应用的「详情」->「应用 ID」中可查看您的 appid，详情请参见应用列表。
  

获取上报地址 #

进行数据接入上报时，您需要根据当前的环境类型和端类型确认您的数据上报地址，如果上报地址设置错误，后续会导致您无法正常上报、查询到数据。

SaaS-云原生 & SaaS-非云原生 #

私有化环境 #

私有化部署场景下，您需要获取部署私有化环境时，自行规划配置的数据上送地址，如您不清楚此地址，请联系您的项目经理或客户成功经理。

step1：安装SDK #

npm i @datarangers/sdk-node 
npm i @datarangers/node-plugin-http

step2：初始化 SDK #

import { DataRangersSDK } from "@datarangers/sdk-node"; 
import { httpPlugin } from '@datarangers/node-plugin-http'; 

const sdk = new DataRangersSDK({ 
    app_id: 1234, // 传⼊申请的项⽬ appid ，必须是数字 
    logLevel: "verbose", // 开启本地⽇志打印，默认值为 silent 
    }); 

step3：设置数据上报地址 #

初始化SDK后，需要设置数据上报地址后，才可以上报埋点。

sdk.use(
   httpPlugin(
     {
        channel_domain: "https://***.****.com" // 设置上报域名，各环境的上报地址不一致，详情请参见上文的 获取上报地址 章节
     }
   )
);

step4：设置公共属性 #

需要设置登录⽤⼾id时，或者有全局的公共属性时，则可以使⽤config进⾏配置。

sdk.config({
  user: {
    user_unique_id: "xxx", // 设置全局的用户uuid
  },
  header: {
      os_name: 'xxx', // 设置、修改公共属性
  },
  custom: {
      key: 123 // 设置自定义公共属性
  }
});

step5：上报埋点 #

上报单个埋点 #

// 上报埋点
sdk.collect(
  "event_1", //埋点名称
  {
    event_param_a: 123,   //埋点属性
  }
);

批量上报埋点 #

批量上报埋点，即传⼊⼀个埋点数组即可。

// 批量上报埋点
sdk.collect([
  {
    name: "event_2",
    params: {
      event_param_b: 234,
    },
  },
  {
    name: "event_3",
    params: {
      event_param_c: 567,
    },
  },
]);