我们提供 2 种方式统计短链接点击:"分手机号统计点击"可以帮助您统计到具体哪些用户点击了短链接及总点击量。"仅统计点击量"可以帮助您统计短链接的点击量。


分手机号统计点击


通过 API 接口使用短链接统计功能(仅支持 V2),步骤如下:


  1. 调用接口 /v2/short_url/shorten.json 生成短链接。
  1. 调用接口 /v2/sms/single_send.json 或 /v2/sms/batch_send.json 发送短信,短信内容中需包含上一步生成的短链接,发送时mobile_stat参数需要传true.如:【云片网】请点击 dx5.cn/YUNpian 了解详情。这种情况下会把短链接替换为目标手机号的专属链接(下发的每一条短信里面的短链接都不同),用于统计哪些号码的机主点击了短信中的链接)。
  1. 登录官网用户控制台查看统计数据(更新频率约 10min),国内短信->数据统计->点击统计。或者通过接口下载短链接点击号码获取。


仅统计点击量


通过 API 接口使用短链接统计功能(仅支持 V2),步骤如下:


  1. 调用接口 /v2/short_url/shorten.json 生成短链接。
  1. 调用接口 /v2/sms/single_send.json 或 /v2/sms/batch_send.json 发送短信,短信内容中需包含上一步生成的短链接,如:【云片网】请点击 dx5.cn/YUNpian 了解详情。
  1. 登录官网用户控制台查看统计数据(更新频率约 10min),国内短信->数据统计->点击统计。
  1. 支持通过接口获取统计数据:/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)发送带有该短链接的短信(可以不用 http:// 开头),最后登录云片后台查看统计效果(10min 更新一次),也可使用接口获取统计数据。


请求参数

参数名类型是否必须描述示例
apikeystring

用户唯一标识,在"账号设置"-"子帐号管理"中查看

9b11127a9701975c734b8aee0000000
long_urlstring待转换的长网址,必须http://https://开头https://www.yunpian.com
stat_durationinteger点击量统计持续时间(天),过期后不再统计,区间[0,30],默认是 30 表示统计。30
namestring取名方便区分,默认为“02-27 11:11 生产的短链接”yunpian


响应

名称类型描述
codeint正确为 0 表示成功,其他值表示错误,错误时不会有下面的数据
msgstring请求状态消息
short_urljsonjson 数组,需进一步解析


short_url 参数

名称类型描述
sidstring短链接唯一标识,用于获取统计数据
long_urlstring原链接
short_urlstring云片短链接
enter_urlstring入口短链接,默认和云片短链接相同
namestring名字
stat_expirestring预计停止统计时间,为空时则没有开启统计


Json 响应示例:


{
  "code": 0,
  "msg": "OK",
  "short_url": {
    "sid": "yUNpian",
    "short_url": "https://dx5.cn/yUNpian",
    "long_url": "https://www.yunpian.com",
    "enter_url": "https://dx5.cn/yUNpian",
    "name": "02-28 19:59生成的短链接",
    "stat_expire": "2019-03-30 19:59:11"
  }
}


获取短链接统计


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/stat.json
注意:海外服务器地址 us.yunpian.com
访问方式:POST
附注:统计的时间粒度为 10 分钟,更新频率为 10 分钟。


请求参数

参数名类型是否必须描述示例
apikeystring用户唯一标识9b11127a9701975c734b8aee0000000
sidstring短链接唯一标识yunpian
start_timestring开始时间,默认一个小时前2017-03-29 11:30:00
end_timestring结束时间,默认当前时间2017-03-29 12:10:00


响应

名称类型描述
codeint正确为 0 表示成功,其他值表示错误,错误时不会有下面的数据
msgstring请求状态消息
statjson需要进一步解析


Json 返回示例:


{
  "code": 0,
  "msg": "OK",
  "stat": {
    "201703291130": 666,
    "201703291140": 777,
    "201703291150": 888,
    "201703291200": 0,
    "201703291210": 111
  }
}


下载短链接点击号码


注意:这个接口要用 GET 来请求


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/clicked
注意:海外服务器地址 us.yunpian.com
访问方式:GET


请求参数


下载短链接点击号码

参数名类型是否必须描述示例
apikeyString用户唯一标识9b11127a9701975c734b8aee0000000
sidString短链接唯一标识,生成短链接的接口返回abcDef
start_timeString开始时间(用户点击)2017-03-29 11:30:00
end_timeString结束时间(用户点击)2017-03-29 12:10:00


响应


返回一个文件流,手机号码为去重后的文本,可指定时间范围


文件流示例:


返回的 txt 文件里内容如下:


13083960906
13083960906