README

工作中

这个 Symfony 扩展包将简化与 Google Analytics 的交互管理。

安装

将以下内容添加到 composer.json 配置文件中的 require 块

"hamaryuginh/google-analytics-bundle": "dev-master"

然后，在您的 symfony 项目根目录中执行以下命令

$ composer install

配置

在 app/AppKernel.php 中注册该扩展包

public function registerBundles()
{
    ...
    new Hamaryuginh\GoogleAnalyticsBundle\HamaryuginhGoogleAnalyticsBundle(),
    ...
}

将以下内容添加到 app/config/config.yml

hamaryuginh_google_analytics:
    account: UA-XXXXXX-Y   # Your GA account ID
    debug:   false         # [Facultative] set to true to activate debug mode
    enabled: false         # Enable or disable tracking

在 </head> 标签之前添加以下内容

{{ ga_initialize() }}

在文档末尾，在 </body> 标签之前添加

{{ ga_start() }}

安装资源（从您的 symfony 项目根目录）

$ php app/console assets:install --symlink

使用方法

全局上，您可以在任何标签上定义一个 data-ga-xxx 属性，并将参数作为 JSON 字符串提供（例如：data-ga-page="{'page':'/home'}"）

页面跟踪

在 <body> 标签或任何其他标签上添加 data-ga-page 属性

<body data-ga-page="{'page':'/home'}">
  ...
</body>

或者

<body>
  ...
  <div data-ga-page="{'page':'/home'}"></div>
  ...
</body>

或者您想要的任何内容...

警告！ data-ga-page 必须在每个文档中只定义一次！

有关更多信息，请参阅页面跟踪文档。

自定义维度和度量

在任何标签上添加 data-ga-dimension 属性

<body>
  ...
  <div data-ga-dimension="{'index':1, 'value':'Hello'}"></div>
  <div data-ga-dimension="{'index':2, 'value':'World!!!'}"></div>
  ...
  <div data-ga-metric="{'index':18, 'value':8000}"></div>
  <div data-ga-metric="{'index':19, 'value':24.99}"></div>
  ...
</body>

有关更多信息，请参阅自定义维度和度量文档。

事件跟踪（目前仅支持 "click" 事件）

在任何标签上添加 data-ga-event 属性

<body>
  ...
  <a href="#" data-ga-event="{'eventCategory':'Link','eventAction':'click','eventLabel':'link 1'}">Home</a>
  ...
  <div data-ga-event="{'eventCategory':'Element','eventAction':'click','eventLabel':'On div'}"></div>
  ...
</body>

有关更多信息，请参阅事件跟踪文档。

社交互动（目前仅支持自家的社交按钮）

在任何标签上添加 data-ga-social 属性

<body>
  ...
  <a href="http://example.com/hello" target="_blank" data-ga-social="{'socialNetwork':'facebook','socialAction':'like','socialTarget':'http://example.com/hello'}">
    <img src="facebook.png" alt="Facebook">
  </a>
  ...
</body>

有关更多信息，请参阅社交互动文档。

最后但同样重要的是

显然，您仍然可以通过默认方式使用 Google Analytics 库

<script type="text/javascript">
  ga('set', 'dimension1', 'toto');
  ...
  ga('send', 'event', ...);
  ...
  ga('send', 'pageview');
</script>

电子商务使用

1. 开始电子商务跟踪

请确保只声明一次，并在初始化 GA 跟踪器之后（参见配置）

{{ ga_ecommerce_initialize() }}

2. 添加交易

交易就像一个购物篮

{{ ga_ecommerce_addTransaction('transactionid',
                            'affiliation',
                            'totalAmount',
                            'shipping',
                            'taxRate') }}

3. 向交易添加项目

项目是购物篮中的产品。您可以根据需要在交易中添加任意数量的项目。

{{ ga_ecommerce_addItem('transactionId',
                        'productName',
                        'sku',
                        'category',
                        'price',
                        'quantity') }}

4. 将交易发送到 GA

在添加所有项目到交易后调用此命令。

{{ ga_ecommerce_send() }}

祝您玩得开心！

贡献

请随意提出问题或添加拉取请求。

hamaryuginh / google-analytics-bundle

维护者

详细信息

README

安装

配置

使用方法

电子商务使用

贡献