Aller au contenu principal
@capgo/capacitor-gtm Statistiques Open source

GTM Plugin Capacitor

Intégration de Google Tag Manager pour les analytics et le tracking

Installer

bun add @capgo/capacitor-gtm bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-gtm
  • pnpm add @capgo/capacitor-gtm
  • yarn add @capgo/capacitor-gtm

Guide

Comment utiliser GTM dans Capacitor

Utiliser @capgo/capacitor-gtm

L'interface principale du plugin Google Tag Manager.

Installer

bun add @capgo/capacitor-gtm
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode Description
initialize Initialise Google Tag Manager avec l'ID de conteneur spécifié.
push Envoie un événement au dataLayer de Google Tag Manager.
setUserProperty Définit une propriété utilisateur dans le dataLayer de Google Tag Manager.
getValue Récupère une valeur du dataLayer de Google Tag Manager. Parcourt le dataLayer pour trouver la valeur la plus récente de la clé spécifiée.
reset Réinitialise l'instance Google Tag Manager et efface toutes les données. Cela supprimera toutes les données du dataLayer et nécessitera une nouvelle initialisation.

Exemples

initialize()

Initialise Google Tag Manager avec l'ID de conteneur spécifié.

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

await GoogleTagManager.initialize({ containerId: 'container-id-123' });

push()

Envoie un événement au dataLayer de Google Tag Manager.

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

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

setUserProperty()

Définit une propriété utilisateur dans le dataLayer de Google Tag Manager.

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

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

getValue()

Récupère une valeur du dataLayer de Google Tag Manager. Parcourt le dataLayer pour trouver la valeur la plus récente de la clé spécifiée.

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

const result = await GoogleTagManager.getValue({ key: 'key-123' });
console.log(result);

reset()

Réinitialise l'instance Google Tag Manager et efface toutes les données. Cela supprimera toutes les données du dataLayer et nécessitera une nouvelle initialisation.

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

await GoogleTagManager.reset();

Référence complète

Continuer après l'utilisation de @capgo/capacitor-gtm

Si vous utilisez Utiliser @capgo/capacitor-gtm pour planifier le travail sur les plugins natifs, connectez-l’à @capgo/capacitor-gtm pour les détails d'implémentation dans @capgo/capacitor-gtm, Prise en main pour les détails d'implémentation dans Getting Started Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans les plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins.

FAQ

FAQ du plugin GTM

Comment installer le plugin GTM dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-gtm" (ou "npm install @capgo/capacitor-gtm"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-gtm" dans votre application code.

Est-ce que @capgo/capacitor-gtm fonctionne avec React, Vue et Angular ?

Oui. GTM est un package Capacitor, il fonctionne donc avec n'importe quel framework web s'exécutant dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-gtm ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-gtm est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-gtm/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant GTM sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez vos changements GTM sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo