Allez directement au contenu principal

RudderStack plugin Capacitor

Analytiques, résolution d'identité, suivi d'écran et contrôles de livraison pour Capacitor

Installer

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

Guide

Comment utiliser RudderStack dans Capacitor

Testez sur appareil

Téléchargez l'application Capgo, puis scannez le code QR code.

Prévisualisation du plugin RudderStack QR code

Utilisez @capgo/capacitor-rudderstack

Capacitor API qui reflète la surface publique de rudder-sdk-cordova.

Installer

bun add @capgo/capacitor-rudderstack
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.

Importer

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

API en un coup d'œil

Méthode Description
initialize Initialise le client RudderStack.
identify Envoie un appel d'identification pour l'identifiant utilisateur fourni.
group Envoie un appel de groupe pour l'identifiant de groupe fourni.
track Envoie un appel de suivi pour le nom de l'événement fourni.
screen Envoie un appel d'écran pour le nom de l'écran fourni.
alias Alias l’utilisateur actuel à un nouveau identifiant.
reset Réinitialise l'état d'identité RudderStack actuel.
flush Flushes queued events immediately.
putDeviceToken Définit le jeton de push que RudderStack transmet aux destinations prises en charge.
setAdvertisingId Consultez les définitions source pour connaître le comportement actuel.
putAdvertisingId Définit une valeur d'ID publicitaire personnalisée.
setAnonymousId Consultez les définitions source pour connaître le comportement actuel.
putAnonymousId Configurez une valeur d'ID anonyme personnalisée.
optOut Téléchargez l'option de suivi RudderStack.

Exemples

initialize()

Initialise le client RudderStack.

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

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

identify()

Envoie une demande d'identification pour l'ID utilisateur fourni.

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

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

group()

Envoie un appel de groupe pour l'identifiant de groupe fourni.

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

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

track()

Envoie un appel d'identification pour l'ID utilisateur fourni.

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

await nativePlugin.track('event');

screen()

Envoie un appel de groupe pour l'ID de groupe fourni.

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

await nativePlugin.screen('screen');

alias()

Envoie un appel de suivi pour le nom d'événement fourni.

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

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

La table ci-dessus liste les 14 méthodes de base. Les aides pour les listeners et les versions, ainsi que la pleine convention de chaque méthode, sont documentées dans le le dépôt GitHub.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-rudderstack

Si vous utilisez L'utilisation de @capgo/capacitor-rudderstack pour planifier le tableau de bord et les opérations de API, connectez-l’à @capgo/capacitor-RudderStack pour les détails d'implémentation dans @capgo/capacitor-rudderstack Prise en main pour les détails d'implémentation dans Prise en main Vue d'ensemble de API pour les détails d'implémentation dans API Vue d'ensemble, Introduction pour les détails d'implémentation dans l'Introduction, et API Clés pour les détails d'implémentation dans API Clés.

FAQ

Foire aux questions

Comment installez-vous le plugin RudderStack dans une application Capacitor ?

Run "bun add @capgo/capacitor-rudderstack" (or "npm install @capgo/capacitor-rudderstack"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-rudderstack" in your app code.

Est-ce que @capgo/capacitor-rudderstack fonctionne avec React, Vue et Angular ?

Yes. RudderStack is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-rudderstack ?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

Est-ce que @capgo/capacitor-rudderstack est gratuit et open source ?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-rudderstack/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Puis-je mettre à jour code qui utilise RudderStack sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif code, il faut donc une nouvelle build de l'application. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo en direct.

Envoyez les modifications de RudderStack sans attendre la revue de l'application

Une fois le plugin dans votre magasin de build, les mises à jour Capgo en direct poussent vos modifications JavaScript, HTML et CSS vers les utilisateurs en quelques minutes.

Démarrer avec Capgo