Question

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

分手机号统计点击

通过 API 接口使用短链接统计功能（仅支持 V2），步骤如下：

1. 调用接口 /v2/short_url/shorten.json 生成短链接。
2. 调用接口 /v2/sms/single_send.json 或 /v2/sms/batch_send.json 发送短信，短信内容中需包含上一步生成的短链接，发送时mobile_stat参数需要传true.如：【云片网】请点击 dx5.cn/YUNpian 了解详情。这种情况下会把短链接替换为目标手机号的专属链接（下发的每一条短信里面的短链接都不同），用于统计哪些号码的机主点击了短信中的链接）。
3. 登录用户后台，可在增长工具->云片短链接->统计详情中导出查看点击号码明细。

仅统计点击量

通过 API 接口使用短链接统计功能（仅支持 V2），步骤如下：

1. 调用接口 /v2/short_url/shorten.json 生成短链接。
2. 调用接口 /v2/sms/single_send.json 或 /v2/sms/batch_send.json 发送短信，短信内容中需包含上一步生成的短链接，如：【云片网】请点击 dx5.cn/YUNpian 了解详情。
3. 登录用户后台，在增长工具->云片短链接->统计详情中查看短链发送和点击数据。
4. 支持通过接口获取统计数据：/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/"
    }
}