Saltare al contenuto principale
@capgo/capacitor-rudderstack Analisi Sorgente aperta

RudderStack Plugin Capacitor

RudderStack analytics, risoluzione identità, tracciamento schermo e controlli di consegna 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 utilizzare RudderStack in Capacitor

Testa sul dispositivo

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

Anteprima del plugin RudderStack QR code

Utilizza @capgo/capacitor-rudderstack

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

Installa

bun add @capgo/capacitor-rudderstack
bunx cap sync

bunx cap sync copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

API in un colpo d'occhio

Metodo Descrizione
initialize Inizializza il client RudderStack.
identify Invia un chiamata di identificazione per l'ID utente fornito.
group Invia una chiamata di gruppo per l'ID gruppo fornito.
track Invia una chiamata di tracciamento per il nome evento fornito.
screen Invia una chiamata di schermo per il nome schermo fornito.
alias Alias l'utente corrente a un nuovo identificatore.
reset Ripristina lo stato di identità RudderStack corrente.
flush Invia gli eventi in coda immediatamente.
putDeviceToken Imposta il token di push che RudderStack invia ai destinazioni supportate.
setAdvertisingId Vedi le definizioni di origine per il comportamento corrente.
putAdvertisingId Sets a custom advertising id value.
setAnonymousId Vedi le definizioni di origine per il comportamento corrente.
putAnonymousId Imposta un valore di ID anonimo personalizzato.
optOut Abilita l'opt-out di tracciamento di RudderStack.

Esempi

initialize()

Inizializza il client RudderStack.

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

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

identify()

Invia una chiamata di identificazione per l'ID utente fornito.

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

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

group()

Invia un evento di identificazione per l'ID utente fornito.

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

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

track()

Invia un evento di gruppo per l'ID di gruppo fornito.

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

await nativePlugin.track('event');

screen()

Spedisce una chiamata di schermo per il nome dello schermo fornito.

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

await nativePlugin.screen('screen');

alias()

Alias il corrente utente a un nuovo identificatore.

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

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

La tabella sopra elenca le 14 metodi di base. Gli ascoltatori e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel repository di GitHub.

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-rudderstack

Se stai utilizzando Utilizzo di @capgo/capacitor-rudderstack per pianificare il dashboard e le operazioni di API, connettilo con @capgo/capacitor-rudderstack per i dettagli di implementazione in @capgo/capacitor-rudderstack Getting Started per i dettagli di implementazione in Iniziare Panoramica di API per i dettagli di implementazione in Panoramica di API Introduzione per i dettagli di implementazione in Introduzione, e Chiavi di API per i dettagli di implementazione in Chiavi di API

FAQ

Domande frequenti sul plugin RudderStack

Come posso installare il plugin RudderStack in un'app Capacitor?

Esegui "bun add @capgo/capacitor-rudderstack" (o "npm install @capgo/capacitor-rudderstack"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino i progetti nativi code. Importalo da "@capgo/capacitor-rudderstack" nella tua app code.

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

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

Quale versione Capacitor supporta @capgo/capacitor-rudderstack?

Capgo plugin seguono la versione maggiore di Capacitor: utilizzare la versione maggiore del plugin che corrisponde alla tua versione maggiore 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 è gratuito per l'installazione da npm. I rapporti di bug e le richieste di pull sono graditi.

Posso aggiornare code che utilizza RudderStack senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il code nativo, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spedite immediatamente con gli aggiornamenti live di Capgo.

Invia le modifiche di RudderStack senza dover attendere la revisione dell'app

Una volta che il plugin è presente nella tua store build, le Capgo live updates inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti.

Avvia con Capgo