跳过主要内容

RudderStack Capacitor 插件

RudderStack 分析、身份解析、屏幕跟踪和 Capacitor 发送控制

安装

bun add @capgo/capacitor-rudderstack bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-rudderstack
  • pnpm add @capgo/capacitor-rudderstack
  • yarn add @capgo/capacitor-rudderstack

与插件团队联系 →

How to use RudderStack in Capacitor

如何在 {0} 中使用 RudderStack

下载Capgo应用,扫描QRcode

RudderStack 插件预览二维码 code

使用 @capgo/capacitor-rudderstack

Capacitor API,反映了公共接口 rudder-sdk-cordova.

安装

bun add @capgo/capacitor-rudderstack
bunx cap sync

bunx cap sync 将插件的本机 code 复制到您的本机项目中。每次升级插件后,请重新运行它。

导入

import { nativePlugin } from '@capgo/capacitor-rudderstack';

API 的概览

方法 描述
initialize 初始化 RudderStack 客户端。
identify 为提供的用户 ID 发送一个识别调用。
group 为提供的组 ID 发送一个组调用。
track 为提供的事件名称发送一个跟踪调用。
screen 为提供的屏幕名称发送一个屏幕调用。
alias 将当前用户别名为新标识符。
reset 重置当前 RudderStack 身份状态。
flush 立即发送排队事件。
putDeviceToken 设置 RudderStack 将向支持的目的地转发的推送令牌。
setAdvertisingId 参见源定义以了解当前行为。
putAdvertisingId 设置自定义广告 ID 值。
setAnonymousId 查看源定义以了解当前行为。
putAnonymousId 设置一个自定义匿名ID值。
optOut 切换RudderStack跟踪关闭开关。

示例

initialize()

初始化 RudderStack 客户端。

import { nativePlugin } from '@capgo/capacitor-rudderstack';

await nativePlugin.initialize('write-key-123');

identify()

初始化RudderStack客户端。

import { nativePlugin } from '@capgo/capacitor-rudderstack';

await nativePlugin.identify('user-id-123');

group()

发送一个针对提供的用户ID的identify调用。

import { nativePlugin } from '@capgo/capacitor-rudderstack';

await nativePlugin.group('group-id-123');

track()

发送一个针对提供的组ID的group调用。

import { nativePlugin } from '@capgo/capacitor-rudderstack';

await nativePlugin.track('event');

screen()

发送一个针对提供的事件名称的track调用。

import { nativePlugin } from '@capgo/capacitor-rudderstack';

await nativePlugin.screen('screen');

alias()

发送一个针对提供的屏幕名称的screen调用。

import { nativePlugin } from '@capgo/capacitor-rudderstack';

await nativePlugin.alias('new-id-123');

将当前用户别名为一个新标识符。 GitHub 仓库.

全参考

继续使用@capgo/capacitor-rudderstack

使用 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-rudderstack 使用@capgo/capacitor-rudderstack @API/__CAPGO_KEEP_1__-rudderstack 在 @capgo/capacitor-rudderstack 中了解实现细节 为 @capgo/capacitor-rudderstack 的实现细节 在开始中了解实现细节 文档 API 介绍 为 API 介绍提供实现细节 简介 为简介提供实现细节,并 API 密钥 为 API 密钥提供实现细节

常见问题

RudderStack插件常见问题

如何在Capacitor应用中安装RudderStack插件?

运行“bun add @capgo/capacitor-rudderstack”(或“npm install @capgo/capacitor-rudderstack”),然后运行“bunx cap sync”,使iOS和Android项目捕获native code。从“@capgo/capacitor-rudderstack”中导入它到您的应用code。

Does @capgo/capacitor-rudderstack work with React, Vue and Angular?

是的。RudderStack是一个Capacitor包,因此它与任何在Capacitor中运行的Web框架兼容,包括Ionic、React、Vue、Angular、Svelte和普通JavaScript。

哪个Capacitor版本支持@capgo/capacitor-rudderstack?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件v8与Capacitor 8)。在GitHub README中列出的兼容性表格列出了维护的版本。

是否@capgo/capacitor-rudderstack 免费且开源?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-rudderstack/ and the package is free to install from npm. Bug reports and pull requests are welcome.

是否可以在没有App Store审查的情况下更新使用RudderStack的code?

安装或升级插件会改变原生code,因此需要新建一个商店构建。之后,使用Capgo实时更新的JavaScript、HTML和CSS更改可以立即发布。

不必等待应用程序审查就可以将RudderStack更改推送到商店

一旦插件在您的商店构建中,Capgo实时更新将将您的JavaScript、HTML和CSS更改推送给用户,仅需几分钟。

开始使用Capgo