SuperAPI AI 工具集

pp-google-tag-manager

数据与分析

查看项目

更新于 10-16 01:32

技能介绍

用途:该 CLI 把 GTM 容器配置拉取到本地 SQLite,提供审计、diff、导出和查询能力,弥补控制台无法批量查询、交叉引用和版本化导出的不足。为只读设计,变更端点已移除,可安全指向生产容器。

主要能力:pull 拉取整个容器(标签、触发器、变量、文件夹、模板、客户端、区域、gtag 配置)到本地存储;export 输出确定性的扁平化表示用于 git 版本对比,或输出兼容的容器 JSON;audit 运行卫生检查(死标签、孤立触发器、未用变量、暂停标签、自定义 HTML、全页触发标签),支持 --fail-on 在 CI 中按严重级别失败;consent-report 统计每个标签的 consentSettings 覆盖情况并列出未经同意门控的标签;diff 在两个快照间做字段级对比(工作区与线上、版本间、容器间);fleet 跨所有已拉取容器汇总 GA4 测量 ID、同意模式覆盖、自定义 HTML 数量;search 对实体名称、类型、参数和备注做子串搜索;uses 显示引用某变量或触发器的所有对象;fires 做双向依赖图遍历。

使用方式:安装可用 npx -y @mvanhorn/printing-press-library install google-tag-manager --cli-only,或用 go install github.com/mvanhorn/printing-press-library/library/marketing/google-tag-manager/cmd/google-tag-manager-pp-cli@latest;验证 google-tag-manager-pp-cli --version,并确保安装目录在 PATH 中。认证使用 OAuth 2.0 只读令牌,通过 GTM_ACCESS_TOKEN 提供;可用 gcloud auth application-default login --scopes=https://www.googleapis.com/auth/tagmanager.readonly 后导出令牌,或使用被授予 Viewer 权限的服务账号。运行 doctor 验证配置。任意命令可加 --agent,展开为 --json --compact --no-input --no-color --yes;支持 --select、--dry-run、--deliver(stdout、file:<path>、webhook:<url>)与命名 profile。

适用场景:发布前检查、工作区与线上对比、跨容器 GA4 ID 与 Consent Mode v2 覆盖盘点、删除变量前评估影响范围、搜索遗留像素。

限制:只读,不能创建、编辑、删除或发布配置,也不能在浏览器中渲染或测试标签触发,不提供 GA4 分析数据。需 Node 或 Go 1.26.4 以上;安装与认证配置暂未提供更多细节。