README

快速入门

composer require ipunkt/laravel-analytics

您可以使用 Analytics 门面。

将以下变量添加到您的 .env 文件中，并设置为您喜欢的值

ANALYTICS_PROVIDER=GoogleAnalytics
ANALYTICS_TRACKING_ID=your-tracking-id

我们支持将整个配置作为环境变量。请参阅配置部分。

最后，在您的 </head> 结束标签上方放置此代码

{!! Analytics::render() !!}

现在您已经设置了Google Analytics。享受吧！

安装

将以下行添加到您的 composer.json 中

"require": {
	"ipunkt/laravel-analytics": "~3.0"
}

将 Ipunkt\LaravelAnalytics\AnalyticsServiceProvider::class, 添加到 app/config/app.php 中的 providers。

可选：将 'Analytics' => Ipunkt\LaravelAnalytics\AnalyticsFacade::class, 添加到 app/config/app.php 中的 aliases。

运行 php artisan vendor:publish --provider="Ipunkt\LaravelAnalytics\AnalyticsServiceProvider"

然后编辑 config 目录中的 analytics.php 以满足您的需求。我们在服务提供者中执行配置合并，因此您的本地设置将保持不变。

对于laravel 7.x，请使用3.x版本。

"require": {
	"ipunkt/laravel-analytics": "~3.0"
}

对于laravel 6.x，请使用2.x版本。

"require": {
	"ipunkt/laravel-analytics": "~2.0"
}

对于php < 7.2 或 laravel < 6.0，请使用1.x版本。

"require": {
	"ipunkt/laravel-analytics": "~1.0"
}

配置

提供者: 要使用的提供者，可能的提供者有：GoogleAnalytics，NoAnalytics

Google Analytics

跟踪ID: 跟踪ID，您的Google Analytics跟踪ID
跟踪域: 跟踪域，未设置或设置为 "auto" 以自动回退
跟踪器名称: 跟踪器名称
显示功能: 启用显示功能插件，可能的值：(true|false)
匿名化IP: 匿名化用户IP，可能的值：(true|false)
自动跟踪: 自动跟踪当前页面视图，可能的值：(true|false)
调试: 启用调试模式，可能的值：(true|false)
优化ID: 启用[Google Analytics](https://support.google.com/optimize/answer/6262084)的优化功能

基于环境的配置

您可以通过更改/设置 .env 文件中的环境变量来配置整个设置。（如果您使用Laravel Dusk，则为 .env.dusk 文件）。

以下是配置值和基于环境名称的映射

跟踪ID: ANALYTICS_TRACKING_ID
跟踪域: ANALYTICS_TRACKING_DOMAIN (auto)
跟踪器名称: ANALYTICS_TRACKER_NAME (t0)
显示功能: ANALYTICS_DISPLAY_FEATURES (false)
匿名化IP: ANALYTICS_ANONYMIZE_IP (true)
自动跟踪: ANALYTICS_AUTO_TRACK (true)
调试: ANALYTICS_DEBUG (本地环境为true)
优化ID: ANALYTICS_OPTIMIZE_ID

此行为从版本1.3.2中集成。

其他

disable_script_block: 您可以通过配置值禁用脚本块生成，可能的值：(true|false)，默认为false。

用法

在控制器操作（或其他任何地方）中使用以下语句来跟踪事件或页面视图

//	tracking the current page view
Analytics::trackPage();	// only necessary if `auto_track` is false or Analytics::disableAutoTracking() was called before

//	tracking an event
Analytics::trackEvent('category', 'action');

//	tracking a custom line
Analytics::trackCustom("ga('send', ......"); // this line will be added within the tracking script

可以为跟踪设置可选的活动

// creating a campaign
$campaign = new \Ipunkt\LaravelAnalytics\Data\Campaign('Sales2016');
$campaign->setMedium('web')->setSource('IT Magazine')->setKeyword('Hot stuff');
Analytics::setCampaign($campaign);

可以为跟踪设置用户ID

// creating a campaign
Analytics::setUserId($userIdentificationHash);

在您的视图或布局模板（例如，blade模板）中使用以下语句

{!! Analytics::render() !!}

对于Google Analytics，您应该在body标签下方放置该语句

<body>{!! Analytics::render() !!}

依赖注入

您可以通过引用接口注入分析提供程序

class PageController extends Controller
{
	public function show(\Ipunkt\LaravelAnalytics\Contracts\AnalyticsProviderInterface $analytics)
	{
		$analytics->setUserId(md5(\Auth::user()->id)); // identical to Analytics::setUserId(md5(\Auth::user()->id));
		return view('welcome');
	}
}

如何使用

GoogleAnalytics提供程序自动控制本地环境行为以进行测试目的。

有一个内置的提供程序称为NoAnalytics。这是用于测试环境，不跟踪任何内容。因此，您无需重写代码，只需在特殊环境配置的analytics配置中简单选择此provider。

在没有javascript的情况下跟踪度量

登录到Google Analytics并创建自定义定义。在那里创建自定义度量。例如：电子邮件打开，整型，最小值：0和最大值：1 这将作为metric1可用。
在您的邮件模板（或页面模板）中，您必须创建一个跟踪图像

<img src="{!! Analytics::trackMeasurementUrl('metric1', '1', new Event, new Campaign, md5($user)) !!}" width="1" height="1" style="background-color: transparent; border: 0 none;" />
就是这样

内容安全策略

从版本1.3开始，支持集成内容安全策略。

请调用提供程序接口实例上的withCSP()。

然后使用额外的包（或自行实现）martijnc/php-csp，并在您的中间件或javascript发送控制器中使用以下代码

use Phpcsp\Security\ContentSecurityPolicyHeaderBuilder;

$policy = new ContentSecurityPolicyHeaderBuilder();

// Set the default-src directive to 'none'
$policy->addSourceExpression(ContentSecurityPolicyHeaderBuilder::DIRECTIVE_DEFAULT_SRC, 'none');

// Add the nonce to the script-src directive
$policy->addNonce(ContentSecurityPolicyHeaderBuilder::DIRECTIVE_SCRIPT_SRC, $analytics->withCSP()->cspNonce());

foreach ($policy->getHeaders(true) as $header) {
    header(sprintf('%s: %s', $header['name'], $header['value']));
}

结果看起来像这样

array (size=1)
  0 => 
    array (size=2)
      'name' => string 'Content-Security-Policy' (length=23)
      'value' => string 'default-src 'none'; script-src 'nonce-RandomNonceStringFromAnalyticsProvider';' (length=58)

在渲染您的分析脚本时，将在您的脚本标签上自动添加nonce属性。

API文档

有关正确使用方法，请参阅Ipunkt\LaravelAnalytics\Contracts\AnalyticsProviderInterface.php

Analytics::render()

上下文：Blade模板，视图

为了渲染正确的javascript代码，它必须在所有布局文件中都有，以跟踪您的动作和页面调用。

/**
 * returns the javascript code for embedding the analytics stuff
 *
 * @return string
 */
public function render();

Analytics::trackPage()

上下文：控制器，操作代码

用于跟踪页面视图。

/**
 * track an page view
 *
 * @param null|string $page
 * @param null|string $title
 * @param null|string $hittype
 * @return void
 */
public function trackPage($page, $title, $hittype);

Analytics::trackEvent()

上下文：控制器，操作代码

用于跟踪事件

/**
 * track an event
 *
 * @param string $category
 * @param string $action
 * @param null|string $label
 * @param null|int $value
 * @return void
 */
public function trackEvent($category, $action, $label, $value);

Analytics::trackCustom()

上下文：控制器，操作代码

用于跟踪嵌入的分析代码中的自定义脚本行。

/**
 * track any custom code
 *
 * @param string $customCode
 * @return void
 */
public function trackCustom($customCode);

Analytics::enableDisplayFeatures()

上下文：控制器，操作代码

启用显示功能，覆盖配置设置display_features。

/**
 * enable display features
 *
 * @return GoogleAnalytics
 */
public function enableDisplayFeatures();

Analytics::disableDisplayFeatures()

上下文：控制器，操作代码

禁用显示功能，覆盖配置设置display_features。

/**
 * disable display features
 *
 * @return GoogleAnalytics
 */
public function disableDisplayFeatures();

Analytics::enableAutoTracking()

上下文：控制器，操作代码

启用自动跟踪，覆盖配置设置 auto_track。

/**
 * enable auto tracking
 *
 * @return GoogleAnalytics
 */
public function enableAutoTracking();

Analytics::disableAutoTracking()

上下文：控制器，操作代码

禁用自动跟踪，覆盖配置设置 auto_track。

/**
 * disable auto tracking
 *
 * @return GoogleAnalytics
 */
public function disableAutoTracking();

Analytics::trackMeasurementUrl()

上下文：Blade 模板、视图

有时您需要跟踪测量，例如打开电子邮件通讯。在那里您完全没有javascript。

/**
 * assembles an url for tracking measurement without javascript
 *
 * e.g. for tracking email open events within a newsletter
 *
 * @param string $metricName
 * @param mixed $metricValue
 * @param \Ipunkt\LaravelAnalytics\Data\Event $event
 * @param \Ipunkt\LaravelAnalytics\Data\Campaign $campaign
 * @param string|null $clientId
 * @param array $params
 * @return string
 */
public function trackMeasurementUrl($metricName, $metricValue, Event $event, Campaign $campaign, $clientId = null, array $params = array());

Analytics::setUserId($userId)

上下文：控制器，操作代码

向分析跟踪添加用户ID。此用户ID是用户依赖的唯一ID。但请注意，您不应与特殊用户本身有直接关系 - 它应针对每个用户进行分析的唯一。

此用户跟踪是在 Google Analytics 上实现的。

/**
 * sets an user id for user tracking
 *
 * @param string $userId
 * @return AnalyticsProviderInterface
 */
public function setUserId($userId);

Analytics::unsetUserId()

上下文：控制器，操作代码

删除用户ID也是可能的。

/**
 * unset an user id
 *
 * @return AnalyticsProviderInterface
 */
public function unsetUserId();

Analytics::setCampaign($campaign)

上下文：控制器，操作代码

将活动添加到当前跟踪。

此活动跟踪记录在 Google Analytics 中。

/**
 * sets a campaign
 *
 * @param Campaign $campaign
 * @return AnalyticsProviderInterface
 */
public function setCampaign(Campaign $campaign);

Analytics::unsetCampaign()

上下文：控制器，操作代码

删除活动也是可能的。

/**
 * unset a possible given campaign
 *
 * @return AnalyticsProviderInterface
 */
public function unsetCampaign();

Analytics::enableScriptBlock()

上下文：控制器，操作代码

启用 <script>...</script> 块标签的渲染。默认启用，因此您不需要调用此函数。

/**
 * render script block
 *
 * @return GoogleAnalytics
 */
public function enableScriptBlock();

Analytics::disableScriptBlock()

上下文：控制器，操作代码

禁用 <script>...</script> 块标签的渲染。

/**
 * do not render script block
 *
 * @return GoogleAnalytics
 */
public function disableScriptBlock();

Analytics::enableEcommerceTracking()

上下文：控制器，操作代码

启用电子商务跟踪。

/**
 * enable ecommerce tracking
 *
 * @return AnalyticsProviderInterface
 */
public function enableEcommerceTracking();

Analytics::disableEcommerceTracking()

上下文：控制器，操作代码

禁用电子商务跟踪。

/**
 * disable ecommerce tracking
 *
 * @return AnalyticsProviderInterface
 */
public function disableEcommerceTracking();

Analytics::ecommerceAddTransaction()

上下文：控制器，操作代码

将电子商务交易添加到跟踪代码。

/**
 * ecommerce tracking - add transaction
 *
 * @param string $id
 * @param null|string $affiliation
 * @param null|float $revenue
 * @param null|float $shipping
 * @param null|float $tax
 * @param null|string $currency
 *
 * @return AnalyticsProviderInterface
 */
public function ecommerceAddTransaction($id, $affiliation = null, $revenue = null, $shipping = null, $tax = null, $currency = null);

支持多货币跟踪，货币值定义在此处。

Analytics::ecommerceAddItem()

上下文：控制器，操作代码

将电子商务项目添加到跟踪代码。

/**
 * ecommerce tracking - add item
 *
 * @param string $id
 * @param string $name
 * @param null|string $sku
 * @param null|string $category
 * @param null|float $price
 * @param null|int $quantity
 * @param null|string $currency
 *
 * @return AnalyticsProviderInterface
 */
public function ecommerceAddItem($id, $name, $sku = null, $category = null, $price = null, $quantity = null, $currency = null);

支持多货币跟踪，货币值定义在此处。

Analytics::setCustom()

上下文：控制器，操作代码

添加自定义设置。

/**
 * sets custom dimensions
 *
 * @param string|array $dimension
 * @param null|string $value
 * @return AnalyticsProviderInterface
 */
public function setCustom($dimension, $value = null)

Analytics::withCSP()

上下文：控制器，操作代码

启用内容安全策略功能。

/**
 * enables Content Security Polity and sets nonce
 *
 * @return AnalyticsProviderInterface
 */
public function withCSP();

Analytics::withoutCSP()

上下文：控制器，操作代码

禁用内容安全策略功能。

/**
 * disables Content Security Polity
 *
 * @return AnalyticsProviderInterface
 */
public function withoutCSP();

Analytics::cspNonce()

上下文：控制器，操作代码

返回为内容安全策略标题生成的nonce。

/**
 * returns the current Content Security Policy nonce
 *
 * @return string|null
 */
public function cspNonce();

Analytics::setOptimizeId()

/**
 * set a custom optimize ID (the GTM-XXXXXX code)
 *
 * @param string $optimizeId
 *
 * @return AnalyticsProviderInterface
 */
public function setOptimizeId($optimizeId);

ipunkt / laravel-analytics

维护者

详细信息

README

快速入门

安装

配置

Google Analytics

基于环境的配置

其他

用法

依赖注入

如何使用

在没有javascript的情况下跟踪度量

内容安全策略

API文档

Analytics::render()

Analytics::trackPage()

Analytics::trackEvent()

Analytics::trackCustom()

Analytics::enableDisplayFeatures()

Analytics::disableDisplayFeatures()

Analytics::enableAutoTracking()

Analytics::disableAutoTracking()

Analytics::trackMeasurementUrl()

Analytics::setUserId($userId)

Analytics::unsetUserId()

Analytics::setCampaign($campaign)

Analytics::unsetCampaign()

Analytics::enableScriptBlock()

Analytics::disableScriptBlock()

Analytics::enableEcommerceTracking()

Analytics::disableEcommerceTracking()

Analytics::ecommerceAddTransaction()

Analytics::ecommerceAddItem()

Analytics::setCustom()

Analytics::withCSP()

Analytics::withoutCSP()

Analytics::cspNonce()

Analytics::setOptimizeId()