Saltare al contenuto principale
@capgo/capacitor-gtm Analisi Sorgente aperta

GTM plugin Capacitor

Integrazione di Google Tag Manager per analisi e tracciamento

Installa

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

Guida

Come utilizzare GTM in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansione il QR code.

Collegamento QR di anteprima del plugin GTM code

Utilizza @capgo/capacitor-gtm

L'interfaccia principale per il plugin del Gestore di Tag Google.

Installa

bun add @capgo/capacitor-gtm
bunx cap sync

bunx cap sync Copia il code nativo del plugin nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

Vedi API in un colpo d'occhio

Metodo Esempio
initialize Inizializza il gestore dei tag Google con l'ID del contenitore specificato.
push Puoi inviare un evento al dataLayer del gestore dei tag Google.
setUserProperty Imposta una proprietà dell'utente nel dataLayer del gestore dei tag Google.
getValue Recupera un valore dal dataLayer del gestore dei tag Google. Cerca nel dataLayer il valore più recente della chiave specificata.
reset Ripristina l'istanza del gestore dei tag Google e cancella tutti i dati. Questo cancellerà tutti i dati dal dataLayer e richiederà una riinizializzazione.

Esempi

initialize()

Inizializza il gestore dei tag Google con l'ID del contenitore specificato.

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

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

push()

Puoi inviare un evento al dataLayer del gestore dei tag Google.

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

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

setUserProperty()

Imposta una proprietà dell'utente nel dataLayer del gestore dei tag Google.

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

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

getValue()

Recupera un valore dal dataLayer del gestore dei tag Google. Cerca nel dataLayer il valore più recente della chiave specificata.

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

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

reset()

Ripristina l'istanza del gestore dei tag Google e cancella tutti i dati. Questo cancellerà tutti i dati dal dataLayer e richiederà una riinizializzazione.

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

await GoogleTagManager.reset();

Riferimento completo

Continua dall'uso di @capgo/capacitor-gtm

Continua da Utilizzo di @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-gtm Usando @capgo/capacitor-gtm per pianificare il lavoro del plugin nativo, connettilo con @capgo/capacitor-gtm per i dettagli di implementazione in @capgo/capacitor-gtm per i dettagli di implementazione in @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-gtm Avvio rapido per i dettagli di implementazione in Avvio rapido, Capgo Directory dei Plugin per il workflow del prodotto nella Capgo Directory dei Plugin Capacitor Plugin da Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo, e Aggiungere o Aggiornare i Plugin per i dettagli di implementazione in Aggiungere o Aggiornare i Plugin.

FAQ

Domande frequenti sul plugin GTM

Come posso installare il plugin GTM in un'app Capacitor?

Esegui "bun add @capgo/capacitor-gtm" (o "npm install @capgo/capacitor-gtm"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il nativo code. Importalo da "@capgo/capacitor-gtm" nella tua app code.

Funziona @capgo/capacitor-gtm con React, Vue e Angular?

Sì. Il GTM è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-gtm?

I plugin Capgo seguono la versione maggiore di Capacitor: utilizza la versione maggiore del plugin che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È @capgo/capacitor-gtm gratuito e open source?

Yes. Il code di origine è pubblico su GitHub a https://github.com/Cap-go/capacitor-gtm/ e il pacchetto è gratuito per l'installazione da npm. Sono graditi i segnalazioni di bug e le richieste di pull.

Posso aggiornare il code che utilizza GTM senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il code nativo, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite immediatamente con gli aggiornamenti Capgo in tempo reale.

Invia le modifiche GTM senza dover attendere la revisione dell'app

Una volta che il plugin è presente nella tua store build, Capgo live updates inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo