跳过主要内容

GTM Capacitor 插件

Google Tag Manager 与分析和跟踪的集成

安装

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

指南

如何在Capacitor中使用GTM

在设备上测试

下载Capgo应用程序,然后扫描QRcode。

GTM 插件预览二维码 code

使用 @capgo/capacitor-gtm

Google Tag Manager 插件的主要界面。

安装

bun add @capgo/capacitor-gtm
bunx cap sync

bunx cap sync 将插件的本机 code 复制到您的本机项目中。每次升级插件后都重新运行它。

Import

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

API概览

方法 功能描述
initialize 初始化Google Tag Manager并指定容器ID。
push 将事件推送到Google Tag Manager的数据层。
setUserProperty 在Google Tag Manager的数据层中设置用户属性。
getValue 从Google Tag Manager的数据层中获取值。该函数会在数据层中搜索指定键的最新值。
reset 重置Google Tag Manager实例并清除所有数据。该操作将从数据层中移除所有数据并要求重新初始化。

示例

initialize()

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

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

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

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

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

reset()

重置Google Tag Manager实例并清除所有数据。该操作将从数据层中移除所有数据并要求重新初始化。

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

await GoogleTagManager.reset();

全局参考

继续使用 @capgo/capacitor-gtm

如果您正在使用 使用 @capgo/capacitor-gtm 与其进行连接 @capgo/capacitor-gtm 在 @capgo/capacitor-gtm 中获取实现细节 开始 在开始中获取实现细节 Capgo 插件目录 为产品工作流程在 Capgo 插件目录中 Capacitor 插件由 Capgo 为实现细节在 Capacitor 插件由 Capgo 中 添加或更新插件 为实现细节在添加或更新插件中

FAQ

谷歌标签管理器插件FAQ

如何在Capacitor应用中安装谷歌标签管理器插件?

运行“bun add @capgo/capacitor-gtm”(或“npm install @capgo/capacitor-gtm”),然后运行“bunx cap sync”,使iOS和Android项目捕获native code。从“@capgo/capacitor-gtm”中导入它,然后在应用code中使用。

是否@capgo/capacitor-gtm与React、Vue和Angular兼容?

是的。谷歌标签管理器是一个Capacitor包,因此它与任何运行在Capacitor中的web框架兼容,包括Ionic、React、Vue、Angular、Svelte和普通JavaScript。

Which Capacitor version does @capgo/capacitor-gtm support?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件v8与Capacitor 8)。在GitHub README中列出的兼容性表格列出了维护的版本。

是否@capgo/capacitor-gtm 免费且开源?

是的,源码code在GitHub上公开,https://github.com/Cap-go/capacitor-gtm/,并且可以从npm免费安装。欢迎bug报告和pull请求。

是否可以在不经过App Store审核的情况下更新使用GTM的code?

安装或升级插件会改变原生code,因此需要重新构建App Store。之后,使用Capgo实时更新的JavaScript、HTML和CSS代码可以立即发布。

不必等待应用程序审查就可以将GTM更改部署

一旦插件在您的商店构建中,Capgo的实时更新将推送您的JavaScript、HTML和CSS更改到用户中几分钟内

从Capgo开始