README

GoogleBundle

GoogleBundle 允许您将各种与 Google 相关的服务添加到您的应用程序中。这些包括 Google Analytics、Adwords 和静态地图。此模块很久以前从 https://github.com/antimattr/GoogleBundle 分支，但现在作为一个独立项目进行维护。

安装

Composer

composer require meinfernbus/google-bundle

应用程序 Kernel

将 GoogleBundle 添加到您应用程序 kernel 的 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
                    anonymizeIp: false

视图

在 head 标签中包含 Google Analytics Async 模板或在其布局的 </body> 之前（模板将懒加载 _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
                    remarketing: false
                checkout_thanks:
                    id:    222222
                    label: checkoutThanksLabel
                    value: 0
                    remarketing: false
                remarketing:
                    id:    333333
                    label: "google-assigned-remarketing-label"
                    value: 0
                    remarketing: true

控制器

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

视图

像这样包含 Google Adwords 跟踪模板

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

Google Maps - 静态地图

应用程序 config.yml

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

google:
    maps:
        config:
            key: YOUR-API-KEY-FROM-GOOGLE
            host: YOUR-HOST // Host where the gmap image is served.
            (Optional, only needed if script is running from CLI. If not set $_SERVER is used)

在 https://code.google.com/apis/console/ 获取您的密钥

控制器

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

    ...

    /** @var \AntiMattr\GoogleBundle\MapsManager $googleContainer */
    $googleContainer = $this->container->get('google.maps');
    $map = $googleContainer->createStaticMap();
    $map->setId("Paul");
    $map->setSize("512x512");
    $marker = new Marker();
    $marker->setLatitude(40.596631);
    $marker->setLongitude(-73.972359);
    $map->addMarker($marker);
    $googleContainer->addMap($map);

视图

像这样在模板中包含 Google Maps

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