bolstad/analytrix

基于Google Analytics的Web应用的启动套件

0.4.2 2016-01-31 17:40 UTC

README

A PHP jump start kit for Google Analytics-based web apps. Setup your GA-API settings in your environments settings (or a .env file) and you are ready to go.

站在巨人的肩膀上: timgws/google-analytics-apivlucas/phpdotenv

代码示例

date_default_timezone_set( 'Europe/Stockholm' );
session_start();

include 'vendor/autoload.php';

$ding = new Analytrix\Basic(  new \Dotenv\Dotenv(__DIR__), new \timgws\GoogleAnalytics\API, new Analytrix\SessionStorageFile);

$ding->storage->setBucket('bucket name');
$ACCOUNT_ID = 'ga:123456-1';
echo "ACCOUNT_ID: $ACCOUNT_ID\n";

$ding->LoginText = 'Please login here';
$ding->DieOnNoSession = true;

$ding->run();

$auth = $ding->storage->get('auth');

if ( $auth = $ding->storage->get('auth') ) {

    echo "Yes, session is set\n";

    print_r( $auth );

    $accessToken = $auth['access_token'];
    $tokenExpires = $auth['expires_in'];

    $ding->ga->setAccessToken( $accessToken );
    $ding->ga->setAccountId( $ACCOUNT_ID );

    // Set the default params. For example the start/end dates and max-results
    $defaults = array(
        'start-date' => date( 'Y-m-d', strtotime( '-1 month' ) ),
        'end-date' => date( 'Y-m-d' ),
    );
    $ding->ga->setDefaultQueryParams( $defaults );

    // Example1: Get visits by date
    $params = array(
        'metrics' => 'ga:visits',
        'dimensions' => 'ga:date',
    );
    $visits = $ding->ga->query( $params );

    echo '<pre>';
    print_r( $visits );
    echo '</pre>';
    die;
}

安装

  • 通过composer安装此库:composer require 'bolstad/analytrix:dev-master'

  • 在Google APIs控制台中创建一个项目:https://code.google.com/apis/console/

  • 在“服务”下启用Analytics API

  • 在“API访问”下:创建一个Oauth 2.0 Client-ID

  • 提供一个产品名称,根据需要选择 Web ApplicationService Account

  • Web Application:在项目中设置一个指向您的应用程序URL的重定向URI

  • 使用这些名称配置ENV,即应用程序API变量:CLIENT_ID、CLIENT_SECRET & REDIRECT_URI

API参考

根据项目大小,如果项目足够小且简单,可以将参考文档添加到README中。对于中等大小到更大的项目,至少提供指向API参考文档的链接非常重要。

描述并使用代码示例展示如何运行测试。

贡献者

Christian Bolstad christian@bolstad.se

许可证

MIT