Anleitung
GTM in Capacitor nutzen
Verwendung von @capgo/capacitor-gtm
Die Hauptschnittstelle für das Google Tag Manager Plugin.
Installieren
bun add @capgo/capacitor-gtm
bunx cap sync
bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.
Importieren
import { GoogleTagManager } from '@capgo/capacitor-gtm';
API auf einen Blick
| Methode | Beschreibung |
|---|---|
initialize |
Initialisiert den Google Tag Manager mit der angegebenen Container-ID. |
push |
Pusht ein Event in den dataLayer von Google Tag Manager. |
setUserProperty |
Setzt eine User-Property im Google Tag Manager dataLayer. |
getValue |
Liest einen Wert aus dem Google Tag Manager dataLayer aus. Durchsucht den dataLayer nach dem aktuellsten Wert des angegebenen Keys. |
reset |
Setzt die Google Tag Manager-Instanz zurück und löscht alle Daten. Dadurch wird der dataLayer geleert und eine Re-Initialisierung erforderlich. |
Beispiele
initialize()
Initialisiert den Google Tag Manager mit der angegebenen Container-ID.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.initialize({ containerId: 'container-id-123' });
push()
Pusht ein Event in den dataLayer von Google Tag Manager.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.push({
event: 'purchase',
parameters: {
value: 99.99,
currency: 'USD'
}
});
setUserProperty()
Setzt eine User-Property im Google Tag Manager dataLayer.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.setUserProperty({
key: 'user_type',
value: 'premium'
});
getValue()
Liest einen Wert aus dem Google Tag Manager dataLayer aus. Durchsucht den dataLayer nach dem aktuellsten Wert des angegebenen Keys.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
const result = await GoogleTagManager.getValue({ key: 'key-123' });
console.log(result);
reset()
Setzt die Google Tag Manager-Instanz zurück und löscht alle Daten. Dadurch wird der dataLayer geleert und eine Re-Initialisierung erforderlich.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.reset();
Vollständige Referenz
Weiter mit der Nutzung von @capgo/capacitor-gtm
Wenn du es nutzt Nutzung von @capgo/capacitor-gtm Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-gtm für die Implementierungsdetails in @capgo/capacitor-gtm, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.