README

Google Tag Manager for Magento 2 / Adobe Commerce with Advanced Data Layer

无论您是小型 Magento 零售商还是 Adobe Commerce 企业客户，我们的 Google Tag Manager 扩展套件都将帮助您在几天内整合最具挑战性的 GTM 项目，而不是花费数周或数月创建定制解决方案。

适用于 Magento 2.0.x、2.1.x、2.2.x、2.3.x 和 2.4.x

什么是 Google Tag Manager

Google Tag Manager (GTM) 是每个 Magento 商店的友好、强大且必要的集成。它简化了在您的 Magento 网站上添加、编辑和管理第三方 JavaScript 标签和其他代码片段的过程。使用 GTM，您可以轻松快速地添加 Facebook 标签、AdWords 转换跟踪、再营销、Bing UET、SnapChat、DoubleClick 代码、Google Analytics 等，而无需开发人员更改您的 Magento 代码（前提是数据可供 Google Tag Manager 使用）。

当与多个部门和广告机构校准时，Google Tag Manager 可以使您的数字营销活动运行得更加轻松，因为它提供了合适的工具集，使每个人都能够快速完成工作，而无需依赖开发人员。

如果没有所有必要的数据在您的指尖，您的集成将变得困难、耗时且混乱，因为每个开发人员都只会专注于当前的任务，而不是专注于编写可重用的组件以供未来的集成。

我们的扩展提供超过 60 个预配置的数据层元素，使您能够轻松地将您的 Magento 商店与其他第三方服务集成，使用 Google Tag Manager。使用我们易于定制的 API，从您的 Magento 商店提取、自定义并添加自己的自定义数据到 Google Tag Manager，就像编写 10 行代码一样简单。

⚠️ Google Tag Manager 2.7.0 对增强型电子商务有一些破坏性更改。请从 www.magepal.com 账户下载增强型电子商务 1.7.0 或更高版本。

为什么使用我们的 Google Tag Manager 扩展？

将 Google Tag Manager 代码片段添加到您的 Magento / Adobe Commerce 商店的头部分可能看起来是理想的、最有效的方式将 GTM 添加到您的网站。但这样还不够，并且限制了您在集成需要从您的 Magento 商店获取数据的第三方跟踪代码（例如产品名称、价格、添加到购物车的商品、订单商品、总计、运费或其他数据）时充分利用 GTM 的能力。我们的扩展提供数百个数据元素和事件，以完成任何集成，并提供构建块，使您的下一次集成取得成功。只需几行代码，您就可以快速扩展我们的扩展以完成您最具挑战性的集成。Google Tag Manager 的强大程度取决于其数据层。了解更多关于 自定义 Google Tag Manger 的信息。

Google Analytics 4

升级到来自谷歌的下一代跟踪。带有众多关键功能的Google Analytics 4 与增强型电商相比，具有很大的不同和更强的功能。通过 MagePal Google Analytics 4 扩展，获取 GA4 优先考虑隐私的跟踪、渠道测量和基于 AI 的预测数据的新方法。

谷歌分析增强型电商

想跟踪更多？升级到我们的新增强型电商 for Google Tag Manager，充分利用谷歌分析最强大的电商功能。通过利用谷歌增强型电商更好地了解用户行为，获取宝贵见解并提高转化率。

今天了解更多关于我们的Google Enhanced Ecommerce 扩展。您店铺转化率的小幅提升可以对您的收入产生巨大影响。

与谷歌标签管理器的第三方集成

在您的网站上添加 Facebook 像素、Bing UAT、SnapChat 或其他任何第三方代码片段，但被配置谷歌标签管理器的繁琐和时间所困扰？学习如何通过我们的新DataLayer 扩展 将任何跟踪代码轻松集成到您的 Magento 店铺中。

通用数据保护条例（GDPR）支持

现在您可以通过启用 Cookie 限制模式或基于现有或不存在 cookie 来快速禁用不愿被跟踪的客户的分析跟踪。

• 商店 > 配置 > 一般 > 网络 > 默认 Cookie 设置 > Cookie 限制模式。

请注意：商家应咨询自己的法律顾问，以确保符合 GDPR。

通过我们的附加扩展从谷歌标签管理器中获得更多功能

GTM - Google Tag Manager for Magento 2 扩展

GA4 - Google Analytics 4 for Google Tag Manager 扩展

EE - Enhanced E-commerce for Google Tag Manager 扩展

DL - DataLayer for Google Tag Manager 扩展

功能

• 快速简单的设置
• 通过 XML 布局和/或观察者添加标签
• 超过 60+ 数据元素的先进数据层
• 通过 10 行代码完全可定制的
• 通用数据保护条例（GDPR）支持
• GTM 多环境支持
• 内容安全策略支持

使用谷歌标签管理器与 Magento 的好处

使用 GTM 与 Magento 一起使用有许多好处

• 一个集中的标签管理源 - 谷歌标签管理器是顶级、最广泛使用的 JavaScript 标签管理器之一，因此，任何有谷歌标签管理器经验的用户都将具备进行网站编辑所需的所有知识。
• 技术知识很少 - 拥有如此多技术技能的数字营销机构可以快速创建和发布对 Google 标签管理器的更改，而无需联系开发者。
• 版本控制 - 每次对 Google 标签管理器容器进行的更改都将进行跟踪，并记录更改历史记录中谁和更改了什么。
• 易于使用 - Google Tag Manager 非常简单易用。您可以轻松地将 GTM 配置导出为文本文件，以便保存和重新导入。
• 减少所需的 Magento 扩展数量 - 为 AdWords、Facebook 跟踪、Snapchat、Microsoft Bing 安装单个扩展会花费时间且资源密集，对您的 Magento 商店来说也是一项资源密集型的工作。使用 Tag Manager，您只需要安装和维持一个扩展。
• 消除主题和订单成功页面编辑 - 99% 的商家、开发人员和代理商不知道或不会使用最佳实践在 Magento 商店中插入 JavaScript 跟踪代码片段，通常只是随意在主题文件中添加硬编码的 JavaScript 代码片段，这使它们随着时间的推移变得难以维护，尤其是当您在不同的服务提供商之间切换时。

如何自定义 Google Tag Manager 扩展

需要向数据层添加更多数据或更改现有数据以满足客户需求？添加、更改或从数据层删除信息以满足客户需求就像添加几行 PHP 和 di.xml 代码一样简单。查看我们的文档以了解更多有关 如何自定义 Google Tag Manager 的信息。

文档与安装指南

如何安装 Google Tag Manager

如何设置 Google Tag Manager

如何自定义 Google Tag Manager

Google Tag Manger 数据层属性

如何调试 Google Tag Manager

Composer 安装

composer require magepal/magento2-googletagmanager

数据层属性

我们的 Magento 扩展提供超过 60 个预先配置的数据层元素，使您能够轻松地将 Magento 商店与任何第三方服务集成，使用 Google Tag Manager。

触发事件

主页事件

• 事件
  • homePage**, allPage**, cmsIndexIndexPage**, mpCustomerSession

分类页事件

• 事件
  • productImpression*, categoryPage**, allPage**, catalogCategoryViewPage**, mpCustomerSession
  • productClick*, addToCart*, productListSwatchClicked**, productListSwatchSelected**
  • view_item_list***, select_item***, add_to_cart***

产品详情页事件

• 事件
  • productDetail*, productImpression*, productPage**, allPage**, catalogProductViewPage**, mpCustomerSession
  • productClick*, addToCart*, removeFromCart*, productDetailSwatchClicked**, productDetailSwatchSelected**, addToCartItemOutOfStock*, addToCartItemOptionRequired*, addToCartItemInvalidQtyIncrements*
  • view_item***, select_item***, add_to_cart***, view_item_list***

购物车页事件

• 事件
  • cartPage**, allPage**, checkoutCartIndexPage**, productImpression*, mpCustomerSession
  • productClick*, addToCart*, removeFromCart*
  • select_item***, add_to_cart***, remove_from_cart***, view_item_list***

结账页事件

• 事件
  • checkoutPage**, allPage**, checkoutIndexIndexPage**, checkout*, checkoutOption*, mpCustomerSession
  • checkoutEmailValidation*, shippingMethodAdded*, checkoutShippingStepCompleted*, checkoutShippingStepFailed*, paymentMethodAdded*, checkoutPaymentStepFailed*, checkoutPaymentStepCompleted*
  • begin_checkout***, add_shipping_info***, add_payment_info***

订单确认页事件

• 事件
  • purchase*, orderSuccessPage**, allPage**, checkoutOnepageSuccessPage**

其他事件

• 事件
  • compareProductAdded**, compareProductRemoved**, wishlistProductAdded**, wishlistProductRemoved**, customerLoginAfter**, customerRegisterAfter**, newsletterSubscriberAdded** newsletterUnsubscribed**

数据层变量

客户

• 触发：事件等于 mpCustomerSession
  • customer.isLoggedIn
  • customer.id
  • customer.groupId
  • order.email_sha1**
  • order.email**
  • order.customer_id**

产品印象

• 触发：事件等于 productImpression
  • ecommerce.impressions[].name*
  • ecommerce.impressions[].id*
  • ecommerce.impressions[].price*
  • ecommerce.impressions[].list*
  • ecommerce.impressions[].position*
  • ecommerce.impressions[].category*

分类

• 触发：事件等于 categoryPage
  • category.id
  • category.name
  • category.path

搜索页

• 触发：事件等于 searchPage
  • search_term*

产品详情页

• 触发：事件等于 productPage

  • product.id
  • 产品名称
  • 产品SKU
  • 父SKU
  • 产品价格
  • 产品类型
  • 属性集ID
  • 产品路径
  • 产品图片URL

• 触发器：事件等于productDetail

  • 电商货币代码*
  • ecommerce.products[].id*
  • ecommerce.products[].name*
  • ecommerce.products[].category*
  • ecommerce.products[].price*

购物车

• 触发器：事件等于cartPage
  • cart.hasItems
  • cart.items[].sku
  • cart.items[].parent_sku
  • cart.items[].product_type
  • cart.items[].name
  • cart.items[].parent_name
  • cart.items[].price
  • cart.items[].price_incl_tax
  • cart.items[].discount_amount
  • cart.items[].tax_amount
  • cart.items[].quantity
  • cart.total
  • cart.itemCount
  • cart.itemQty
  • cart.hasCoupons
  • cart.couponCode

加入购物车

• 触发器：事件等于addToCart
  • ecommerce.add.products[].id*
  • ecommerce.add.products[].name*
  • ecommerce.add.products[].price*
  • ecommerce.add.products[].quantity*
  • ecommerce.add.products[].parent_sku*
  • ecommerce.add.products[].variant*
  • ecommerce.add.products[].category*

从购物车移除

• 触发器：事件等于removeFromCart
  • ecommerce.remove.products[].id*
  • ecommerce.remove.products[].name*
  • ecommerce.remove.products[].price*
  • ecommerce.remove.products[].quantity*
  • ecommerce.remove.products[].variant*
  • ecommerce.remove.products[].category*

全局数据层

• 触发器：事件等于addToCart

  • cart.add.products[].id*
  • cart.add.products[].name*
  • cart.add.products[].price*
  • cart.add.products[].quantity*
  • cart.add.products[].parent_sku*
  • cart.add.products[].variant*
  • cart.add.products[].category*

• 触发器：事件等于removeFromCart

  • cart.remove.products[].id*
  • cart.remove.products[].name*
  • cart.remove.products[].price*
  • cart.remove.products[].quantity*
  • cart.add.products[].parent_sku*
  • cart.remove.products[].variant*
  • cart.remove.products[].category*

订单

• 触发器：事件等于purchase (Google Analytics)

  • 交易ID
  • 交易归属
  • 交易总额
  • 运输费用
  • 税收
  • 交易优惠券代码
  • 交易折扣
  • 交易小计
  • transactionProducts[].sku
  • transactionProducts[].parent_sku
  • transactionProducts[].product_type
  • transactionProducts[].name
  • transactionProducts[].price
  • transactionProducts[].quantity

• 额外订单日期（通用）

  • 订单ID
  • 店铺名称
  • 订单总额
  • 订单小计
  • 运输费用
  • 税收
  • 优惠券代码
  • 优惠券名称
  • 折扣
  • 支付方式标题
  • 支付方式代码
  • 运输方式标题
  • 运输方式代码
  • 是否虚拟
  • 是否为访客结账
  • order.email_sha1**
  • order.email**
  • order.customer_id**
  • 是否有前一个订单**
  • 是否为第一个订单**
  • 前一个订单数量**
  • 是否为新客户**
  • order.items[].sku
  • order.items[].id
  • order.items[].parent_sku
  • order.items[].product_id
  • order.items[].name
  • order.items[].parent_name
  • order.items[].price
  • order.items[].price_incl_tax
  • order.items[].quantity
  • order.items[].subtotal
  • order.items[].product_type
  • order.items[].discount_amount
  • order.items[].discount_percent
  • order.items[].tax_amount
  • order.items[].is_virtual
  • order.items[].variant
  • order.items[].categories

* - 由我们的 增强型电商扩展插件 提供的数据层

** - 由我们的 数据层扩展插件 提供的数据层

*** - 由我们的 Google Analytics 4 扩展插件 提供的数据层

贡献

想要为此扩展做出贡献？最快捷的方式是在GitHub上打开一个 pull request。

支持

如果您遇到任何问题或错误，请在 GitHub 上打开一个问题。如需快速获取高级支持，请访问我们的 Google Tag Manager 产品页面以获取详细信息。

需要帮助设置或想定制我们的扩展以满足您的业务需求吗？请发送电子邮件至 support@magepal.com，如果我们的想法得到了您的认可，我们将免费或以折扣价添加此功能。

Magento 2 / Adobe Commerce 扩展

• 增强型电子商务
• 增强型 Magento 2 成功页面
• 增强型 Magento 2 交易电子邮件
• 谷歌标签管理器
• 重建索引
• 自定义配送方式
• 预览订单确认
• 访客到客户
• 管理员表单字段管理器
• 客户仪表板链接管理器
• 懒加载
• 订单确认页面杂项脚本
• 为 Magento2 的 HTML 最小化器
• 自定义 SMTP
• 为 Magento 的目录悬停图像

© MagePal LLC. | www.magepal.com