Statistic · Html5+參考

# [statistic]() Statistic模塊管理統計功能，用于提供應用內統計的能力，支持統計和分析用戶屬性和用戶行為數據。通過plus.statistic可獲取統計管理對象。 ### 方法： - [eventTrig](http://www.dcloud.io/docs/api/zh_cn/statistic.shtml#plus.statistic.eventTrig): 觸發事件 - [eventStart](http://www.dcloud.io/docs/api/zh_cn/statistic.shtml#plus.statistic.eventStart): 開始持續事件 - [eventEnd](http://www.dcloud.io/docs/api/zh_cn/statistic.shtml#plus.statistic.eventEnd): 結束持續事件 - [eventDuration](http://www.dcloud.io/docs/api/zh_cn/statistic.shtml#plus.statistic.eventDuration): 精確持續事件 ### 權限： permissions ~~~ "Statistic": { "description": "訪問統計插件" } ~~~ # [eventTrig]() 觸發事件 ~~~ void plus.statistic.eventTrig( id, label ); ~~~ ### 說明：觸發指定的統計事件，觸發的事件必須要先在統計網站上注冊事件ID。 ### 參數： - id: *( DOMString ) 必選 *要觸發的事件ID - label: *( DOMString ) 可選 *要觸發事件的標簽 ### 返回值： void : 無 ### 示例： ~~~ <!DOCTYPE html> <html> <head> <meta charset="utf-8"/> <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/> <title>Statistic Example</title> <script type="text/javascript"> // 監聽plusready事件 document.addEventListener( "plusready", function(){ // 擴展API加載完畢，現在可以正常調用擴展API plus.statistic.eventTrig( "example", "open" ); }, false ); </script> </head> <body> </body> </html> ~~~ # [eventStart]() 開始持續事件 ~~~ void plus.statistic.eventStart( id, label ); ~~~ ### 說明：開始指定的持續事件統計，當事件結束時調用eventEnd方法，，觸發的事件必須要先在統計網站上注冊事件ID。 ### 參數： - id: *( DOMString ) 必選 *要觸發的事件ID - label: *( DOMString ) 可選 *要觸發事件的標簽 ### 返回值： void : 無 ### 示例： ~~~ <!DOCTYPE html> <html> <head> <meta charset="utf-8"/> <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/> <title>Statistic Example</title> <script type="text/javascript"> var winsetting = null; // 監聽plusready事件 document.addEventListener( "plusready", function(){ // 擴展API加載完畢，現在可以正常調用擴展API winsetting = plus.webview.create( "setting.html" ); winsetting.addEventListener( "loaded", function(){ plus.statistic.eventStart( "setting" ); }, false ); winsetting.addEventListener( "close", function(){ plus.statistic.eventEnd( "setting" ); }, false ); winsetting.show(); }, false ); </script> </head> <body> </body> </html> ~~~ # [eventEnd]() 結束持續事件 ~~~ void plus.statistic.eventEnd( id, label ); ~~~ ### 說明：結束指定的持續事件統計，需先調用eventStart方法開始持續事件統計，觸發的事件必須要先在統計網站上注冊事件ID。 ### 參數： - id: *( DOMString ) 必選 *要觸發的事件ID - label: *( DOMString ) 可選 *要觸發事件的標簽 ### 返回值： void : 無 ### 示例： ~~~ <!DOCTYPE html> <html> <head> <meta charset="utf-8"/> <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/> <title>Statistic Example</title> <script type="text/javascript"> var winsetting = null; // 監聽plusready事件 document.addEventListener( "plusready", function(){ // 擴展API加載完畢，現在可以正常調用擴展API winsetting = plus.webview.create( "setting.html" ); winsetting.addEventListener( "loaded", function(){ plus.statistic.eventStart( "setting" ); }, false ); winsetting.addEventListener( "close", function(){ plus.statistic.eventEnd( "setting" ); }, false ); winsetting.show(); }, false ); </script> </head> <body> </body> </html> ~~~ # [eventDuration]() 精確持續事件 ~~~ void plus.statistic.eventDuration( id, duration, label ); ~~~ ### 說明：精確時長的持續事件統計，觸發的事件必須要先在統計網站上注冊事件ID。 ### 參數： - id: *( DOMString ) 必選 *要觸發的事件ID - duration: *( Number ) 必選 *要觸發事件持續的時間，單位為ms - label: *( DOMString ) 可選 *要觸發事件的標簽 ### 返回值： void : 無 ### 示例： ~~~ <!DOCTYPE html> <html> <head> <meta charset="utf-8"/> <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/> <title>Statistic Example</title> <script type="text/javascript"> // 監聽plusready事件 document.addEventListener( "plusready", function(){ // 擴展API加載完畢，現在可以正常調用擴展API }, false ); function feedback() { var start = new Date(); // Do something for feedback var end = new Date(); var d = end.getTime() - start.getTime(); plus.statistic.duration( "feedback", d ); } </script> </head> <body> <button onclick="feedback();">feedback</button> </body> </html> ~~~