# @fullstory/segment-react-native-plugin-fullstory 中文文档

规范地址：https://npmcn.com/package/%40fullstory/segment-react-native-plugin-fullstory/

版本：1\.0\.1
npm 元数据更新时间：2023-05-12T18:04:18.908Z
中文译文更新时间：2026-11-15T16:50:05.900Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fullstory/segment-react-native-plugin-fullstory
原文对照：https://npmcn.com/package/%40fullstory/segment-react-native-plugin-fullstory/?lang=original
项目主页：https://github.com/fullstorydev/segment-react-native-plugin-fullstory.git#readme
源码仓库：https://github.com/fullstorydev/segment-react-native-plugin-fullstory

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：37.7 kB，24 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=12
- 运行依赖：2 个
- peer 依赖：@segment/analytics-react-native \*
- 首次发布：2023-01-26T18:45:33.147Z
- 最新版本发布：2023-05-12T18:04:18.794Z
- 近 30 天下载量：44952（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

将 FullStory 与您的分解分析结合到您的 React-Native app 中.

## 安装

```sh
npm install @fullstory/segment-react-native-plugin-fullstory
```

也可以使用：`pnpm add @fullstory/segment-react-native-plugin-fullstory`、`yarn add @fullstory/segment-react-native-plugin-fullstory`、`bun add @fullstory/segment-react-native-plugin-fullstory`

## README

# @fullstory/segment-resact-native-plugin-fullstory (原始内容存档于2018-09-29)

[![CircleCI](https://circleci.com/gh/fullstorydev/segment-react-native-plugin-fullstory.svg?style=svg)](https://circleci.com/gh/fullstorydev/segment-react-native-plugin-fullstory)

`EnrichmentPlugin` 页:1 [完整的故事](https://www.fullstory.com/)。这是一个片段分析插件,可以包裹 [`@fullstory/react-native`](https://github.com/fullstorydev/fullstory-react-native)。 。 。 .

## 先决条件

### 建立完整的故事

请确保您的应用程序与 FullStory 正确设置 。 见 [FullStory 的回放原生文档](https://help.fullstory.com/hc/en-us/articles/360052419133-Getting-Started-with-FullStory-React-Native-Capture) 要开始.

### 设立分部

此插件与 `@segment/analytics-react-native`。后续部分 [安装指令](https://github.com/segmentio/analytics-react-native#installation)。 。 。 .

## 安装

安装 `@fullstory/segment-react-native-plugin-fullstory` 财务报告和审定财务报表 `@fullstory/react-native` 依赖性.

```bash
yarn add @fullstory/segment-react-native-plugin-fullstory @fullstory/react-native
# or
npm install --save @fullstory/segment-react-native-plugin-fullstory @fullstory/react-native
```

运行 `pod install` 安装后自动链接 FullStory SDK .

## 使用量

在您初始化分析客户端的代码中 `.add({ plugin })` 使用一个方法 `FullStoryPlugin` 举个例子.

```ts
// App.js

import { createClient } from '@segment/analytics-react-native';
import { FullStoryPlugin } from '@fullstory/segment-react-native-plugin-fullstory';

const segmentClient = createClient({
  writeKey: 'SEGMENT_WRITE_KEY',
});

const plugin = new FullStoryPlugin({
  // configurations
  enableFSSessionUrlInEvents: true,
});

segmentClient.add({ plugin });
```

### 配置

插件接受一个配置对象,其属性如下:

| 财产 | 说明 |
| --- | --- |
| 启用FS 会话UrlInEvents | 将 FS 会话 URL 插入到会话属性 。 默认为 `true`。 。 。 . |
| 允许列表全部跟踪事件 | 将所有音轨事件作为FS自定义事件发送. 默认为 `false`。 。 。 . |
| 启用识别事件 | 启用指定要作为 FS 识别事件发送的事件段 。 默认为 `true`。 。 。 . |
| 允许列表跟踪事件 | 允许发送到 FullStory 的一系列事件名称 。 允许列出所有事件, 使用 `allowlistAllTrackEvents`。 。 。 . |
| 启用 SendScreenAsEvents 程序 | 将屏幕事件作为FS自定义事件发送. 默认为 `false`。 。 。 . |
| 启用 GroupTraits 用户变量 | 允许将组事件特性传递到 FS 用户 vars 。 默认为 `false`。 。 。 . |

## 示例

我们包含一个简单的反应本地应用程序,在其中执行插件 `./example`。见 [实例README](https://npmcn.com/package/%40fullstory/segment-react-native-plugin-fullstory/example/README.md) 补充说明.

## 许可证

麻省理工学院

## 常见问题

### @fullstory/segment-react-native-plugin-fullstory 是什么？

将 FullStory 与您的分解分析结合到您的 React-Native app 中\.

### 如何安装 @fullstory/segment-react-native-plugin-fullstory？

在项目目录运行 npm install @fullstory/segment-react-native-plugin-fullstory，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@segment/analytics-react-native（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fullstory/segment-react-native-plugin-fullstory 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fullstory/segment-react-native-plugin-fullstory 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @fullstory/segment-react-native-plugin-fullstory 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=12。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fullstory/segment-react-native-plugin-fullstory 可以商用吗？

@fullstory/segment-react-native-plugin-fullstory 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fullstory/segment-react-native-plugin-fullstory 的下载量有多少？

根据 npm 官方下载统计，@fullstory/segment-react-native-plugin-fullstory 在 2026/10/16 – 2026/11/14 这 30 天内被下载 44,952 次，日均约 1,498 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fullstory/segment-react-native-plugin-fullstory 还在维护吗？

最新版本 1\.0\.1 发布于 2023/05/13（3 年前）；至今共发布 2 个版本，其中过去 12 个月发布了 0 个；首次发布于 2023/01/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。