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

Du kannst unser AI-Assisted Setup nutzen, um das Plugin zu installieren. Füge deinem AI-Tool die Capgo Skills mit folgendem Befehl hinzu:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Nutze 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 Manual Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

bun add @capgo/capacitor-gtm
npx cap sync

Importieren

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

Quickstart

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

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

Beispiel: setUserProperty

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

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

Häufige Fehlerquellen

Einmalige Initialisierung: Führe das Setup beim App-Bootstrap aus.
Native-Sync: run npx cap sync nach Plugin-Upgrades.
Single Source of Truth: Vertrauen src/definitions.ts im GitHub Repo.

API Übersicht

`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`

Ruft einen Wert aus dem Google Tag Manager dataLayer ab. 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 werden alle Daten aus dem dataLayer entfernt, was eine Re-Initialisierung erfordert.

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

await GoogleTagManager.reset();

Single Source of Truth

Diese Seite wurde aus dem Plugin- Dokument generiert src/definitions.tsFühre den Sync erneut aus, wenn sich API upstream ändert.

Weiterlesen nach dem Einstieg

If you are using Erste Schritte um Dashboard- und API Operationen zu planen, verbinde es mit Mit @capgo/capacitor-gtm für die native Funktionalität in Mit @capgo/capacitor-gtm, API Übersicht für Details zur Implementierung in API Übersicht, Einführung für Details zur Implementierung in der Einführung, API Keys für die Implementierungsdetails in API Keys und Geräte für die Implementierungsdetails in Devices.