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

GTM plugin Capacitor

Integración con Google Tag Manager para analítica y tracking

Instalar

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

Guía

Cómo usar GTM en Capacitor

Uso de @capgo/capacitor-gtm

La interfaz principal para el plugin de Google Tag Manager.

Instalar

bun add @capgo/capacitor-gtm
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 { GoogleTagManager } from '@capgo/capacitor-gtm';

API de un vistazo

Método Descripción
initialize Inicializa Google Tag Manager con el ID de contenedor especificado.
push Envía un evento al dataLayer de Google Tag Manager.
setUserProperty Establece una propiedad de usuario en el dataLayer de Google Tag Manager.
getValue Obtiene un valor del dataLayer de Google Tag Manager. Busca en el dataLayer el valor más reciente de la clave especificada.
reset Restablece la instancia de Google Tag Manager y borra todos los datos. Esto eliminará todos los datos del dataLayer y requerirá una reinicialización.

Ejemplos

initialize()

Inicializa Google Tag Manager con el ID de contenedor especificado.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.initialize({ containerId: 'container-id-123' });

push()

Envía un evento al dataLayer de Google Tag Manager.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.push({
  event: 'purchase',
  parameters: {
    value: 99.99,
    currency: 'USD'
  }
});

setUserProperty()

Establece una propiedad de usuario en el dataLayer de Google Tag Manager.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.setUserProperty({
  key: 'user_type',
  value: 'premium'
});

getValue()

Obtiene un valor del dataLayer de Google Tag Manager. Busca en el dataLayer el valor más reciente de la clave especificada.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

const result = await GoogleTagManager.getValue({ key: 'key-123' });
console.log(result);

reset()

Restablece la instancia de Google Tag Manager y borra todos los datos. Esto eliminará todos los datos del dataLayer y requerirá una reinicialización.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.reset();

Referencia completa

Continuar desde Uso de @capgo/capacitor-gtm

Si estás usando Uso de @capgo/capacitor-gtm para planificar el trabajo con plugins nativos, conéctalo con @capgo/capacitor-gtm para los detalles de implementación en @capgo/capacitor-gtm, Primeros pasos para los detalles de implementación en Primeros pasos, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Capacitor Plugins de Capgo, y Añadir o actualizar plugins para los detalles de implementación al añadir o actualizar plugins.

FAQ

FAQ del plugin GTM

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

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

¿Funciona @capgo/capacitor-gtm con React, Vue y Angular?

Sí. GTM es un paquete Capacitor, así que funciona con cualquier framework web que corra dentro de Capacitor, incluidos Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-gtm?

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-gtm gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub, en https://github.com/Cap-go/capacitor-gtm/, y el paquete se instala gratis desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa GTM 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 GTM 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