文档

短链管理

更新时间:

1.基本概念

概述

Quick Audience提供长链转换短链的能力,减少短信计费字数,支持将文本短信、数字短信以及卡片短信里的短信内容携带的长链接转换为短链接,用户接收显示为短链接,点击短链接会跳转至原始长链接

使用须知

  • 原始长链接中的域名需要在域名管理平台购买,并且完成域名备案。

  • 使用短链服务需开通短信或瓴羊超信服务

  • 创建短链接前需要在组织管理->组织系统配置中设置短域名

  • QA短链-带短参的情况下支持统计点击数,不带短参的短链无法统计点击数

  • 创建短链时,原始地址仅支持一个长链接

  • 在创建短信模板时,支持添加多个已经创建完成的短链

名词解释

名词

释义

举例

QA完整短链

短链由四部分组成:协议+短域名+短链+短参,以及分隔符组成

协议:http 或者 https

短域名:quicka.aliyun.com

短链:rksqdc

短参:wertxv

https://quicka.aliyun.com/rksqdc?ph=wertxv

QA短链-无短参

1、即没有短参的短链,短链和长链一一对应,但无法区分发送手机号码

2、无法统计点击此链接的用户明细数据,这些数据在QA中也无法查询

https://quicka.aliyun.com/rksqdc

QA短链-带短参

1、可回收点击此链接的用户明细数据

2、如果需要区分每个手机号码是否点击,需要用短参进行该短链上用户的一一映射关系。

https://quicka.aliyun.com/rksqdc?ph=wertxv

如上 ?ph=wertxv 部分即为短参

QA短链点击

QA短链被用户点击后,根据短链是否带参接收的数据不同:

  • 如果没有短参的链接,则无法采集点击的明细数据,无法统计点击数

  • 如果有短参的链接,则可采集点击的明细数据,可统计点击数

-

原始长链

如淘宝店铺页、商详页、微信小程序 URL 等都是原始链接

原始的链接,一般都会比较长,字符很多,需要转成短链,方便在文本短信中发送

不在意短信长度,且不需要QA记录点击数据,可直接在短信中发送使用长链,无需使用QA短链

https://detail.tmall.com/item.htm?id=599804260889

微信小程序

H5链接生成

1、TICKET 大约40个字符,总长度大约一条短信

2、客户需要在小程序调用接口生成对应模块页面的完整URL地址,传参包括 access_token 和 path 两个参数进行生成

3、微信小程序短链接生成文档 

https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/qrcode-link/url-link/generateUrlLink.html

https://wxaurl.cn/*TICKET*

https://wxmpurl.cn/*TICKET*

2.短域名配置方式

以下介绍两种短域名配置方式,任选一种即可

2.1自有域名配置短域名

组织管理选择组织系统配置,在对应的短域名配置界面,配置域名地址以及范围,如场景主要是短信内使用,推荐使用短域名减少生成后的字符个数

image

域名转发配置(开发参考)

业务人员在QA域名填写完成,需要后端研发人员进行域名转发配置即配置转发规则,按照规则重定向并转发

业务人员填写域名,例如 https://abc.cn/(示例)

QA接收转发域名为,例如 https://quicka.aliyun.com/(示例)

生成的短链是 https://abc.cn/e8as9x,短参为dbfhjs

用户实际收到的链接为: https://abc.cn/e8as9x?ph=dbfhjs

用户点击链接后,请求会跳转到 https://abc.cn/ 这个域名所在服务器上

开发需要:把请求转发到QA的域名上,转发规则: https://abc.cn/e8as9x?ph=dbfhjs -> https:quicka.aliyun.com/e8as9x?ph=dbfhjs

以下介绍域名配置转发方式

Nginx配置转发的方式

可以采用 return、rewrite的方式重定向链接到 QA

# 下面代码中,listen 指令表明 server 块同时用于 HTTP流量。
# server_name 指令匹配包含域名 ‘www.abc.com’ 的请求。return 指令告诉 Nginx 停止处理请求,直接返回 302 代码和指定的重写过的 URL 到客户端。
# $scheme 是协议(HTTP 或 HTTPS),$request_uri 是包含参数的完整的 URI。 
server{
    listen         80;
    server_name    www.abc.com;
    
    # return 指令的第一个参数是响应码。第二个参数可选,可以是重定向的 URL
    # location 和 server 上下文中都可以使用 return 指令。
    return 302 https://quicka.aliyun.com$request_uri;
}

rewrite写法1

server {
    listen      80;
    server_name www.abc.com;
    
    # 第一个参数 regex 是正则表达式。
    rewrite ^/(.*)$ http://quicka.aliyun.com/$1 redirect;
}

rewrite写法2,带路径的转发

server {
    listen      80;
    server_name www.abc.com;
    
    # 第一个参数 regex 是正则表达式。
    rewrite ^/(.*)$ http://quicka.aliyun.com/$1 redirect;
}

阿里云SLB(ALB/NLB/CLB)常见问题

阿里云SLB细分为三个产品类型,其中NLB/CLB不能配置转发规则,需要用ALB才行,配置文档如下:

CreateRule - 创建转发规则

常见配置问题

① 如所配置的域名只做域名转发,需把所有的请求都转发到QA的域名上。

② 如所配置的域名还有其他用处,需要识别哪些请求是短链接点进来的,可以在域名配置增加标识。方法一:比如https://abc.cn/p/ 。收到请求后判断url中是否有/p/,如果有再转发到QA的域名上,并且把/p/替换成/short/;方法二:使用单独的二级域名,如 a.abc.cn 作为短链域名

  • 例如: https://abc.cn/p/e8as9x?ph=dbfhjs -> https:quicka.aliyun.com/short/e8as9x?ph=dbfhjs

  • Rewrite 写法1,如果有路径标识,使用Rewrite写法2

image

③ 接收转发的QA域名:https://quicka.aliyun.com/

④ 域名配置完成后的实际链路是:

用户点击链接 --> QA中配置的域名(参照:配置短域名) --> 转发到QA的域名 --> 然后解析成长链---> 用户看到实际的目标落地页

⑤ 确认域名是否可用ping q.melands.cn

错误结果如下:

image

正确结果参考如下:

image

也可以用 dig 命令查看是否有 DNS 解析。

2.2使用QA域名配置短域名

QA 提供域名进行域名管理模块配置,在域名管理模块中填入https://quicka.aliyun.com/ 即可,选择此方式则不需要后台开发人员配置转发

image

3.创建短链

点击用户营销->短链管理->创建短链按钮弹出创建短链界面

image

  • 选择通用短链,不建议使用阿里云短链

  • 填写短链名称、原始链接地址

  • 选择有效期、类型

  • 点击确认,完成短链创建

image

4.短链使用

瓴羊超信服务中的文本短信、数字短信、卡片短信支持短链,短信服务中的文本短信支持短链

下面介绍瓴羊超信服务中的文本短信如何使用短链

4.1创建短信模板

① 在用户营销->瓴羊超信->短信模板->文本短信下点击新建文本短信模板,进入新建文本短信模板界面

image

② 在新建文本短信模板界面,

依次选择不同的消息类型、填写模板名称以及模板内容,点击”插入短链接“按钮,选择创建完成的短链

重要

如需统计点击数据,必须打开短参,否则无法获取。

image

③ 短信模板创建完成后在短信模板对应的短信类型可以看见对应的模板

image

4.2短信模板使用

在新建发送任务界面,选择对应的短信类型以及短信模板,预览界面即可看见带短链接的短信内容

image