Salta al contenuto principale
@capgo/capacitor-rudderstack Analytics Open source

RudderStack Plugin Capacitor

Analytics, identity resolution, screen tracking e controlli di delivery di RudderStack per Capacitor

Installa

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

Guida

Come usare RudderStack in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

Anteprima QR plugin RudderStack code

Utilizzo di @capgo/capacitor-rudderstack

Capacitor API che rispecchia la superficie pubblica di rudder-sdk-cordova.

Installa

bun add @capgo/capacitor-rudderstack
bunx cap sync

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

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

API in breve

Metodo Descrizione
initialize Inizializza il client RudderStack.
identify Invia una chiamata identify per l'id utente fornito.
group Invia una chiamata group per l'id gruppo fornito.
track Invia una chiamata track per il nome dell'evento fornito.
screen Invia una chiamata screen per il nome della schermata fornito.
alias Crea un alias dell'utente corrente con un nuovo identificatore.
reset Resetta lo stato corrente dell'identità RudderStack.
flush Svuota immediatamente gli eventi in coda.
putDeviceToken Imposta il push token che RudderStack inoltra alle destinazioni supportate.
setAdvertisingId Consulta le definizioni sorgente per il comportamento attuale.
putAdvertisingId Sets a custom advertising id value.
setAnonymousId Consulta le definizioni sorgente per il comportamento attuale.
putAnonymousId Sets a custom anonymous id value.
optOut Toggles RudderStack tracking opt-out.

Esempi

initialize()

Inizializza il client RudderStack.

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

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

identify()

Invia una chiamata identify per l'id utente fornito.

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

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

group()

Invia una chiamata group per l'id gruppo fornito.

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

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

track()

Invia una chiamata track per il nome dell'evento fornito.

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

await nativePlugin.track('event');

screen()

Invia una chiamata screen per il nome della schermata fornito.

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

await nativePlugin.screen('screen');

alias()

Crea un alias dell'utente corrente con un nuovo identificatore.

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

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

La tabella sopra elenca i 14 metodi principali. I listener e gli helper di versione, insieme al contratto completo di ogni metodo, sono documentati nella repository GitHub.

Riferimento completo

Continua da Usare @capgo/capacitor-rudderstack

Se stai usando Utilizzo di @capgo/capacitor-rudderstack per pianificare le operazioni della dashboard e di API, collegalo a @capgo/capacitor-rudderstack per i dettagli di implementazione in @capgo/capacitor-rudderstack, Per iniziare per i dettagli di implementazione nella guida introduttiva, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, e Chiavi API per i dettagli implementativi in API Keys.

FAQ

FAQ sul plugin RudderStack

Come installo il plugin RudderStack in un'app Capacitor?

Esegui "bun add @capgo/capacitor-rudderstack" (o "npm install @capgo/capacitor-rudderstack"), poi lancia "bunx cap sync" in modo che i progetti iOS e Android integrino il code nativo. Importalo da "@capgo/capacitor-rudderstack" nel code della tua app.

@capgo/capacitor-rudderstack funziona con React, Vue e Angular?

Sì. RudderStack è un pacchetto Capacitor, quindi funziona con qualsiasi web framework in esecuzione all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-rudderstack?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-rudderstack è gratuito e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-rudderstack/ e il pacchetto si può installare gratuitamente da npm. Segnalazioni di bug e pull request sono benvenute.

Posso aggiornare code che utilizza RudderStack senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Distribuisci modifiche a RudderStack senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo