メインコンテンツへスキップ
@capgo/capacitor-rudderstack アナリティクス オープンソース

RudderStack Capacitor プラグイン

Capacitor 向けの RudderStack 分析、ID 解決、スクリーントラッキング、配信コントロール

インストール

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

ガイド

Capacitor で RudderStack を使う方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

RudderStack プラグインのプレビュー QR code

@capgo/capacitor-rudderstack の使用

Capacitor API(…の公開 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でidentifyコールを送信します。
group 指定したグループIDでgroupコールを送信します。
track 指定したイベント名でtrackコールを送信します。
screen 指定したスクリーン名でscreenコールを送信します。
alias 現在のユーザーを新しい識別子にエイリアスします。
reset 現在のRudderStackのアイデンティティ状態をリセットします。
flush キューに溜まっているイベントを即座にフラッシュします。
putDeviceToken RudderStackがサポートされている送信先に転送するプッシュトークンを設定します。
setAdvertisingId 現在の動作については、ソースの定義を参照してください。
putAdvertisingId カスタムの広告ID(advertising id)を設定します。
setAnonymousId 現在の動作については、ソースの定義を参照してください。
putAnonymousId カスタムの匿名IDを設定します。
optOut RudderStackのトラッキングオプトアウトを切り替えます。

例

initialize()

RudderStackクライアントを初期化します。

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

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

identify()

指定したユーザーIDでidentifyコールを送信します。

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

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

group()

指定したグループIDでgroupコールを送信します。

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

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

track()

指定したイベント名でtrackコールを送信します。

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

await nativePlugin.track('event');

screen()

指定したスクリーン名でscreenコールを送信します。

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

await nativePlugin.screen('screen');

alias()

現在のユーザーを新しい識別子にエイリアスします。

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

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

上記の表は14個のコアメソッドをまとめたものです。リスナーとバージョンのヘルパー、および各メソッドの完全な仕様については、以下で説明しています。 GitHub リポジトリ.

完全なリファレンス

@capgo/capacitor-rudderstack の使用方法から

使用している場合 @capgo/capacitor-rudderstack の使用 ダッシュボードと API の運用を計画するには、これを次と連携させます @capgo/capacitor-rudderstack @capgo/capacitor-rudderstack の実装の詳細については、 スタートガイド スタートガイドの実装詳細については、 API の概要 「API の概要」の実装の詳細については、 はじめに はじめにの実装詳細、および API キー API Keys の実装詳細については、

よくある質問

RudderStack プラグイン FAQ

Capacitor アプリに RudderStack プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-rudderstack" (または "npm install @capgo/capacitor-rudderstack") を実行した後、"bunx cap sync" を実行して、iOS および Android プロジェクトにネイティブの code を反映させてください。その後、アプリの code から "@capgo/capacitor-rudderstack" をインポートします。

@capgo/capacitor-rudderstack は React、Vue、Angular で動作しますか?

はい。RudderStack は Capacitor パッケージであるため、Ionic、React、Vue、Angular、Svelte、およびプレーンな JavaScript を含む、Capacitor 内で動作するあらゆる Web フレームワークで使用できます。

@capgo/capacitor-rudderstack はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-rudderstack は無料のオープンソースですか?

はい。code のソースは GitHub の https://github.com/Cap-go/capacitor-rudderstack/ で公開されており、npm から無料でインストールできます。バグ報告やプルリクエストも歓迎します。

App Store の審査なしで、RudderStack を使用している code をアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずに RudderStack の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める