Zum Inhalt springen

Erste Schritte

GitHub

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:

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

Terminalfenster
bun add @capgo/capacitor-gtm
npx cap sync
import { GoogleTagManager } from '@capgo/capacitor-gtm';
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.push({
event: 'purchase',
parameters: {
value: 99.99,
currency: 'USD'
}
});
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.setUserProperty({
key: 'user_type',
value: 'premium'
});
  • Einmalige Initialisierung: Setup beim App-Bootstrap ausführen.
  • Nativer Sync: ausführen npx cap sync nach Plugin-Upgrades.
  • Single Source of Truth: Vertrauen src/definitions.ts im GitHub Repo.

Initialisiert den Google Tag Manager mit der angegebenen Container-ID.

import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.initialize({ containerId: 'container-id-123' });

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'
}
});

Setzt eine User-Property im Google Tag Manager dataLayer.

import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.setUserProperty({
key: 'user_type',
value: 'premium'
});

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

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

Diese Seite wird aus dem Plugin generiert src/definitions.ts. Führe den Sync erneut aus, wenn sich das öffentliche API upstream ändert.

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.