@dreamdata/analystics- next (英语)
Analytics Next (aka Analytics 2. 0) 是梦幻数据的最新版本 JavaScript SDK (英语).
快速启动
"分析2.0"最简单最快速的开始方法是 通过 Dreamdata 使用。或者,你可以 通过国家预防机制安装 并做仪表 你自己来.
使用 Dreamdata 数据
导航到 梦中数据 并选择 JavaScript v2.0. 点击"重新配置脚本"通过一个向导来设置脚本.
用作一种 npm 软件包
- 安装软件包
# npm
npm install @dreamdata/analytics-next
# yarn
yarn add @dreamdata/analytics-next
# pnpm
pnpm add @dreamdata/analytics-next
- 将软件包导入到您的项目中, 您可以继续工作( 工作) 类型)!
import { AnalyticsBrowser } from '@dreamdata/analytics-next'
const analytics = AnalyticsBrowser.load({ writeKey: '<YOUR_WRITE_KEY>' })
analytics.identify('hello world')
document.body?.addEventListener('click', () => {
analytics.track('document body clicked!')
})
注意, 您可以在 Dreamdata app 中查找您的写入键 .
懒惰/ 延迟装入
您可以装入一个缓冲分析版本, 需要 .load 将会是
在启动任何网络活动之前明确发出呼吁。 如果
您想要在发送任何跟踪数据之前等待用户的同意.
- ⚠️
.load只能调用 一次。 。 。 .
export const analytics = new AnalyticsBrowser()
analytics.identify('hello world')
if (userConsentsToBeingTracked) {
analytics.load({ writeKey: '<YOUR_WRITE_KEY>' }) // destinations loaded, enqueued events are flushed
}
如果您有要获取的设置, 此策略也会有所帮助 同步进行.
const analytics = new AnalyticsBrowser()
fetchWriteKey().then((writeKey) => analytics.load({ writeKey }))
analytics.identify('hello world')
共同框架和最高人民会议的使用
参见或关于与最高人民会议合并的文件 这里。 。 。 .
财务问题
使用脚本标记时添加打字符支持
-
安装 npm 软件包
@dreamdata/analytics-next是一个非常依赖. -
创建
./typings/analytics.d.ts
// ./typings/analytics.d.ts
import type { AnalyticsSnippet } from '@dreamdata/analytics-next'
declare global {
interface Window {
analytics: AnalyticsSnippet
}
}
- 配置要从自定义读取的打字符
./typings文件夹
// tsconfig.json
{
...
"compilerOptions": {
....
"typeRoots": [
"./node_modules/@types",
"./typings"
]
}
....
}
处理初始化错误
初始化错误在默认情况下会被登录, 但是如果您也想要捕获这些错误 错误,您可以进行以下操作:
export const analytics = new AnalyticsBrowser();
analytics
.load({ writeKey: "MY_WRITE_KEY" })
.catch((err) => ...);