# @extole/react-native-sdk 中文文档 规范地址：https://npmcn.com/package/%40extole/react-native-sdk/ 版本：1\.0\.34 npm 元数据更新时间：2026-11-13T09:41:20.782Z 中文译文更新时间：2026-11-14T06:00:04.107Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40extole/react-native-sdk 原文对照：https://npmcn.com/package/%40extole/react-native-sdk/?lang=original 项目主页：https://github.com/extole/react-native-sdk#readme 源码仓库：https://github.com/extole/react-native-sdk ## 关键信息（来自 npm 元数据） - 包体积（解压后）：279 kB，174 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：0 个 - peer 依赖：react \*，react-native \*，react-native-webview \*，@react-navigation/stack \*，@react-navigation/native \*，@react-navigation/native-stack \*，react-native-safe-area-context \* - 首次发布：2022-11-15T14:02:27.907Z - 最新版本发布：2026-11-13T09:41:20.538Z - 近 30 天下载量：4566（2026-10-14 至 2026-11-12，npm 官方下载统计） - 已发布版本数：34（近 12 个月 8 个） ## 中文简介 Extole 反应原生 SDK ## 安装 ```sh npm install @extole/react-native-sdk ``` 也可以使用：`pnpm add @extole/react-native-sdk`、`yarn add @extole/react-native-sdk`、`bun add @extole/react-native-sdk` ## README # Extole 反应原生 SDK 这个集成指南向您演示了如何与我们的Resact Industrial SDK一起尽快建立并启动一个Extole程序. ## 所需资源 Extole React Introduct SDK支持iOS 13.0或后期,而Android支持minSdkVersion 21或后期. ## 安装 SDK 依赖 添加数据 `extole-mobile-sdk` 依赖性 : ``` npm install @extole/react-native-sdk react-native-webview ``` 在iOS上,将Extole iOS SDK添加到应用程序中 `Podfile`在应用目标内部 CocoaPods干线没有SDK所需的版本,因此出自GitHub: ```ruby pod 'ExtoleMobileSDK', :git => 'https://github.com/extole/ios-sdk.git', :tag => '0.0.103' pod 'ExtoleConsumerAPI', :git => 'https://github.com/extole/ios-consumer-api.git', :tag => '0.0.24' ``` 然后,在 `ios` 目录, 运行 `pod install`。一个已经拥有这些被子的应用程序 `Podfile.lock` 运行 `pod update ExtoleMobileSDK ExtoleConsumerAPI extole-mobile-sdk` 换句话说. ## 初始化 SDK 初始化 extole : ``` import {Extole} from '@extole/extole-mobile-sdk'; const extole = new Extole('share.client.com'); ``` 您需要提供您的 Extole 程序域以取代 `'share.client.com'`。 。 。 . ## 初始化视图 在代码中,通过配置 `view` 和回调 : ``` const [extoleView, setExtoleView] = React.useState(); extole.configure(extoleView, setExtoleView, () => { navigation.navigate('Promo'); }); // Use the extole.view function ExtoleScreen(): ReactElement { return return extole.view as ReactElement; } // The ExtoleScreen() method is used as a Screen ``` 默认情况下,Extole会使用这个单一视图与客户互动. ## 与 extole 交换数据 ### 客户信息 发送关于客户的删除信息 : ``` extole.identify("", {"partner_user_id": "123"}) ``` 您可以选择通过任何类型的数据来描述客户. 关于你的客户的更丰富的数据 给了你的营销团队 他们需要的信息 更好地划分你的程序参与者 并以适当的运动瞄准他们. ### 活动 发送删除事件, 如注册、 签名、 转换、 账户打开等 : ``` extole.sendEvent("cta_viewed", {"key": "value"})) ``` 对于每个事件类型,可以发送额外数据. 例如,在转换事件上,您可能想要通过,以排列ID或顺序值等. ### 行动呼吁内容 使用 Extole 的内容发布一个行动呼吁( CTA) . 移动菜单项目等CTA可以在"我的Extole Campaign"编辑器中完全定制. 每个CTA都有指定区. 以下代码是通过取取区内容来取回CTA的例子: ``` const [zone, setZone] = React.useState(null); React.useEffect(() => { extole .fetchZone('mobile_cta') .then(([zone, _campaign]) => { setZone(zone); }); }, []); // On CTA tap send the event to Extole const onShareButtonPress = () => { extole.sendEvent(cta?.touch_event, { extole_zone_name: 'microsite' }); }; . . . // Usage example: ', }} />