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.