Salta al contenuto principale
@capgo/capacitor-gtm Analytics Open source

GTM Plugin Capacitor

Integrazione di Google Tag Manager per analytics e tracking

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 usare GTM in Capacitor

Utilizzo di @capgo/capacitor-gtm

L'interfaccia principale per il plugin Google Tag Manager.

Installa

bun add @capgo/capacitor-gtm
bunx cap sync

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

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

API in breve

Metodo Descrizione
initialize Inizializza Google Tag Manager con l'ID del container specificato.
push Invia un evento al dataLayer di Google Tag Manager.
setUserProperty Imposta una proprietà utente nel dataLayer di Google Tag Manager.
getValue Recupera un valore dal dataLayer di Google Tag Manager. Cerca nel dataLayer il valore più recente della chiave specificata.
reset Resetta l'istanza di Google Tag Manager e cancella tutti i dati. Questo rimuove tutti i dati dal dataLayer e richiede una nuova inizializzazione.

Esempi

initialize()

Inizializza Google Tag Manager con l'ID del container specificato.

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

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

push()

Invia un evento al dataLayer di Google Tag Manager.

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

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

setUserProperty()

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()

Recupera un valore dal dataLayer di Google Tag Manager. 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()

Resetta l'istanza di Google Tag Manager e cancella tutti i dati. Questo rimuove tutti i dati dal dataLayer e richiede una nuova inizializzazione.

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

await GoogleTagManager.reset();

Riferimento completo

Torna a: Usare @capgo/capacitor-gtm

Se stai usando Usare @capgo/capacitor-gtm per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-gtm per i dettagli di implementazione in @capgo/capacitor-gtm, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.

FAQ

FAQ sul plugin GTM

Come installo il plugin GTM in un'app Capacitor?

Esegui "bun add @capgo/capacitor-gtm" (o "npm install @capgo/capacitor-gtm"), poi lancia "bunx cap sync" per aggiornare i progetti iOS e Android con le code native. Importalo da "@capgo/capacitor-gtm" nel tuo code.

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

Sì. GTM è un pacchetto Capacitor, quindi funziona con qualsiasi web framework in esecuzione all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

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

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

@capgo/capacitor-gtm è free e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-gtm/ e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa GTM senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Rilascia le modifiche GTM senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo