README

快速入门

composer require bitsnbolts/laravel-analytics

您可以使用Analytics外观。

在您的.env文件中添加以下变量，并按您的喜好设置

ANALYTICS_PROVIDER=GoogleAnalytics
ANALYTICS_TRACKING_ID=your-tracking-id

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

最后，在您的</head>关闭标签上方放置以下代码

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

现在您已经启用了Google Analytics。享受吧！

安装

在您的composer.json中添加以下行

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

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

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

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

然后根据需要编辑config中的analytics.php。我们在服务提供程序中进行配置合并，因此您的本地设置将保持不变。

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

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

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

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

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

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

配置

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

Google Analytics

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

基于环境的配置

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

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

tracking_id: ANALYTICS_TRACKING_ID
tracking_domain: ANALYTICS_TRACKING_DOMAIN (auto)
tracker_name: ANALYTICS_TRACKER_NAME (t0)
display_features: ANALYTICS_DISPLAY_FEATURES (false)
anonymize_ip: ANALYTICS_ANONYMIZE_IP (true)
auto_track: ANALYTICS_AUTO_TRACK (true)
debug: ANALYTICS_DEBUG (本地环境上为true)
optimize_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 \Bitsnbolts\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(\Bitsnbolts\LaravelAnalytics\Contracts\AnalyticsProviderInterface $analytics)
	{
		$analytics->setUserId(md5(\Auth::user()->id)); // identical to Analytics::setUserId(md5(\Auth::user()->id));
		return view('welcome');
	}
}

如何使用

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

有一个内置的提供者叫做 NoAnalytics。这是为测试环境设计的，不会跟踪任何内容。因此，您无需重写代码，只需在您的特定环境配置中简单地选择这个 provider 在 analytics 配置中即可。

在没有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文档

有关正确使用方法，请参阅 Bitsnbolts\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 \Bitsnbolts\LaravelAnalytics\Data\Event $event
 * @param \Bitsnbolts\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);

bitsnbolts / 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()