README

GoogleBundle

GoogleBundle 可以将各种与 Google 相关的服务添加到您的应用程序中。这包括 Google Analytics、Adwords 和静态地图。

安装

初始化子模块

git submodule add git@github.com:antimattr/GoogleBundle.git src/AntiMattr/GoogleBundle

应用程序内核

将 GoogleBundle 添加到应用程序内核的 registerBundles() 方法中

public function registerBundles()
{
    return array(
        new AntiMattr\GoogleBundle\GoogleBundle(),
    );
}

配置

Google Analytics

应用程序 config.yml

通过在应用程序的 config.yml 文件中添加以下内容来启用 Google Analytics 服务的加载

google:
    analytics:
        trackers:
            default:
                name:      MyJavaScriptCompatibleVariableNameWithNoSpaces
                accountId: UA-xxxx-x
                domain:    .mydomain.com
                trackPageLoadTime: true

视图

在 head 标签中或在你布局的 </body> 之前包含 Google Analytics Async 模板（模板将懒加载 _gaq）。

使用 twig

{% include "GoogleBundle:Analytics:async.html.twig" %}

特性

记录默认页面视图

Requires no additional code

发送自定义页面视图

$this->container()->get('google.analytics')->setCustomPageView('/profile/'.$username);

将页面视图添加到队列

注意：页面视图队列总是在自定义页面视图之前执行

$this->container()->get('google.analytics')->enqueuePageView('/my-first-page-view-in-queue');
$this->container()->get('google.analytics')->enqueuePageView('/my-second-page-view-in-queue');

电子商务跟踪

$transaction = new \AntiMattr\GoogleBundle\Analytics\Transaction();
$transaction->setOrderNumber('xxxx');
$transaction->setAffiliation('Store 777');
$transaction->setTotal(100.00);
$transaction->setTax(10.00);
$transaction->setShipping(5.00);
$transaction->setCity("NYC");
$transaction->setState("NY");
$transaction->setCountry("USA");
$this->get('google.analytics')->setTransaction($transaction);

$item = new \AntiMattr\GoogleBundle\Analytics\Item();
$item->setOrderNumber('xxxx');
$item->setSku('zzzz');
$item->setName('Product X');
$item->setCategory('Category A');
$item->setPrice(50.00);
$item->setQuantity(1);
$this->get('google.analytics')->addItem($item);

$item = new \AntiMattr\GoogleBundle\Analytics\Item();
$item->setOrderNumber('bbbb');
$item->setSku('jjjj');
$item->setName('Product Y');
$item->setCategory('Category B');
$item->setPrice(25.00);
$item->setQuantity(2);
$this->get('google.analytics')->addItem($item);

Google Adwords

应用程序 config.yml

通过在应用程序的 config.yml 文件中添加以下内容来启用 Google Adwords 服务的加载

google:
    adwords:
        conversions:
            account_create:
                id:    111111
                label: accountCreateLabel
                value: 0
            checkout_thanks:
                id:    222222
                label: checkoutThanksLabel
                value: 0

控制器

$this->get('google.adwords')->activateConversionByKey('account_create');

视图

像这样包含 Google Adwords 跟踪模板

{% include "GoogleBundle:Adwords:track.html.twig" %}

Google 地图 - 静态地图

应用程序 config.yml

通过在应用程序的 config.yml 文件中添加以下内容来启用 Google Maps 静态服务的加载（静态服务不需要 API 密钥）

google:
    maps: ~

控制器

use AntiMattr\GoogleBundle\Maps\StaticMap;
use AntiMattr\GoogleBundle\Maps\Marker;

...

$map = new StaticMap();
$map->setId("Paul");
$map->setSize("512x512");
$marker = new Marker();
$marker->setLatitude(40.596631);
$marker->setLongitude(-73.972359);
$map->addMarker($marker);
$this->container->get('google.maps')->addMap($map);

视图

像这样在模板中包含 Google Maps

{% if google_maps.hasMaps() %}
	{% for map in google_maps.getMaps() %}
		{% autoescape false %}
			{{ map.render }}
		{% endautoescape %}
	{% endfor %}
{% endif %}