创建短链接

我们提供 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:// 开头),最后登录云片后台查看统计效果(实时更新)。


请求参数

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

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

9b11127a9701975c734b8aee0000000
long_urlstring待转换的长网址,必须http://https://开头https://www.yunpian.com
namestring取名方便区分,默认为“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);
    }


响应

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


short_url 参数

名称类型描述
sidstring短链接唯一标识,用于获取统计数据
long_urlstring原链接
short_urlstring云片短链接
enter_urlstring入口短链接,默认和云片短链接相同
namestring

短链名称


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/"
    }
}