• 短信点击统计
    • 分手机号统计点击
    • 仅统计点击量
      • 生成短链接
      • 请求
        • 请求参数
        • 响应
        • short_url参数
        • Json响应示例:
      • 获取短链接统计
      • 请求
        • 请求参数
        • 响应
        • Json返回示例:
      • 下载短链接点击号码
      • 请求
        • 请求参数
      • 下载短链接点击号码
        • 响应
        • 文件流示例:

    短信点击统计

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

    分手机号统计点击

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

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

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

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

    仅统计点击量

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

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

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

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

    • 支持通过接口获取统计数据:/v2/short_url/stat.json。

    生成短链接

    HTTP头信息:

    1. Accept:application/json;charset=utf-8;
    2. 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更新一次),也可使用接口获取统计数据。限制:1秒钟内最多1次,超出限制将返回错误信息。

    请求参数

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

    响应

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

    short_url参数

    名称类型描述
    sidstring短链接唯一标识,用于获取统计数据
    long_urlstring原链接
    short_urlstring云片短链接
    enter_urlstring入口短链接,此为新浪短连接,若provider=1则enter_url=short_url
    namestring名字
    stat_expirestring预计停止统计时间,为空时则没有开启统计

    Json响应示例:

    1. {
    2. "code": 0,
    3. "msg": "OK",
    4. "short_url": {
    5. "sid": "yUNpian",
    6. "short_url": "https://yp2.cn/yUNpian",
    7. "long_url": "https://www.yunpian.com",
    8. "enter_url": "https://t.cn/EfeSeT",
    9. "name": "02-28 19:59生成的短链接",
    10. "stat_expire": "2019-03-30 19:59:11"
    11. }
    12. }

    获取短链接统计

    HTTP头信息:

    1. Accept:application/json;charset=utf-8;
    2. 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返回示例:

    1. {
    2. "code": 0,
    3. "msg": "OK",
    4. "stat": {
    5. "201703291130": 666,
    6. "201703291140": 777,
    7. "201703291150": 888,
    8. "201703291200": 0,
    9. "201703291210": 111
    10. }
    11. }

    下载短链接点击号码

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

    HTTP头信息:

    1. Accept:application/json;charset=utf-8;
    2. 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文件里内容如下:

    1. 13083960906
    2. 13083960906