编辑“Open Web Analytics/PHP Tracker”

{{Open Web Analytics top}}
OWA的[[PHP]]追踪[[客户端]]（PHP Tracker）可以在使用PHP编写的应用程序中使用，用来记录页面的访问量、电子商务交易量、动作事件以及定制你自己创建的事件。

==向你的PHP程序中添加PHP Tracker==
PHP Tracker可以通过以下代码添加到你的应用程序中：
     <?php
      require_once('owa_env.php');     //用来设置OWA的环境，包括了之后使用的路径；
      require_once(OWA_DIR.'owa_php.php');       //包括了追踪客户端类；
      $owa = new owa_php();              //创建新的追踪客户端对象；
      $owa->setSiteId('your_site_id');          //这一方法调用来设置你想追踪的站点ID，这个站点ID将会被添加到客户端追踪的所有事件   
                                                        中去。站点的所有ID是在基于WEB的OWA的站点登记页面上向OWA添加追踪站点时创建的。
      $owa->setPageTitle('My Web Page Title');     //设置将要被追踪页面的标题属性；
      $owa->setPageType('article');         //设置将要被追踪页面的页面类型；
      $owa->trackPageView();        //这一方法追踪页面访问事件；
     ?>

==点击量和DomStream追踪==
PHP Tracker是不能用来记录点击数和DomStreams的。但是OWA的PHP Tracker有一个可以叫做placehelperPageTags方法，可以用来包含Javascript Tracker来追踪点击数和DomStreams。

'''PlaceHelperPageTags()'''
  <?php
   $owa = & new owa_php;
   $owa->placeHelperPageTags();
  ?>
这些代码将会在你的[[网页]]中输出<script>标签，所以需要确保将它放在[[HTML]]文件中的<body>中。当然，你也可以告诉placeHelperPageTags不输出这个标签代码，而是将它存储在一个变量中，然后你可以向你的页面输出处理程序的某部分传递这个变量：
   <?php
     $owa = & new owa_php;
     $tag_code = $owa->placeHelperPageTags(false);
  ?>
==延迟首次点击==
当使用PHP Tracker来追踪页面的访问事件时，它通常在这方面显得非常有用，那就是使用一个专门的记录模块来消除“one hit sessions”（一次点击的会话），这些“one hit sessiongs”通常是robots使用用户代理操作的。这个记录模块将新用户的第一次页面访问事件存储在一个特殊的first_hit cookie中，这个cookie可以被一个专门的<img>标签（由helperPageTags方法来嵌入的）来访问，这可以保证这个新的用户是确确实实的浏览器，而不是一个蜘蛛robot。

可以通过下面方法来激活这个特殊的记录模块：

  owa_coreAPI::setSetting( 'base', 'delay_first_hit', true );
==追踪自定义的事件==
PHP Tracker可以用来追踪你自己定义的事件类型，下面是一个例子，用来追踪一个叫做“video_play”的自定义事件：
    $owa = new owa_php($config);     //创建一个新的Tracker实例；
   $owa->setSiteId('your_site_id');  //设置将要被追踪的站点的ID；
   $event = $owa->makeEvent();       //创建一个新的事件对象；
   $event->setEventType('video_play'); //设置事件的类型
   $event->set('video_id', 54345);    //设置一个属性
   $owa->trackEvent($event);          //追踪这个事件；

这个代码将会记录这一事件，并且将其提交到任何监听这个事件的事件处理器中，因为这是一个自定义的事件类型，所以你需要创建一个自定义的[Open Web Analytics/事件处理器|事件处理器]]，然后将其登记用来监听这个事件类型并且记录到数据库表中等一些动作。





==参考来源==
*[http://wiki.openwebanalytics.com/index.php?title=PHP_Invocation 参考来源]

{{Open Web Analytics}}

[[category:Open Web Analytics]]