帮助中心 > 技术文档 > 客户端SDK > Web JS SDK > SDK配置

Web JS SDK 接入流程主要分为两个步骤（两个文档）：

1、SDK配置：将对应的SDK集成到您的产品项目中，然后进行初始化代码处理；
2、SDK接入：将需要埋点的数据，按照SDK包装不同的方法进行数据上送，其中功能主要包含两大类：全埋点（自动采集数据上送）、自定义埋点（手动设置业务数据上送）。

1. npm引入

1.1. 安装

npm i hina-cloud-js-sdk
# or
yarn add hina-cloud-js-sdk
# or
pnpm i hina-cloud-js-sdk

1.2. 初始化

准备工作：获取数据接收地址，用于上报采集的数据，参考。

为精准、高效地分析数据，建议开启全埋点功能，以下是全埋点的精简配置：

// 在项目入口添加
import hina from 'hina-cloud-js-sdk'

// 初始化SDK并开启全埋点功能
hina.init({
  serverUrl: '数据接收地址',
  autoTrackConfig: {
    pageviewAutoTrack: 'singlePage',
    pageLeaveAutoTrack: true,
  },
});

// 将SDK实例赋值给全局变量hina，便于其他页面调用SDK的方法
window.hina = hina;

2. 离线引入

下载地址，文件结构：

├── hina.esm.full.js    # 用于 import 方式
├── hina.iife.js        # 用于 script 标签方式
└── hina.full.js        # 用于 CommomJS 方式

初始化。以 Script 标签方式为例，在HTML文件中引入离线SDK，代码示例：

<!DOCTYPE html>
<html>
    <head>
        <script src="./hina.iife.js"></script>
    </head>
    <body>
        <script>
            var hina = window.hinaDataStatistic.default;
            // 全埋点的初始化同上文1.2.章节
            hina.init(...);
        </script>
    </body>
</html>
作者：邓昊  创建时间：2023-02-21 16:38
最后编辑：史志前  更新时间：2025-04-01 16:17