创建短链接
我们提供 2 种方式统计短链接点击:"分手机号统计点击"可以帮助您统计到具体哪些用户点击了短链接及总点击量。"仅统计点击量"可以帮助您统计短链接的点击量。
分手机号统计点击
通过 API 接口使用短链接统计功能(仅支持 V2),步骤如下:
- 调用接口 /v2/short_url/shorten.json 生成短链接。
- 调用接口 /v2/sms/single_send.json 或 /v2/sms/batch_send.json 发送短信,短信内容中需包含上一步生成的短链接,发送时
mobile_stat
参数需要传true
.如:【云片网】请点击 dx5.cn/YUNpian 了解详情。这种情况下会把短链接替换为目标手机号的专属链接(下发的每一条短信里面的短链接都不同),用于统计哪些号码的机主点击了短信中的链接)。 - 登录用户后台,可在增长工具->云片短链接->统计详情中导出查看点击号码明细。
仅统计点击量
通过 API 接口使用短链接统计功能(仅支持 V2),步骤如下:
- 调用接口 /v2/short_url/shorten.json 生成短链接。
- 调用接口 /v2/sms/single_send.json 或 /v2/sms/batch_send.json 发送短信,短信内容中需包含上一步生成的短链接,如:【云片网】请点击 dx5.cn/YUNpian 了解详情。
- 登录用户后台,在增长工具->云片短链接->统计详情中查看短链发送和点击数据。
- 支持通过接口获取统计数据:/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:// 开头),最后登录云片后台查看统计效果(实时更新)。
请求参数
参数名 | 类型 | 是否必须 | 描述 | 示例 |
apikey | string | 是 | 用户唯一标识,在"账号设置"-"子帐号管理"中查看 | 9b11127a9701975c734b8aee0000000 |
long_url | string | 是 | 待转换的长网址,必须http:// 或https:// 开头 | https://www.yunpian.com |
name | string | 否 | 取名方便区分,默认为“02-27 11:11 生产的短链接” | yunpian |
java 请求示例
/** * 生成短链接 * * @param apikey成功注册后登录云片官网,进入后台可查看 * @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 表示成功,其他值表示错误,错误时不会有下面的数据 |
msg | string | 请求状态消息 |
short_url | json | json 数组,需进一步解析 |
short_url 参数
名称 | 类型 | 描述 |
sid | string | 短链接唯一标识,用于获取统计数据 |
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 创建的短链", "sid": "YRDOnF", "long_url": "https://www.yunpian.com/" } }