C# Tracking and Analytics API Clientsを公開

2013年03月04日トピックスニュース

Piwikを魅力的なWeb解析ソフトにしているのは、オープンなAPIのサポートです。

Piwikは標準のAPIを用いて、全てのデータポイントにアクセスし、ユーザーを追跡することが出来ます。
ドキュメントはこちらを参照して下さい : http://piwik.org/docs/analytics-api

PiwikはPiwikのAPIにアクセスするためのPHP API clientと共に提供されています。世界中の開発者たちは、Piwikが多くの言語で利用できるようにAPI clientを開発してきました。 : Ruby (https://github.com/piwik/piwik-ruby-api & https://github.com/piwik/piwik-ruby-tracking), Java (https://github.com/piwik/piwik-java-tracking)、Python (https://github.com/piwik/piwik-python-api).

今回、私たちはC#によるTracking and Analytics API clients (https://github.com/piwik/piwik-dotnet-tracker & https://github.com/piwik/piwik-dotnet-api)を発表します。これらは、Piwik 1.5で完全にテストされ、動作しています。このAPIをGitHubでホスティングすることにより、コミュニティがAPIの発展に貢献し、開発に拍車がかかることに期待しています。

これらのAPI clientで、.NETアプリケーションからユーザーを追跡したり、Piwikのデータポイントにアクセスできるようになります。以下に使用例をいくつか示します :

ページビューの追跡：

`1`	`PiwikTracker piwikTracker =` `new` `PiwikTracker(1);`

`2`	`HttpWebResponse response = piwikTracker.doTrackPageView("Document title of current page view");`

ゴールの追跡：

`1`	`PiwikTracker piwikTracker =` `new` `PiwikTracker(1);`

`2`	`HttpWebResponse response = piwikTracker.doTrackGoal(1, 42.69F);`

新規サイトの追加：

01SitesManager siteManager = new SitesManager();
02siteManager.setTokenAuth("TOKEN_AUTH");
03string[] urls = { "http://brandNew", "http://shinyNew" };
04string[] excludedIps = { "123.123.13.1", "212.21.11.2" };
05string[] excludedQueryParameters = { "key1", "key2" };
06int newSiteId = siteManager.addSite(
07  "Brand New Site", 
08  urls, 
09  true, 
10  excludedIps, 
11  excludedQueryParameters, 
12  "UTC-4", 
13  "USD", 
14  "group2", 
15  new DateTime(2011, 01, 10)
16);

ブラウザのリポート：

01UserSettings userSettings = new UserSettings();
02userSettings.setTokenAuth("TOKEN_AUTH");
03ArrayList results = (ArrayList) userSettings.getBrowser(1, PiwikPeriod.MONTH, MagicDate.YESTERDAY);
04System.Console.WriteLine(results.Count + " results found");
05// Loop over each browser name (ie. LABEL)
06foreach (Hashtable result in results)
07 {
08  // Display browser stats
09  System.Console.WriteLine(
10   result[UserSettings.LABEL] + " " +
11   result[UserSettings.NB_UNIQ_VISITORS] + " " +
12   result[UserSettings.NB_VISITS] + " " +
13   result[UserSettings.NB_ACTIONS] + " " +
14   result[UserSettings.MAX_ACTIONS] + " " +
15   result[UserSettings.SUM_VISIT_LENGTH] + " " +
16   result[UserSettings.BOUNCE_COUNT] + " " +
17   result[UserSettings.NB_VISITS_CONVERTED] + " " +
18   result[UserSettings.SUM_DAILY_NB_UNIQ_VISITORS] + " " +
19   result[UserSettings.LOGO] + " " +
20   result[UserSettings.SHORTLABEL]
21  );
22}

そのほかのサンプルはこちらを参照して下さい : https://github.com/piwik/piwik-dotnet-api/blob/master/Piwik.Analytics.Samples/PiwikAnalyticsSamples.cs、https://github.com/piwik/piwik-dotnet-tracker/blob/master/Piwik.Tracker.Samples/PiwikTrackerSamples.cs

このAPIの開発はwww.GoDataFeed.comがスポンサード（主催）しています。

GoDatafeedとtxt clusiveのCEO、Ro Grosman氏の推薦文を紹介します。

Piwikはアクセス解析の合理化と、顧客への報告に役立っています；そのため、eコマースやmコマースの完全な分析パッケージを提供しながら、私たちは主力製品の開発に集中することができます。Piwikの費用対効果とは別に、プラットフォーム（C# API！）とシームレスに統合され、Piwikの印象的な機能とカスタマイズオプションにより、Piwikを私たちのソフトウェアに必要不可欠なものにしています。