はじめに
このプラグインのインストール手順とフル マークダウン ガイドを含むセットアップ コマンドをコピーします。
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-rudderstack`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/rudderstack/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
インストール
「インストール」というタイトルのセクションbun add @capgo/capacitor-rudderstackbunx cap syncインポート
「インポート」のセクションimport { nativePlugin } from '@capgo/capacitor-rudderstack';APIの概要
「APIの概要」のセクションinitialize
「initialize」のセクションRudderStackクライアントを初期化します。
メソッドはCordovaの署名を保持するため、2番目の引数はconfigオブジェクトかRudderオプションオブジェクトのいずれかになります。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.initialize('value');identify
「identify」のセクション指定されたユーザーIDのためにidentifyコールを送信します。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.identify('value');group
グループセクション指定されたグループIDに対してグループコールを送信します。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.group('value');track
トラッキングセクション指定されたイベント名に対してトラッキングコールを送信します。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.track('value');screen
スクリーンセクション指定されたスクリーン名に対してスクリーンコールを送信します。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.screen('value');alias
エイリアスセクション現在のユーザーを新しい識別子にエイリアスします。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.alias('value');reset
「リセット」セクション現在のルーダースタック ID をリセットします。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.reset();flush
「フラッシュ」セクションキュー内のイベントを即時フラッシュします。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.flush();putDeviceToken
「デバイス トークンを設定」セクションRudderStack がサポートするすべての宛先に転送するデバイス トークンを設定します。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.putDeviceToken('value');setAdvertisingId
「広告 ID を設定」セクション現在の契約のソース定義を参照してください。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.setAdvertisingId('value');putAdvertisingId
「putAdvertisingId」セクションカスタム広告IDの値を設定します。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.putAdvertisingId('value');setAnonymousId
「setAnonymousId」セクション現在の契約のソース定義を参照してください。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.setAnonymousId('value');putAnonymousId
「putAnonymousId」セクションカスタム匿名IDの値を設定します。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.putAnonymousId('value');optOut
「optOut」セクションRudderStack トラッキングのオプトアウトを切り替えます。
import { nativePlugin } from '@capgo/capacitor-rudderstack';
await nativePlugin.optOut(true);__CAPGO_KEEP_1__
__CAPGO_KEEP_2__RudderConfiguration
__CAPGO_KEEP_3____CAPGO_KEEP_4__
export interface RudderConfiguration { /** * RudderStack data plane URL. */ dataPlaneUrl?: string;
/** * Number of events to batch before a flush. */ flushQueueSize?: number;
/** * Database row threshold that triggers pruning on Android and iOS. */ dbCountThreshold?: number;
/** * Server config refresh interval in hours. */ configRefreshInterval?: number;
/** * RudderStack log verbosity. */ logLevel?: RudderLogLevelValue;
/** * Sleep timeout / sleep count used by the native SDK. */ sleepTimeOut?: number;
/** * Android only. Lets the native SDK collect the advertising identifier automatically. */ autoCollectAdvertId?: boolean;
/** * Tracks `Application Installed`, `Application Updated`, and `Application Opened` automatically. */ trackLifecycleEvents?: boolean;
/** * RudderStack control plane URL. */ controlPlaneUrl?: string;
/** * Enables automatic screen tracking where supported by the native SDK. */ recordScreenViews?: boolean;
/** * Ignored in this Capacitor port. * * The Cordova SDK uses this field to bootstrap native destination factories from companion plugins. * Those extension packages are not implemented in this first Capacitor release. */ factories?: any[];}RudderOptions
__CAPGO_KEEP_2____CAPGO_KEEP_5__
export interface RudderOptions { /** * External identifiers forwarded with the event. */ externalIds?: Record<string, string>;
/** * Destination enablement flags keyed by integration name. */ integrations?: Record<string, boolean>;}RudderTraits
__CAPGO_KEEP_7____CAPGO_KEEP_8__ identify __CAPGO_KEEP_9__ group.
export type RudderTraits = Record<string, any>;RudderProperties
「RudderProperties」のセクション受け入れられるプロパティのペイロード track と screen.
export type RudderProperties = Record<string, any>;PluginVersionResult
「PluginVersionResult」のセクションプラグインバージョンのペイロード。
export interface PluginVersionResult { /** * Version identifier returned by the platform implementation. */ version: string;}RudderLogLevelValue
「RudderLogLevelValue」のセクションRudderStackのログレベル値がmigrationのために公開されています。
export type RudderLogLevelValue = 0 | 1 | 2 | 3 | 4 | 5;このページはプラグインの src/definitions.tsパブリック API がアップストリームで変更されたときに、再度同期を実行してください。