跳过主要内容
返回插件
@capgo/capacitor-gtm
教程
@capgo/capacitor-gtm

GTM

Google Tag Manager分析和跟踪的集成

指南

GTM教程

在设备上测试

Download the Capgo app, then scan the QR code.

Google Tag Manager 插件预览二维码 code

使用 @capgo/capacitor-gtm

Google Tag Manager 插件的主要界面。

安装

bun add @capgo/capacitor-gtm
bunx cap sync

此插件暴露的内容

  • initialize - 使用指定的容器 ID 初始化 Google Tag Manager。
  • push - 将事件推送到 Google Tag Manager 的 dataLayer 中。
  • setUserProperty - 在 Google Tag Manager 的 dataLayer 中设置用户属性。
  • getValue - 从 Google Tag Manager 的 dataLayer 中获取值。该函数会在 dataLayer 中搜索指定键的最新值。

示例用途

initialize

初始化 Google Tag Manager 并使用指定的容器 ID。

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

await GoogleTagManager.initialize({} as { containerId: string; timeout?: number });

push

将事件推送到 Google Tag Manager 数据层。

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

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

setUserProperty

在 Google Tag Manager 数据层中设置用户属性。

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

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

getValue

从 Google Tag Manager 数据层获取值。该方法会在数据层中搜索指定键的最新值。

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

await GoogleTagManager.getValue({} as { key: string });

完整参考文档

继续使用 @capgo/capacitor-gtm

如果您正在使用 使用 @capgo/capacitor-gtm 规划原生插件工作时,连接它到 @capgo/capacitor-gtm 为 @capgo/capacitor-gtm 的实现细节 开始使用 为 Getting Started 的实现细节 Capgo 插件目录 为 Capgo 插件目录 的产品工作流程 Capacitor 由 Capgo 提供的插件 为 Capacitor 由 Capgo 提供的插件 的实现细节, 添加或更新插件 为添加或更新插件 的实现细节