README

Laravel 包，用于连接 Google Analytics

变更日志

• 1.0.4 | 2015-08-21
• 添加了新的用户度量指标
• 删除了重复代码
• PHP 文档改进
• 代码风格修复

安装

1. 运行 composer require jmpatricio/easy-google-analytics

2. 将 Jmpatricio\EasyGoogleAnalytics\EasyGoogleAnalyticsServiceProvider 添加到您的服务提供者

3. 安装完成。

配置

这一步是最重要的。让我们让它简单一点

• 打开终端并运行：php artisan config:publish "jmpatricio/easy-google-analytics"。
• 现在您有 {$projectRoot}/app/config/packages/jmpatricio/easy-google-analytics/config.php 文件，其中

return [
    'client_id'            => 'xxx.apps.googleusercontent.com',
    'service_account_name' => 'xxx@developer.gserviceaccount.com',
    'keyfile'              => storage_path('xxx.p12'),
    'analytics_id'         => 'ga:xxx',
];

• 现在您需要前往您的 Google 开发者账户并配置一个新的项目。 (如果您已经有了项目，请忽略此步骤)

• 您需要为您的项目启用 Analytics API。在项目内部，转到“APIs & auth”，然后进入“APIs”。启用分析

• 在项目内部，在开发者控制台中，转到“APIs & auth”内的“Credentials”，创建一个新的服务帐户

• 选择一个 p12 密钥

• 将您的 p12 密钥保存在 {$projectRoot}/app/storage 内。

• 编辑配置文件并定义 keyfile 条目：'keyfile' => storage_path('Easy-Google-Analytics-da31194a03c6.p12'),

• 现在您有了关于凭证的信息 点击电子邮件，随后会出现以下屏幕：

• 将客户端 ID 和电子邮件地址添加到配置中

return [
	'client_id'            => '459875649264-vs034lhn7ocddcch0nq1vdurst1mr8bu.apps.googleusercontent.com',
	'service_account_name' => '459875649264-vs034lhn7ocddcch0nq1vdurst1mr8bu@developer.gserviceaccount.com',
	'keyfile'              => storage_path('Easy-Google-Analytics-da31194a03c6.p12'),
	'analytics_id'         => 'ga:xxx',
];

• 现在唯一缺少的是分析 ID
• 转到您的分析仪表板，然后在管理员区域选择视图设置：
• 复制视图 ID 并添加到配置中：

配置将是以下内容

return [
    'client_id'            => '459875649264-vs034lhn7ocddcch0nq1vdurst1mr8bu.apps.googleusercontent.com',
    'service_account_name' => '459875649264-vs034lhn7ocddcch0nq1vdurst1mr8bu@developer.gserviceaccount.com',
    'keyfile'              => storage_path('Easy-Google-Analytics-da31194a03c6.p12'),
    'analytics_id'         => 'ga:106917230',
];

• 现在我们需要在分析控制台中添加服务帐户的权限

• 转到分析管理控制台，添加具有相应权限的用户：

• 配置完成！

基本用法

$connector = new Jmpatricio\EasyGoogleAnalytics\Connector();

// Total visits for today
$totalVisitors = $connector->getTotalVisits();

// Total visits with from-to dates
$totalVisitors = $connector->getTotalVisits(new Carbon\Carbon('2015-08-01'), new Carbon\Carbon('2015-08-05'));

// Active users
$activeUsers = $connector->getActiveUsers();

// Generic API Access

// GA API
$fromDate = new Carbon\Carbon('2015-08-01');
$toDate = new Carbon\Carbon('2015-08-05');
$serviceResponse = $connector->getGA($fromDate,$toDate,'ga:visitors')

// Realtime API
$serviceResponse = $connector->getRT('rt:activeUsers',['dimensions'=>'rt:country']);