README

对于 Laravel 5.x，请查看 版本 2.5.0

对于 Laravel 4.x，请查看 版本 1.1.0

将 Googlitics 视为轻松将 Google Analytics 集成到 Laravel 的方法，它提供了一系列辅助工具以加速应用程序跟踪的利用。这些包括

• Analytics::trackPage
• Analytics::trackScreen
• Analytics::trackEvent
• Analytics::trackTransaction
• Analytics::trackItem
• Analytics::trackMetric
• Analytics::trackException
• Analytics::trackCustom
• Analytics::render

安装

首先通过 Composer 安装此包。编辑您项目的 composer.json 文件，以包含 cornford/googlitics。

"require": {
	"cornford/googlitics": "3.*"
}

接下来，从终端更新 Composer

composer update

此操作完成后，下一步是添加服务提供者。打开 app/config/app.php，并将新项目添加到 providers 数组中。

Cornford\Googlitics\AnalyticsServiceProvider::class,

下一步是引入外观。打开 app/config/app.php，并将新项目添加到 aliases 数组中。

'Analytics'         => Cornford\Googlitics\Facades\AnalyticsFacade::class,

最后，我们需要将配置文件引入到您的应用程序/目录中。

php artisan vendor:publish --provider="Cornford\Googlitics\AnalyticsServiceProvider" --tag=googlitics

这样就可以了！您已经准备好开始使用了。

配置

您现在可以按照几个简单的步骤配置 Googlitics。打开 app/config/packages/cornford/googlitics/config.php 并根据需要更新选项。

• enabled - 启用 Google Analytics 跟踪。
• id - Google Analytics 跟踪标识符，用于将 Googlitics 连接到 Google Analytics。
• domain - 正在被跟踪的域。如果希望 Googlitics 自动设置当前域，则将其保留为 'auto'。否则，输入您的域名，例如 google.com
• anonymise - 在通过 Googlitics 跟踪用户时匿名化用户的 IP 地址。
• automatic - 启用自动跟踪，以确保用户自动由 Googlitics 跟踪。

用法

使用起来非常简单，就像在任何您觉得合适的 Controller / Model / File 中使用 Analytics 类一样

Analytics：

这将为您提供访问权限

• 跟踪页面
• 跟踪屏幕
• 跟踪事件
• 跟踪交易
• 跟踪项目
• 跟踪指标
• 跟踪异常
• 跟踪自定义
• 渲染

跟踪页面

trackPage 方法允许跟踪一个页面，可选参数包括页面、标题和跟踪类型。

Analytics::trackPage();
Analytics::trackPage('Homepage', 'Homepage Title');
Analytics::trackPage('Homepage', 'Homepage Title', Analytics::TYPE_PAGEVIEW);

跟踪屏幕

trackScreen 方法允许跟踪应用程序中的一个屏幕，参数为屏幕名称。

Analytics::trackScreen('Homepage');

跟踪事件

trackEvent 方法允许跟踪一个事件，参数包括类别和标签、值等可选参数。

Analytics::trackEvent();
Analytics::trackEvent('User', 'Sign up');
Analytics::trackEvent('User', 'Sign up', 'User - Sign up', date());

跟踪交易

trackTransaction 方法允许跟踪一个电子商务交易，参数包括标识符和可选的选项参数，如联盟、收入、运费、税费，以键值数组格式。

Analytics::trackTransaction('123');
Analytics::trackTransaction('123', ['affiliation' => 'Clothing', 'revenue' => '12.99', 'shipping' => '7.99', 'tax' => '1.59']);

跟踪项目

trackItem 方法允许跟踪一个电子商务项目，参数包括标识符、名称，以及可选的选项参数，如 SKU、类别、价格、数量，以键值数组格式。

Analytics::trackItem('123', 'Socks');
Analytics::trackItem('123', 'Socks', ['sku' => 'PR123', 'category' => 'Clothing', 'price' => '7.99', 'quantity' => '1']);

跟踪指标

trackMetric 方法允许跟踪一个指标，参数包括类别和键值数组格式的选项参数。

Analytics::trackMetric('Metric', ['metric1' => 100]);

跟踪异常

trackException 方法允许跟踪应用程序异常，可选参数包括描述和致命性。

Analytics::trackException();
Analytics::trackException('500 Server Error', true);

跟踪自定义

《trackCustom》方法允许使用单个参数跟踪自定义项。

Analytics::trackCustom("ga('custom', 'parameter');");

渲染

《render》方法允许将所有跟踪项渲染到页面上，此方法可以包含在视图（Views）中或作为控制器传递的参数添加。

Analytics::render();

许可证

Googlitics 是开源软件，根据MIT 许可证授权。