README

此包将 Google 的增强电子商务跟踪（GEEC）集成到 Sylius 中。

文档

基本安装

1. 使用 Composer 安装包

   $ composer require webburza/sylius-google-ecommerce-bundle

2. 启用包

3. 添加特定于应用程序的包配置

   app/config/config.yml

   webburza_sylius_google_ecommerce: key: %webburza.sylius.google_ecommerce.key%

4. 添加特定于应用程序的包参数（主要是您的 Google Analytics 密钥）

   app/config/parameters.yml

   webburza.sylius.google_ecommerce.key: UA-12345678-1

5. 在您的 Twig 布局中启用 GEEC 块渲染

   <!-- App/ShopBundle/Resources/views/layout.html.twig -->
   
       <!-- add -->
       {{ google_ecommerce_render() }}
       <!-- /add -->
       </body>
   </html>
   

完成这些后，您应该有一个功能性的 Google Analytics 跟踪（不包含电子商务部分）。您可以使用 Google Analytics Debugger 来验证它是否工作。

启用电子商务集成

要启用包的电子商务部分，我们需要告诉它用户正在做什么。我们通过使用预定义的 Twig 函数来实现这一点。

直接操作函数

这些是对用户操作的直接响应。

• {{ google_ecommerce_impression(variant, {"list": list, "position": loop.index}) }}
  标记列表中的产品印象。
  参数
  • variant，Sylius ProductVariant 实例
  • list，产品显示的列表（字符串）名称，例如 "search results"
  • position，产品在该列表中的位置，从 1 开始
• {{ google_ecommerce_details(variant) }}
  仅用于表示我们正在查看单个产品详细信息视图。
  参数
  • variant，Sylius ProductVariant 实例
• {{ google_ecommerce_checkout(order, {'step': 2}) }}
  指示结账进度。
  参数
  • order，Sylius Order 实例
  • step，我们目前在哪个步骤？请确保根据文档中的说明配置结账漏斗。
• {{ google_ecommerce_purchase(order) }}
  指示成功交易。
  参数
  • order，Sylius Order 实例

操作处理函数

这些函数将渲染处理程序，该处理程序将对用户操作做出反应并调用直接操作。

• {{ google_ecommerce_click(variant, {"list": list}) }}
  跟踪列表中的产品点击。
  参数
  • variant，Sylius ProductVariant 实例
  • list，产品显示的列表（字符串）名称，例如 "search results"
• {{ google_ecommerce_cart(variant, {'action': 'add', 'callable': 'function(product) {product[\'variant\'] = \'TODO: which variant?\'; return product;}'}) }}
  将产品变体添加到购物车。
  参数
  • variant，Sylius ProductVariant 实例
  • event，要对其做出反应的 JavaScript 事件，默认为 "submit"
  • action，始终为 "add"
  • callable，一个可选的 JavaScript 回调，它添加额外的产品信息（如变体）
• {{ google_ecommerce_cart(variant, {'event': 'click', 'action': 'remove', 'variant': item.vars.value.variant.__toString()}) }}
  从购物车中删除产品。
  参数
  • variant，Sylius ProductVariant 实例
  • event，因为我们使用超链接，所以此值必须是 "click"
  • action，始终为 "remove"
  • variant，因为我们知道渲染时产品的变体是什么，所以我们不需要像添加时那样使用 JS 回调。
• {{ google_ecommerce_render() }}
  渲染当前GEEC块。这是在基本安装中使用的函数。
  参数：无。

许可证

此组件受MIT许可证保护。

贡献

待办事项