编辑“Open Web Analytics/电子商务追踪”

{{Open Web Analytics top}}
==概述==
想要追踪电子商务交易，你必须使用下面列举的OWA的电子商务追踪方法。这些方法都是可以在Javascript Tracker和PHP Tracker（即一个叫做owa_client PHP类）中使用。
*'''addTransaction ：'''  用来描述电子商务交易，告诉OWA关于某交易的整体情况，包括订单账号、商品数量、总的税收、以及邮寄方式。
*'''addTransactionLineItem:'''  用来告诉OWA向交易添加的行项目。一个好的关于行项目的理解就是，一个发票上用来描述购买商品的信息的一些行，比如单价、数量等。与我们日常生活中的普通交易类似。这些行项目存储在与他们的交易通过订单ID联系在一起存储在OWA中。
*'''trackTransaction :''' 这一方法主要是向OWA传送交易以及其行项目，用来处理。
*'''开启电子商务报告：''' 如果你想了解每一个站点下的电子商务交易情况的话，则需要开启电子商务报告。这是一个站点设置，可以在OWA管理界面中访问Administration -> Tracked Sites -> your site -> settings 来进行设置。
==Javascript举例==
   <!-- Start Open Web Analytics Tracker -->
   <script type="text/javascript">
   //<![CDATA[
   var owa_baseUrl = 'http://standalone-php5-test.openwebanalytics.com/owa/';
   var owa_cmds = owa_cmds || [];
   owa_cmds.push(['setSiteId', '67b3053d792527f6b62e55b20453ad2c']);
   owa_cmds.push(['trackPageView']);
   owa_cmds.push(['trackClicks']);
   owa_cmds.push(['trackDomStream']);
   owa_cmds.push(['addTransaction', 
           'order123', // 订单ID，来自你的电子商务系统 -必须的
           'test-app',  // 产生这个交易的来源或者是商店名称
           '100.50', // 总收益—必须的
           '1.25', //  所交的税
           '3.50',  //  邮寄费用
           'paypal', // 支付网关的名称
           'United States', // 国家
           'CA', // 所在州
           'Palo Alto' //城市
    ]);
   owa_cmds.push(['addTransactionLineItem', 'order123', 'SKU123', 'widget', 'things', 10.00, 5]);
   owa_cmds.push(['addTransactionLineItem', 'order123', 'SKU456', 'widget', 'things', 10.10, 5]);
   owa_cmds.push(['trackTransaction']);
   (function() {<nowiki>
	var _owa = document.createElement('script'); _owa.type = 'text/javascript'; _owa.async = true;
	_owa.src = owa_baseUrl + 'modules/base/js/owa.tracker-combined-min.js';
	var _owa_s = document.getElementsByTagName('script')[0]; _owa_s.parentNode.insertBefore(_owa, _owa_s);
  }());</nowiki>
  //]]>
  </script>
  <!-- End Open Web Analytics Code -->		



==PHP举例==
  <?php		
  require_once('owa/owa_php.php');
		
  $owa = new owa_php();
  $owa->setSiteId('67b3053d792527f6b62e55b20453ad2c');
  $pv = $owa->makeEvent();
  $pv->setPageTitle('Commerce PHP API Test Page - 布啦布啦BlaBla.cn');
  $owa->trackPageView($pv);
  $order_id = xyz321;
  $owa->addTransaction(
          $order_id, // 由购物车或电子商务程序产生的交易的唯一编码，订单号
          'My Online Store', // 商城的名称 
          '100.23', // 总收益，精确到小数点两位 
          '20.20', //  总税务，精确到小数点两位 
          '15.30', //  总的运输费用，精确到小数点两位  
          'paypal', // 支付网关的名称
          'http://domain.com/page/that/transaction/occured', // 在批处理中是可选的.这是产生该交易的页面的url地址，只有在同一 
 个请求中没有调用$owa->trackPageView()时使用。
          'some_session_id' // 在批处理模式下可选
 );
  // 可以重复使用下面方法。
  $owa->addTransactionLineItem(
          $order_id, 
          'sku123', // 购物车或电子商务程序为该产品指定的唯一的SKU id ，库存号
          'My Product Name', // 商品名称
          'My Category', // 商品所在分类名称
          '14.95', // 商品的单价，精确到小数点后两位
          '10' // 订单中该商品的数量
 );
 // 向OWA发送交易和行项目，用来进行处理
 $owa->trackTransaction();
 ?>

==追踪延迟的电子商务交易==
PHP版本的addTransaction方法中含有两个额外的参数，允许你记录在前一个会话中发生的交易。当用户发送网页请求的时候发生权限不够的时候，使用$page_id和$original_session_id参数。这经常在信用卡提供者没有实时的身份验证（比如PayPal的IPN）。

将这些延迟的交易信息记录下来，你必须存储用户的OWA会话ID以及交易成功时用户将会看到的页面的URL，这样在之后可以被传递到addTransaction中，你可以通过下面的PHP代码在他们的会话cookie中检索用户的session_id：
   $session_id = owa_coreAPI::getStateParam('s', sid');
或者使用OWA的Javascript方法 getState:
   var session_id = OWA.util.getState('s', 'sid');

==通过log.phpREST界面追踪电子商务事件==
您可以使用OWA中的基于REST的日志接口，通过将它们粘贴到log.php来记录电子商务交易。下面的例子显示的名称值对需要使用该接口用于跟踪电子商务交易和单行项目：
 <nowiki> http://domain/path/to/owa/log.php?
		owa_event_type=ecommerce.transaction&
		owa_ct_order_id=foo&
		owa_ct_order_source=foo&
		owa_ct_total=100.23&
		owa_ct_tax=10.21&
		owa_ct_shipping=20.11&
		owa_ct_gateway=paypal&
		owa_page_url=some_encoded_url&
		owa_ct_line_items[0][li_order_id]=foo&
		owa_ct_line_items[0][li_sku]=foo&
		owa_ct_line_items[0][li_product_name]=foo&
		owa_ct_line_items[0][li_category]=foo&
		owa_ct_line_items[0][li_unit_price]=10.34&
		owa_ct_line_items[0][li_quantity]=10&
		owa_original_session_id=some_session_id</nowiki>
==参考来源==
*[http://wiki.openwebanalytics.com/index.php?title=Ecommerce_Tracking 参考来源]

{{Open Web Analytics}}

[[category:Open Web Analytics]]