Aller au contenu principal
@capgo/capacitor-rudderstack Statistiques Open source

RudderStack Plugin Capacitor

Analytics RudderStack, résolution d'identité, suivi des écrans et contrôles de diffusion 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

Tester sur l'appareil

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

QR d’aperçu du plugin RudderStack code

Utilisation de @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. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode Description
initialize Initialise le client RudderStack.
identify Envoie un appel identify pour l'ID utilisateur fourni.
group Envoie un appel group pour l'ID de groupe fourni.
track Envoie un appel track pour le nom d'événement fourni.
screen Envoie un appel screen pour le nom d'écran fourni.
alias Crée un alias de l'utilisateur actuel vers un nouvel identifiant.
reset Réinitialise l'état d'identité RudderStack actuel.
flush Envoie immédiatement les événements en attente.
putDeviceToken Définit le token push que RudderStack transmet aux destinations prises en charge.
setAdvertisingId Consultez les définitions source pour le comportement actuel.
putAdvertisingId Définit une valeur d'ID publicitaire personnalisée.
setAnonymousId Consultez les définitions source pour le comportement actuel.
putAnonymousId Définit une valeur d'ID anonyme personnalisée.
optOut Active ou désactive l'opt-out du suivi RudderStack.

Exemples

initialize()

Initialise le client RudderStack.

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

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

identify()

Envoie un appel identify pour l'ID utilisateur fourni.

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

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

group()

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

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

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

track()

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

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

await nativePlugin.track('event');

screen()

Envoie un appel screen pour le nom d'écran fourni.

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

await nativePlugin.screen('screen');

alias()

Crée un alias de l'utilisateur actuel vers un nouvel identifiant.

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

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

Le tableau ci-dessus liste les 14 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.

Référence complète

Continuer depuis Utiliser @capgo/capacitor-rudderstack

Si vous utilisez Utilisation de @capgo/capacitor-rudderstack pour planifier les opérations du dashboard et de API, connectez-l’avec @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 Getting Started Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'Introduction, et Clés API pour les détails d'implémentation dans les clés API.

FAQ

FAQ du plugin RudderStack

Comment installer le plugin RudderStack dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-rudderstack" (ou "npm install @capgo/capacitor-rudderstack"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-rudderstack" dans votre code.

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

Oui. RudderStack est un package Capacitor, il fonctionne donc avec n'importe quel framework web qui tourne dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-rudderstack ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

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

Oui. Le code source de code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-rudderstack/ et le package s'installe gratuitement depuis npm. Les rapports de bugs et les pull requests sont les bienvenus.

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

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez vos changements RudderStack sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo