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.