短信点击统计

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

分手机号统计点击

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

  1. 调用接口 /v2/short_url/shorten.json 生成短链接。

  2. 调用接口 /v2/sms/single_send.json 或 /v2/sms/batch_send.json 发送短信,短信内容中需包含上一步生成的短链接,发送时mobile_stat参数需要传true.如:【云片网】请点击yp2.cn/YUNpian 了解详情。这种情况下会把短链接替换为目标手机号的专属链接(下发的每一条短信里面的短链接都不同),用于统计哪些号码的机主点击了短信中的链接。

  3. 登录官网用户控制台查看统计数据(更新频率约10min),国内短信->数据统计->点击统计。或者通过接口下载短链接点击号码获取。

仅统计点击量

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

  1. 调用接口 /v2/short_url/shorten.json 生成短链接。

  2. 调用接口 /v2/sms/single_send.json 或 /v2/sms/batch_send.json 发送短信,短信内容中需包含上一步生成的短链接,如:【云片网】请点击yp2.cn/YUNpian 了解详情。

  3. 登录官网用户控制台查看统计数据(更新频率约10min),国内短信->数据统计->点击统计。

  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:// 开头),最后登录云片后台查看统计效果(10min更新一次),也可使用接口获取统计数据。

请求参数

参数名 类型 是否必须 描述 示例
apikey string 用户唯一标识 9b11127a9701975c734b8aee0000000
long_url string 待转换的长网址,必须http://https://开头 https://www.yunpian.com
stat_duration integer 点击量统计持续时间(天),过期后不再统计,区间[0,30],默认是30表示统计。 30
provider integer 生成的链接的域名,传入1是yp2.cn,默认1 1
name string 取名方便区分,默认为“02-27 11:11生产的短链接” yunpian

响应

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

short_url参数

名称 类型 描述
sid string 短链接唯一标识,用于获取统计数据
long_url string 原链接
short_url string 云片短链接
enter_url string 入口短链接
name string 名字
stat_expire string 预计停止统计时间,为空时则没有开启统计

Json响应示例:

{
    "code": 0,
    "msg": "OK",
    "short_url": {
        "sid": "cs1omL",
        "short_url": "https://yp2.cn/cs1omL",
        "long_url": "https://www.yunpian.com/",
        "enter_url": "https://yp2.cn/cs1omL",
        "name": "09-20 15:09生成的短链接",
        "stat_expire": "2019-10-20 15:09:09"
    }
}

获取短链接统计

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分钟。

请求参数

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

响应

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

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

请求参数

下载短链接点击号码

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

响应

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

文件流示例:

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

13083960906    
13083960906

results matching ""

    No results matching ""