# @adobe/react-native-acpanalytics 中文文档

规范地址：https://npmcn.com/package/%40adobe/react-native-acpanalytics/

版本：2\.0\.1
npm 元数据更新时间：2026-10-01T01:34:03.055Z
中文译文更新时间：2026-11-06T14:32:42.435Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40adobe/react-native-acpanalytics
原文对照：https://npmcn.com/package/%40adobe/react-native-acpanalytics/?lang=original
项目主页：https://aep-sdks.gitbook.io/docs/
源码仓库：https://github.com/adobe/react-native-acpanalytics

弃用说明：Package no longer supported \(underlying SDK deprecated\)

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

- 包体积（解压后）：424 kB，41 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：react-native \>=0\.60\.0，@adobe/react-native-acpcore \>=2\.0\.0
- 首次发布：2019-04-03T16:17:16.009Z
- 最新版本发布：2022-04-28T20:53:49.609Z
- 近 30 天下载量：2987（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：58（近 12 个月 0 个）

## 中文简介

Adobe体验平台支持回放原生应用程序.

## 安装

```sh
npm install @adobe/react-native-acpanalytics
```

也可以使用：`pnpm add @adobe/react-native-acpanalytics`、`yarn add @adobe/react-native-acpanalytics`、`bun add @adobe/react-native-acpanalytics`

## README

# 反应原生AEP 分析扩展

[![npm version](https://badge.fury.io/js/%40adobe%2Freact-native-acpanalytics.svg)](https://www.npmjs.com/package/@adobe/react-native-acpanalytics) [![npm downloads](https://img.shields.io/npm/dm/@adobe/react-native-acpanalytics)](https://www.npmjs.com/package/@adobe/react-native-acpanalytics) [![CircleCI](https://img.shields.io/circleci/project/github/adobe/react-native-acpanalytics/main.svg?logo=circleci)](https://circleci.com/gh/adobe/workflows/react-native-acpanalytics) [![license](https://img.shields.io/npm/l/@adobe/react-native-acpanalytics.svg)](https://github.com/adobe/react-native-acpanalytics/blob/main/LICENSE)

`@adobe/react-native-acpanalytics` iOS、tvOS和Android周围的包装器 [AEP 分析SDK](https://aep-sdks.gitbook.io/docs/using-mobile-extensions/adobe-analytics) 允许与 React Industrial 应用程序融合。 实现Adobe Analytics的功能完全通过下文所记载的JavaScript提供.

## 安装

安装 SDK 以 [无](https://www.npmjs.com/) 并配置本地的Android/iOS项目。 在安装分析扩展之前,建议首先安装 [核心扩展](https://github.com/adobe/react-native-acpcore)。 。 。 .

> 注意:如果你是新来的,我们建议你遵循 [启动原生状态](https://facebook.github.io/react-native/docs/getting-started.html) 继续前页.

### 1\. 创建反应土著项目

首先创建 React 本地项目 :

```bash
react-native init MyReactApp
```

> 注:随行 [反应原生 tvos 支持](https://reactnative.dev/blog/2020/03/26/version-0.62#moving-apple-tv-to-react-native-tvos) 用 tvos 目标创建应用程序.

### 2\. 安装 JavaScript 软件包

安装和链接 `@adobe/react-native-acpanalytics` 软件包 :

```bash
cd MyReactApp
npm install @adobe/react-native-acpanalytics
```

#### 2.1 链接

-   **反应原生0.60+**

[CLI 自动链接功能](https://github.com/react-native-community/cli/blob/master/docs/autolinking.md) 在构建应用程序时链接模块.

-   **原生反应 0.59**

```bash
react-native link @adobe/react-native-acpanalytics
```

_说明_ 对于 `iOS` 使用 `cocoapods`,运行 :

```bash
cd ios/ && pod install
```

## 测试

这个项目包含在《公约》第2条(a)项中包含的笑话单元测试 `__tests__` 目录,用于在本地运行测试 :

```
make run-tests-locally
```

## 使用量

### [分析](https://aep-sdks.gitbook.io/docs/using-mobile-extensions/adobe-analytics)

#### 导入扩展名 :

```javascript
import {ACPAnalytics} from '@adobe/react-native-acpanalytics';
```

#### 获取扩展版本 :

```javascript
ACPAnalytics.extensionVersion().then(version => console.log("AdobeExperienceSDK: ACPAnalytics version: " + version));
```

#### 在 ACPCore 注册扩展 :

建议通过您的 AppDelegate 和 MainApplication 分别在 iOS 和 Android 中通过本地代码初始化 SDK .

##### **iOS系统**

```objective-c
#import <ACPAnalytics.h>

[ACPAnalytics registerExtension];
```

##### **机器人:**

```java
import com.adobe.marketing.mobile.Analytics;

Analytics.registerExtension();
```

#### 获取跟踪标识符 :

```javascript
ACPAnalytics.getTrackingIdentifier().then(identifier => console.log("AdobeExperienceSDK: Tracking identifier: " + identifier));
```

#### 发送已队列点击 :

```javascript
ACPAnalytics.sendQueuedHits();
```

#### 获取队列大小 :

```javascript
ACPAnalytics.getQueueSize().then(size => console.log("AdobeExperienceSDK: Queue size: " + size));
```

#### 清除已排队的点击 :

```javascript
ACPAnalytics.clearQueue();
```

#### 设置自定义访客标识符 :

```javascript
ACPAnalytics.setVisitorIdentifier("yourVisitorId");
```

#### 获取自定义访客标识 :

```javascript
ACPAnalytics.getVisitorIdentifier().then(vid => console.log("AdobeExperienceSDK: Visitor identifier: " + vid));
```

#### 跟踪应用动作 :

```javascript
ACPCore.trackAction("action", {"mytest": "action"});
```

#### 音轨应用程序 :

```javascript
ACPCore.trackState("state", {"mytest": "state"});
```

## 捐款

见 [捐款](https://npmcn.com/package/%40adobe/react-native-acpanalytics/CONTRIBUTING.md)

## 许可证

见 [自由主义](https://npmcn.com/package/%40adobe/react-native-acpanalytics/LICENSE)

## 常见问题

### @adobe/react-native-acpanalytics 是什么？

Adobe体验平台支持回放原生应用程序\.注意：该包已被作者标记为弃用——Package no longer supported \(underlying SDK deprecated\)

### 如何安装 @adobe/react-native-acpanalytics？

在项目目录运行 npm install @adobe/react-native-acpanalytics，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react-native（\>=0\.60\.0）、@adobe/react-native-acpcore（\>=2\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @adobe/react-native-acpanalytics 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adobe\_\_react-native-acpanalytics 是否存在。

### @adobe/react-native-acpanalytics 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @adobe/react-native-acpanalytics 可以商用吗？

@adobe/react-native-acpanalytics 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @adobe/react-native-acpanalytics 的下载量有多少？

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

### @adobe/react-native-acpanalytics 还在维护吗？

最新版本 2\.0\.1 发布于 2022/04/29（4 年前）；至今共发布 58 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/04/04。作者已将其标记为弃用，新项目建议寻找替代方案。