README

为 Magento 2 / Adobe Commerce 提供高级数据层的 Google Tag Manager

无论您是小型 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多个预配置的数据层元素，以使用 Google Tag Manager 使您的 Magento 商店与任何其他第三方服务集成变得轻而易举。使用我们易于定制的 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 的理想且最有效的方法。但这将不足以限制您利用 GTM 集成第三方跟踪代码的能力，这些代码需要来自您的 Magento 商店的数据，例如产品名称、价格、添加到购物车的商品、订单项目、总计、运费或其他数据。我们的扩展提供了数百个数据元素和事件，以完成任何集成，并为使您的下一次集成成功提供构建块。通过几行代码，您可以快速扩展我们的扩展以完成最具有挑战性的集成。Google Tag Manager 的强大程度取决于其背后的数据层。了解更多关于自定义 Google Tag Manger 的信息。

Google Analytics 4

升级到Google下一代跟踪技术。拥有众多关键功能的Google Analytics 4，与增强型电子商务相比，具有很大的差异和更强的功能。通过MagePal Google Analytics 4扩展，您可以获得GA4以隐私优先的跟踪、渠道测量和基于AI的预测数据的新方法。

Google Analytics增强型电子商务

想跟踪更多内容？升级到我们的新增强型电子商务for Google Tag Manager，充分利用Google Analytics最强大的电子商务功能。通过利用Google增强型电子商务来更好地理解用户的行动和行为，获得宝贵见解并提高您的转化率。

今天了解更多关于我们的Google增强型电子商务扩展。您店铺转化率的微小提升可能会对您的收入产生巨大影响。

与Google Tag Manager的第三方集成

想要在您的网站上添加Facebook像素、Bing UAT、SnapChat或其他任何第三方代码片段，但被配置Google Tag Manager的所有麻烦和时间所困扰？了解如何通过我们新的DataLayer扩展轻松地将任何跟踪代码集成到您的Magento店铺中。

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

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

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

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

使用我们的附加扩展从Google Tag Manager中获得更多

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支持多个环境
支持内容安全策略

使用Google Tag Manager与Magento的好处

使用GTM与Magento有很多好处

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

如何自定义 Google Tag Manager 扩展

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

文档 & 安装指南

如何安装 Google Tag Manager

如何设置 Google Tag Manager

如何自定义 Google Tag Manager

Google Tag Manager 数据层属性

如何调试 Google Tag Manager

Composer 安装

composer require magepal/magento2-googletagmanager

数据层属性

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

触发事件

首页事件

事件
- 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*

搜索页

触发器：事件等于 searchPage
- search_term*

产品详情页

触发器：事件等于 productPage
- product.id
- product.name
- product.sku
- product.parent_sku
- product.price
- product.product_type
- product.attribute_set_id
- product.path
- product.image_url
触发器：事件等于 productDetail
- ecommerce.currencyCode*
- 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
- 购物车商品数组的价格
- 购物车商品数组含税价格
- 购物车商品数组折扣金额
- 购物车商品数组税费金额
- 购物车商品数组数量
- 购物车总价
- 购物车商品数量
- 购物车商品数量
- 购物车是否有优惠券
- 购物车优惠券代码

加入购物车

触发器：事件等于 addToCart
- ecommerce.add.products[]的商品ID*
- ecommerce.add.products[]的商品名称*
- ecommerce.add.products[]的商品价格*
- ecommerce.add.products[]的商品数量*
- ecommerce.add.products[]的父SKU*
- ecommerce.add.products[]的变体*
- ecommerce.add.products[]的商品分类*

从购物车移除

触发器：事件等于 removeFromCart
- ecommerce.remove.products[]的商品ID*
- ecommerce.remove.products[]的商品名称*
- ecommerce.remove.products[]的商品价格*
- ecommerce.remove.products[]的商品数量*
- ecommerce.remove.products[]的变体*
- ecommerce.remove.products[]的商品分类*

全局数据层

触发器：事件等于 addToCart
- cart.add.products[]的商品ID*
- cart.add.products[]的商品名称*
- cart.add.products[]的商品价格*
- cart.add.products[]的商品数量*
- cart.add.products[]的父SKU*
- cart.add.products[]的变体*
- cart.add.products[]的商品分类*
触发器：事件等于 removeFromCart
- cart.remove.products[]的商品ID*
- cart.remove.products[]的商品名称*
- cart.remove.products[]的商品价格*
- cart.remove.products[]的商品数量*
- cart.add.products[]的父SKU*
- cart.remove.products[]的变体*
- cart.remove.products[]的商品分类*

订单

触发器：事件等于 purchase (Google Analytics)
- 交易ID
- 交易关联
- 交易总价
- 运输费用
- 税费
- 优惠券代码
- 折扣
- 交易小计
- 交易商品数组的产品SKU
- 交易商品数组的父SKU
- 交易商品数组的产品类型
- 交易商品数组的产品名称
- 交易商品数组的产品价格
- 交易商品数组的产品数量
附加订单日期（通用）
- 订单订单号
- 订单店铺名称
- 订单总价
- 订单小计
- 订单运费
- 订单税费
- 订单优惠券代码
- 订单优惠券名称
- 订单折扣
- 订单支付方式标题
- 订单支付方式代码
- 订单配送方式标题
- 订单配送方式代码
- 订单是否虚拟
- 订单是否为访客结账
- order.email_sha1**
- order.email**
- order.customer_id**
- 订单是否有前一个订单**
- 订单是否为第一个订单**
- 订单前一个订单数量**
- 订单是否为新客户**
- 订单商品数组的产品SKU
- 订单商品数组的产品ID
- 订单商品数组的父SKU
- 订单商品数组的产品ID
- 订单商品数组的产品名称
- 订单商品数组的父名称
- 订单商品数组的价格
- 订单商品数组含税价格
- 订单商品数组数量
- 订单商品数组小计
- 订单商品数组的产品类型
- 订单商品数组折扣金额
- 订单商品数组折扣百分比
- 订单商品数组税费金额
- 订单商品数组是否虚拟
- 订单商品数组变体
- 订单商品数组分类

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

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

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

贡献

想为此扩展做出贡献？最快的方式是在GitHub上提交拉取请求。

支持

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

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

magepal / magento2-googletagmanager

维护者

详细信息