Erste Schritte
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses 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.
Installieren
Abschnitt „Installation“Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge die Capgo Skills mit dem folgenden Befehl deinem KI-Tool hinzu:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsNutze dann diesen Prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-gtm` plugin in my project.Wenn du ein manuelles Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:
bun add @capgo/capacitor-gtmnpx cap syncImportieren
Abschnitt mit dem Titel „Import“import { GoogleTagManager } from '@capgo/capacitor-gtm';Quickstart
Abschnitt „Quick start“import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.push({ event: 'purchase', parameters: { value: 99.99, currency: 'USD' }});Beispiel: setUserProperty
Abschnitt mit dem Titel „Beispiel: setUserProperty“import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.setUserProperty({ key: 'user_type', value: 'premium'});Häufige Stolperfallen
Abschnitt „Häufige Fallstricke“- Einmalige Initialisierung: Setup beim App-Bootstrap ausführen.
- Nativer Sync: ausführen
npx cap syncnach Plugin-Upgrades. - Single Source of Truth: Vertrauen
src/definitions.tsim GitHub Repo.
API Übersicht
Abschnitt „API Übersicht“initialize
Abschnitt „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
Abschnitt „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
Abschnitt „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
Abschnitt „getValue“Ruft einen Wert aus dem Google Tag Manager dataLayer ab. Durchsucht den dataLayer nach dem neuesten Wert für den angegebenen Key.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
const result = await GoogleTagManager.getValue({ key: 'key-123' });console.log(result);reset
Abschnitt „reset“Setzt die Google-Tag-Manager-Instanz zurück und löscht alle Daten. Dadurch werden alle Daten aus dem dataLayer entfernt und eine Neuinitialisierung ist nötig.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.reset();Source of Truth
Abschnitt mit dem Titel „Source of Truth“Diese Seite wird aus dem Plugin generiert src/definitions.ts. Führe den Sync erneut aus, wenn sich das öffentliche API upstream ändert.
Weiter geht's nach Getting Started
Abschnitt: „Weiter geht’s mit Getting Started“Wenn du es nutzt Erste Schritte um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-gtm verwenden für die native Funktion in Using @capgo/capacitor-gtm, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung, API Schlüssel für das Implementierungsdetail in API Keys und Geräte für das Implementierungsdetail in Devices.