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.