Avvio
Copia un promemoria di configurazione con le istruzioni di installazione e la guida markdown completa per questo plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-gtm`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/gtm/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Installa
Sezione intitolata “Installa”Puoi utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo abilità al tuo strumento AI utilizzando il seguente comando:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsUsa poi il seguente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-gtm` plugin in my project.Se preferisci la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo platform:
bun add @capgo/capacitor-gtmbunx cap syncImporta
Sezione intitolata “Importa”import { GoogleTagManager } from '@capgo/capacitor-gtm';API Panoramica
Sezione intitolata “API Panoramica”initialize
Sezione intitolata “inizializza”Inizializza Google Tag Manager con l'ID del contenitore specificato.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.initialize({} as { containerId: string; timeout?: number });Inserisce un evento nel dataLayer di Google Tag Manager.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.push({ event: 'purchase', parameters: { value: 99.99, currency: 'USD' }});setUserProperty
Sezione intitolata “imposta proprietà utente”Imposta una proprietà utente nel dataLayer di Google Tag Manager.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.setUserProperty({ key: 'user_type', value: 'premium'});getValue
Sezione intitolata “getValue”Recupera un valore dal dataLayer del Google Tag Manager. Cerca nel dataLayer il valore più recente della chiave specificata.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.getValue({} as { key: string });Riavvia l'istanza del Google Tag Manager e cancella tutti i dati. Questo rimuoverà tutti i dati dal dataLayer e richiederà una ri-inizializzazione.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.reset();Fonte di Verità
Sezione intitolata “Fonte di Verità”Questa pagina è generata dal plugin's.
Ri-esegui la sincronizzazione quando i dati pubblici __CAPGO_KEEP_0__ cambiano in modo upstream. src/definitions.ts. Re-run the sync when the public API changes upstream.
Sezione intitolata “Continua da Iniziare”
Continua da IniziareSe stai utilizzando Iniziare per pianificare il dashboard e le API operazioni, connettilo con Utilizzare @capgo/capacitor-gtm per la capacità nativa in Utilizzare @capgo/capacitor-gtm, API Panoramica per i dettagli di implementazione in API Panoramica, Introduzione per i dettagli di implementazione in Introduzione, API Chiavi per i dettagli di implementazione in API Chiavi, e Dispositivi per i dettagli di implementazione nei dispositivi.