Saltar al contenido principal
@capgo/capacitor-rudderstack Analíticas Código abierto

RudderStack plugin Capacitor

Analytics, resolución de identidad, tracking de pantallas y controles de entrega de RudderStack para Capacitor

Instalar

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

Guía

Cómo usar RudderStack en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

Vista previa del plugin RudderStack QR code

Usando @capgo/capacitor-rudderstack

Capacitor API que refleja la superficie pública de rudder-sdk-cordova.

Instalar

bun add @capgo/capacitor-rudderstack
bunx cap sync

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

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

API de un vistazo

Método Descripción
initialize Inicializa el cliente de RudderStack.
identify Envía una llamada identify para el user id proporcionado.
group Envía una llamada group para el group id proporcionado.
track Envía una llamada track para el nombre de evento proporcionado.
screen Envía una llamada screen para el nombre de pantalla proporcionado.
alias Crea un alias del usuario actual con un nuevo identificador.
reset Reinicia el estado de identidad actual de RudderStack.
flush Envía los eventos en cola de inmediato.
putDeviceToken Establece el push token que RudderStack envía a los destinos compatibles.
setAdvertisingId Consulta las definiciones de origen para ver el comportamiento actual.
putAdvertisingId Sets a custom advertising id value.
setAnonymousId Consulta las definiciones de origen para ver el comportamiento actual.
putAnonymousId Establece un valor personalizado de ID anónimo.
optOut Toggles RudderStack tracking opt-out.

Ejemplos

initialize()

Inicializa el cliente de RudderStack.

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

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

identify()

Envía una llamada identify para el user id proporcionado.

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

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

group()

Envía una llamada group para el group id proporcionado.

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

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

track()

Envía una llamada track para el nombre de evento proporcionado.

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

await nativePlugin.track('event');

screen()

Envía una llamada screen para el nombre de pantalla proporcionado.

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

await nativePlugin.screen('screen');

alias()

Crea un alias del usuario actual con un nuevo identificador.

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

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

La tabla anterior lista los 14 métodos principales. Los helpers de listener y de versión, y el contrato completo de cada método, están documentados en el repositorio GitHub.

Referencia completa

Continúa desde Usando @capgo/capacitor-rudderstack

Si estás usando Usando @capgo/capacitor-rudderstack para planificar las operaciones del dashboard y de API, conéctalo con @capgo/capacitor-rudderstack para los detalles de implementación en @capgo/capacitor-rudderstack, Primeros pasos para los detalles de implementación en Primeros pasos, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Keys.

FAQ

FAQ del plugin RudderStack

¿Cómo instalo el plugin RudderStack en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-rudderstack" (o "npm install @capgo/capacitor-rudderstack"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android reconozcan el code nativo. Impórtalo desde "@capgo/capacitor-rudderstack" en el code de tu app.

¿Es compatible @capgo/capacitor-rudderstack con React, Vue y Angular?

Sí. RudderStack es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-rudderstack?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-rudderstack gratuito y open source?

Sí. El código fuente de code es público en GitHub: https://github.com/Cap-go/capacitor-rudderstack/ y el paquete se puede instalar gratis desde npm. Se agradecen los reportes de bugs y pull requests.

¿Puedo actualizar code que usa RudderStack sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de RudderStack sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo