創(chuàng)建短鏈接
我們提供 2 種方式統(tǒng)計短鏈接點擊:"分手機號統(tǒng)計點擊"可以幫助您統(tǒng)計到具體哪些用戶點擊了短鏈接及總點擊量。"僅統(tǒng)計點擊量"可以幫助您統(tǒng)計短鏈接的點擊量。
分手機號統(tǒng)計點擊
通過 API 接口使用短鏈接統(tǒng)計功能(僅支持 V2),步驟如下:
- 調用接口 /v2/short_url/shorten.json 生成短鏈接。
- 調用接口 /v2/sms/single_send.json 或 /v2/sms/batch_send.json 發(fā)送短信,短信內容中需包含上一步生成的短鏈接,發(fā)送時
mobile_stat
參數(shù)需要傳true
.如:【云片網(wǎng)】請點擊 dx5.cn/YUNpian 了解詳情。這種情況下會把短鏈接替換為目標手機號的專屬鏈接(下發(fā)的每一條短信里面的短鏈接都不同),用于統(tǒng)計哪些號碼的機主點擊了短信中的鏈接)。 - 登錄用戶后臺,可在增長工具->云片短鏈接->統(tǒng)計詳情中導出查看點擊號碼明細。
僅統(tǒng)計點擊量
通過 API 接口使用短鏈接統(tǒng)計功能(僅支持 V2),步驟如下:
- 調用接口 /v2/short_url/shorten.json 生成短鏈接。
- 調用接口 /v2/sms/single_send.json 或 /v2/sms/batch_send.json 發(fā)送短信,短信內容中需包含上一步生成的短鏈接,如:【云片網(wǎng)】請點擊 dx5.cn/YUNpian 了解詳情。
- 登錄用戶后臺,在增長工具->云片短鏈接->統(tǒng)計詳情中查看短鏈發(fā)送和點擊數(shù)據(jù)。
- 支持通過接口獲取統(tǒng)計數(shù)據(jù):/v2/short_url/stat.json。
生成短鏈接
HTTP 頭信息:
Accept:application/json;charset=utf-8; Content-Type:application/x-www-form-urlencoded;charset=utf-8;
請求
URL:https://sms.yunpian.com/v2/short_url/shorten.json 注意:海外服務器地址 us.yunpian.com 訪問方式:POST
附注:使用此接口生成短鏈接,然后調用特定接口(目前僅支持/v2/sms/single_send 和/v2/sms/batch_send)發(fā)送帶有該短鏈接的短信(可以不用 http:// 開頭),最后登錄云片后臺查看統(tǒng)計效果(實時更新)。
請求參數(shù)
參數(shù)名 | 類型 | 是否必須 | 描述 | 示例 |
apikey | string | 是 | 用戶唯一標識,在"賬號設置"-"子帳號管理"中查看 | 9b11127a9701975c734b8aee0000000 |
long_url | string | 是 | 待轉換的長網(wǎng)址,必須http:// 或https:// 開頭 | http://www.ssjdyy2.com |
name | string | 否 | 取名方便區(qū)分,默認為“02-27 11:11 生產的短鏈接” | yunpian |
java 請求示例
/** * 生成短鏈接 * * @param apikey成功注冊后登錄云片官網(wǎng),進入后臺可查看 * @param long_url需要轉換的長鏈接 * @return json格式字符串 */ public static String shorten(String apikey, String long_url) throws YunpianException { Map<String, String> params = new HashMap<String, String>(); params.put("apikey", apikey); params.put("long_url", long_url); return post("https://sms.yunpian.com/v2/short_url/shorten.json", params); }
響應
名稱 | 類型 | 描述 |
code | int | 正確為 0 表示成功,其他值表示錯誤,錯誤時不會有下面的數(shù)據(jù) |
msg | string | 請求狀態(tài)消息 |
short_url | json | json 數(shù)組,需進一步解析 |
short_url 參數(shù)
名稱 | 類型 | 描述 |
sid | string | 短鏈接唯一標識,用于獲取統(tǒng)計數(shù)據(jù) |
long_url | string | 原鏈接 |
short_url | string | 云片短鏈接 |
enter_url | string | 入口短鏈接,默認和云片短鏈接相同 |
name | string | 短鏈名稱 |
Json 響應示例:
{ "code": 0, "msg": "OK", "short_url": { "enter_url": "https://dx5.cn/YRDOnF", "short_url": "https://dx5.cn/YRDOnF", "name": "2021-03-31 10:29:39 創(chuàng)建的短鏈", "sid": "YRDOnF", "long_url": "http://www.ssjdyy2.com/" } }