內容簡介
追蹤您可安裝產品的分佈狀況。本外掛提供 AJAX API 接受安裝註冊與使用資料，並提供將產品升級推送給客戶的機制。也提供使用自訂標記追蹤使用客戶並推送客製化升級給這些客戶。
外掛 REST API：
http://www.yoursite.com/wp-admin/admin-ajax.php
操作：
regupdate - 新增\更新註冊記錄
useapp - 更新產品\版本使用狀況和被註冊的客戶使用情況
upgrade - 檢查產品高版本號升級
注意：產品和註冊記錄會自動透過接收端 API 呼叫新增\更新。只有升級是透過管理控制台新增的。
範例（.Net API 呼叫以註冊客戶）：
**註冊**
var response = HttpHelper.Post(URL, new NameValueCollection() {
{ "action", "regupdate" },
{ "sky", SecretKey }, //Secret ID 必須與 WordPress | 設定 | InstallTracker 裡的 ID 相符
{ "product", Product },
{ "ver", Version },
{ "custom", Custom },
{ "trackid", RegID }, //從先前註冊中取得的 TrackID，可用於更新記錄，若為新註冊則空白
{ "key", key }, //您的安裝產生的 GUID (格式：00000000-0000-0000-0000-000000000000 )
{ "name", name },
{ "email", email },
{ "phone", phone },
{ "contact", contact },
{ "addr", address },
{ "city", city },
{ "state", state },
{ "zipcode", zipcode}
});
var str = System.Text.Encoding.Default.GetString(response);
if (str != null && str.Equals("0")) return false; //Secret key 可能不符合
var outObject = JsonConvert.DeserializeObject<Registration>(str);
if (outObject.valid == "TRUE")
{
RegID = outObject.regID; //返回的註冊 ID 將可供未來的更新使用
return true;
}
**使用**
var pars = new NameValueCollection() {
{ "action", "useapp" },
{ "sky", SecretKey },
{ "product", Product },
{ "ver", Version },
{ "custom", Custom },
{ "trackid", RegID }, //從先前註冊中取得的 TrackID（自選填）
{ "key", key } //您的安裝產生的 GUID（自選填）
};
**升級**
var pars = new NameValueCollection() {
{ "action", "upgrade" },
{ "sky", SecretKey },
{ "product", Product },
{ "ver", Version },
{ "custom", Custom },
};
可獲得 .Net API 封裝的客戶端程式庫 www.kyght.com (http://www.kyght.com/?page_id=147)
其他客戶端程式庫將在 GitHub 上可得 (https://github.com/kyght/InstallTracker)。
.Net 客戶端 DLL 用法
installTrack = new Tracker(\”http://www.yoursite.com/wp-admin/admin-ajax.php\”, \”YourProduct\”, \”2.1.16.80\”, \”666745\”);
installTrack.Register(String key, String name, String email, String contact, String phone, String address, String city, String state, String zipcode)
installTrack.Usage(String key, OnTrackerComplete onComplete )
installTrack.UpgradeAvailable(OnUpgradeAvailable onUpgrade)
ins
外掛標籤
開發者團隊
原文外掛簡介
Tracks the distribution of your installable products. The plugin provides an ajax API to accept installation registrations & usage data. Also provides a mechanism for pushing product upgrades to clients. Custom build tags can also be used to track clients with customized products and push custom upgrades to these clients.
Plugin REST API
http://www.yoursite.com/wp-admin/admin-ajax.php
Actions:
regupdate - Adds\Updates a registration record
useapp - Updates product\version usage and registered client use
upgrade - Checks for a product upgrade with a higher version number
Note: Product and Registration records are automatically added\updated via inbound API calls. Only Upgrades are added via the Admin console.
Example (.Net API call to register a client)
**Registration**
var response = HttpHelper.Post(URL, new NameValueCollection() {
{ "action", "regupdate" },
{ "sky", SecretKey }, //Secret ID must match ID in your WordPress|Settings|InstallTracker
{ "product", Product },
{ "ver", Version },
{ "custom", Custom },
{ "trackid", RegID }, //TrackID from previous registration to allow updates, blank for new
{ "key", key }, //GUID generated by your installation (Format: 00000000-0000-0000-0000-000000000000 )
{ "name", name },
{ "email", email },
{ "phone", phone },
{ "contact", contact },
{ "addr", address },
{ "city", city },
{ "state", state },
{ "zipcode", zipcode}
});
var str = System.Text.Encoding.Default.GetString(response);
if (str != null && str.Equals("0")) return false; //Secret key might not match
var outObject = JsonConvert.DeserializeObject
if (outObject.valid == "TRUE")
{
RegID = outObject.regID; //Returned Registration ID for future updates
return true;
}
**Usage**
var pars = new NameValueCollection() {
{ "action", "useapp" },
{ "sky", SecretKey },
{ "product", Product },
{ "ver", Version },
{ "custom", Custom },
{ "trackid", RegID }, //TrackID from previous registration (optional)
{ "key", key } //GUID generated by your installation (optional)
};
**Upgrade**
var pars = new NameValueCollection() {
{ "action", "upgrade" },
{ "sky", SecretKey },
{ "product", Product },
{ "ver", Version },
{ "custom", Custom },
};
.Net API wrapper client library is available at www.kyght.com (http://www.kyght.com/?page_id=147).
Other client libraries will be available later on GitHub (https://github.com/kyght/InstallTracker).
.Net client dll Usage
installTrack = new Tracker(\”http://www.yoursite.com/wp-admin/admin-ajax.php\”, \”YourProduct\”, \”2.1.16.80\”, \”666745\”);
installTrack.Register(String key, String name, String email, String contact, String phone, String address, String city, String state, String zipcode)
installTrack.Usage(String key, OnTrackerComplete onComplete )
installTrack.UpgradeAvailable(OnUpgradeAvailable onUpgrade)
installTrack.Download(String fileurl, String filename, System.ComponentModel.AsyncCompletedEventHandler onComplete, DownloadProgressChangedEventHandler onProgress)
