Langsung ke konten utama
@capgo/capacitor-rudderstack Analitik Open source

RudderStack plugin Capacitor

Analytics RudderStack, identity resolution, screen tracking, dan kontrol delivery untuk Capacitor

Instal

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

Panduan

Cara menggunakan RudderStack di Capacitor

Tes di perangkat

Download aplikasi Capgo, lalu scan QR code.

QR code pratinjau plugin RudderStack

Menggunakan @capgo/capacitor-rudderstack

Capacitor API yang mencerminkan tampilan publik dari rudder-sdk-cordova.

Instal

bun add @capgo/capacitor-rudderstack
bunx cap sync

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.

Impor

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

Sekilas tentang API

Metode Deskripsi
initialize Menginisialisasi client RudderStack.
identify Mengirim panggilan identify untuk user id yang diberikan.
group Mengirim panggilan group untuk group id yang diberikan.
track Mengirim panggilan track untuk nama event yang diberikan.
screen Mengirim panggilan screen untuk nama screen yang diberikan.
alias Membuat alias user saat ini ke identifier baru.
reset Mereset state identitas RudderStack saat ini.
flush Segera flush event yang mengantre.
putDeviceToken Mengatur push token yang diteruskan RudderStack ke destinasi yang didukung.
setAdvertisingId Lihat definisi di source untuk perilaku saat ini.
putAdvertisingId Mengatur nilai advertising id kustom.
setAnonymousId Lihat definisi di source untuk perilaku saat ini.
putAnonymousId Mengatur nilai anonymous id kustom.
optOut Mengaktifkan opsi opt-out pelacakan RudderStack.

Contoh

initialize()

Menginisialisasi client RudderStack.

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

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

identify()

Mengirim panggilan identify untuk user id yang diberikan.

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

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

group()

Mengirim panggilan group untuk group id yang diberikan.

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

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

track()

Mengirim panggilan track untuk nama event yang diberikan.

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

await nativePlugin.track('event');

screen()

Mengirim panggilan screen untuk nama screen yang diberikan.

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

await nativePlugin.screen('screen');

alias()

Membuat alias user saat ini ke identifier baru.

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

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

Tabel di atas mencantumkan 14 metode inti. Helper listener, versi, dan kontrak lengkap setiap metode didokumentasikan di repositori GitHub.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-rudderstack

Jika Anda menggunakan Menggunakan @capgo/capacitor-rudderstack untuk merencanakan operasi dashboard dan API, hubungkan dengan @capgo/capacitor-rudderstack untuk detail implementasi di @capgo/capacitor-rudderstack, Panduan Memulai untuk detail implementasi di Getting Started, Ringkasan API untuk detail implementasi di API Overview, Pendahuluan untuk detail implementasi di Introduction, dan Kunci API untuk detail implementasi di API Keys.

FAQ

FAQ plugin RudderStack

Bagaimana cara install plugin RudderStack di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-rudderstack" (atau "npm install @capgo/capacitor-rudderstack"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Import dari "@capgo/capacitor-rudderstack" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-rudderstack mendukung React, Vue, dan Angular?

Ya. RudderStack adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript murni.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-rudderstack?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-rudderstack gratis dan open source?

Ya. Source code bersifat publik di GitHub pada https://github.com/Cap-go/capacitor-rudderstack/ dan paket ini gratis diinstal via npm. Bug report dan pull request sangat kami terima.

Bisakah saya memperbarui code yang menggunakan RudderStack tanpa melalui review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan RudderStack tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo