Getting Started
Copiez une commande de configuration avec les étapes d'installation et la guide markdown complet pour ce 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.
Installer
Section intitulée « Installer »Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les compétences Capgo à votre outil IA à l'aide de la commande suivante :
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsUtilisez ensuite la commande suivante :
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-gtm` plugin in my project.Si vous préférez la mise en place manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à la plateforme ci-dessous :
bun add @capgo/capacitor-gtmbunx cap syncImporter
Section intitulée « Importer »import { GoogleTagManager } from '@capgo/capacitor-gtm';API : Présentation
Section intitulée « API : Présentation »initialize
Section intitulée “initialiser”Initialise le gestionnaire de balises Google avec l'ID du conteneur spécifié.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.initialize({} as { containerId: string; timeout?: number });Envoie un événement au dataLayer du gestionnaire de balises Google.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.push({ event: 'purchase', parameters: { value: 99.99, currency: 'USD' }});setUserProperty
Section intitulée “définir la propriété de l'utilisateur”Définit une propriété de l'utilisateur dans le dataLayer du gestionnaire de balises Google.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.setUserProperty({ key: 'user_type', value: 'premium'});Obtient une valeur du dataLayer du gestionnaire de balises Google. Recherche dans le dataLayer pour la valeur la plus récente de la clé spécifiée.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.getValue({} as { key: string });Réinitialise l'instance du gestionnaire de balises Google et efface toutes les données. Cela supprimera toutes les données de la dataLayer et nécessitera une nouvelle initialisation.
import { GoogleTagManager } from '@capgo/capacitor-gtm';
await GoogleTagManager.reset();Source De Vérité
Section intitulée “Source De Vérité”Cette page est générée à partir du plugin’s src/definitions.tsRe-run la synchronisation lorsque les modifications publiques API sont effectuées en amont.
Continuez de l'étape de démarrage
Section intitulée “Continuez de l'étape de démarrage”Si vous utilisez Démarrage pour planifier les opérations de tableau de bord et API , connectez-le Utilisez @capgo/capacitor-gtm pour la capacité native dans Utilisez @capgo/capacitor-gtm API Vue d'ensemble pour le détail d'implémentation dans API Vue d'ensemble Introduction pour le détail d'implémentation dans Introduction API Clés pour le détail d'implémentation dans API Clés, et Appareils pour le détail d'implémentation dans Appareils.