Zum Hauptinhalt springen
@capgo/capacitor-rudderstack Analytics Open Source

RudderStack Capacitor Plugin

RudderStack Analytics, Identity Resolution, Screen-Tracking und Delivery-Controls für Capacitor

Installieren

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

Anleitung

RudderStack in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

RudderStack-Plugin-Vorschau QR code

@capgo/capacitor-rudderstack verwenden

Capacitor API, das die öffentliche Oberfläche von rudder-sdk-cordova.

Installieren

bun add @capgo/capacitor-rudderstack
bunx cap sync

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

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

API auf einen Blick

Methode Beschreibung
initialize Initialisiert den RudderStack-Client.
identify Sendet einen identify-Call für die angegebene User-ID.
group Sendet einen group-Call für die angegebene Group-ID.
track Sendet einen track-Call für den angegebenen Event-Namen.
screen Sendet einen screen-Call für den angegebenen Screen-Namen.
alias Setzt einen Alias für den aktuellen User auf eine neue ID.
reset Setzt den aktuellen RudderStack-Identitätsstatus zurück.
flush Flusht gepufferte Events sofort.
putDeviceToken Setzt den Push-Token, den RudderStack an unterstützte Ziele weiterleitet.
setAdvertisingId Zum aktuellen Verhalten siehe die Definitionen im Quellcode.
putAdvertisingId Setzt einen benutzerdefinierten Advertising-ID-Wert.
setAnonymousId Zum aktuellen Verhalten siehe die Definitionen im Quellcode.
putAnonymousId Setzt einen benutzerdefinierten anonymen ID-Wert.
optOut Schaltet das Opt-out für das RudderStack-Tracking um.

Beispiele

initialize()

Initialisiert den RudderStack-Client.

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

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

identify()

Sendet einen identify-Call für die angegebene User-ID.

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

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

group()

Sendet einen group-Call für die angegebene Group-ID.

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

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

track()

Sendet einen track-Call für den angegebenen Event-Namen.

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

await nativePlugin.track('event');

screen()

Sendet einen screen-Call für den angegebenen Screen-Namen.

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

await nativePlugin.screen('screen');

alias()

Setzt einen Alias für den aktuellen User auf eine neue ID.

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

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

Die obige Tabelle listet die 14 Kernmethoden auf. Listener- und Versions-Helper sowie der vollständige Contract jeder Methode sind in der GitHub Repository.

Vollständige Referenz

Weiterlesen unter Verwendung von @capgo/capacitor-rudderstack

Wenn du es nutzt @capgo/capacitor-rudderstack verwenden um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-rudderstack für die Implementierungsdetails in @capgo/capacitor-rudderstack, Erste Schritte für die Implementierungsdetails in Erste Schritte, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung und API Schlüssel für die Implementierungsdetails in den API Keys.

FAQ

RudderStack Plugin FAQ

Wie installiere ich das RudderStack Plugin in einer Capacitor App?

Führe "bun add @capgo/capacitor-rudderstack" (oder "npm install @capgo/capacitor-rudderstack") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-rudderstack".

Funktioniert @capgo/capacitor-rudderstack mit React, Vue und Angular?

Ja. RudderStack ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version wird von @capgo/capacitor-rudderstack unterstützt?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-rudderstack kostenlos und Open Source?

Ja. Der code Source ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-rudderstack/ verfügbar und das Package kann kostenlos über npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit RudderStack aktualisieren, ohne ein App Store Review abzuwarten?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

RudderStack-Änderungen deployen, ohne auf das App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo