温馨提示:这篇文章已超过954天没有更新,请注意相关的内容是否还可用!
【为什么配置URL适配规则】
URL适配规则指H5页面与小程序页面间的映射关系。
在平台配置URL适配规则,可以使搜索得到此映射关系。精确的适配规则有助于搜索更快收录小程序资源并继承原有H5站点的搜索流量。
【URL适配规则怎么写】
1.URL适配映射规则
通过正则表达式的方式声明H5链接与小程序路径间的对应关系。格式举例:
小程序路径:pages/xyz/123
这组对应关系的规则描述:^https?://www.host.com/([^/]+)/([^/]+)$ => pages/\1/\2
如上例所示,
“=>”左侧部分为H5正则表达式,根据H5链接生成的正则表达式,标识了H5地址中与小程序参数有对应关系的部分;
“=>”右侧部分为小程序替换表达式,由小程序路径和参数对组成。参数对中如果某个参数值是左侧匹配到的部分,则其参数值由“\左侧匹配项的序号”代替。
2.更多示例
H5 地址 | 小程序路径 |
https://example.com/ pages/home/index | pages/home/index |
https://example.com/$ => pages/home/index
H5 地址 | 小程序路径 |
https://example.com/book?id=1&type=history | pages/book/index?bookid=1&type=history |
// 只要是符合正则规则的匹配方式都可以,例如下述规则也同样正确
https://example.com/book?id=([\w]+)&type=(.+)$ => pages/book/index?bookid=\1&type=\2
H5 地址 | 小程序路径 |
https://example.com/history/book?id=1 | pages/book/index?bookid=1&type=history |
https://example.com/([^\/]+)/book?id=([^&]+) => pages/book/index?bookid=\2&type=\1
H5 地址 | 小程序路径 |
https://example.com/history_type/book?id=1 | pages/book/index?bookid=1&type=history |
H5 地址 | 小程序路径 |
https://example.com/book/1.html | pages/book/index?bookid=1&type=history |
https://example.com/book/([^\.]+).html => pages/book/index?bookid=\1&type=history
H5 地址 | 小程序路径 |
https://example.com/book/history2019.html?id=1 | pages/book?type=history |
【URL适配工具如何使用】
开发者已有URL适配规则需要配置,可在“URL适配规则管理”页面实现配置,具体步骤如下:
1.点击页面中的“新建规则”按钮,进入“新建URL规则”页面。
在“新建URL规则”页面中,开发者需要填写具体H5 pattern和对应的小程序表达式、APPID(用户已绑定的小程序id)、站点(用户已提交的站点)及校验URL对,用于验证规则准确性
2.规则成功提交后,需等待适配审核流程,可在“URL适配规则管理页面”查看每条规则当前的适配状态。
【适配状态详解】
1.适配状态:
审核中:您所提交的规则正在审核中,一般7个工作日内会反馈审核结果
已通过:您所提交的规则通过审核,线上已适配生效,适配数量字段会显示当前规则适配URL数量;
未通过:您所提交的规则未通过审核,请根据未通过审核的原因自查并修改规则,确认无误后再重新提交。有多种原因会导致规则审核失败。
当适配状态为“未通过”时,状态右侧会有符号,鼠标放在上会显示审核失败原因,如下图:
2.未通过审核的可能存在的问题
小程序资源未收录:提交的规则,没有在UC和夸克上线小程序对应功能,需在支付宝小程序平台完成小程序功能上线。
小程序已下线:小程序已下线,适配不生效。需重新提包通过审核后,再重新发起适配校验流程。
小程序页面死链:对应小程序资源存在内容死链或死链率较高,不予通过。
小程序页面存在第三方跳转:规则对应小程序资源存在跳转H5、嵌套H5等情况。不建议用户提交webview模式小程序,建议开发原生小程序。
H5页面死链:提供验证的H5资源页面死链,请自查修复后重新提交。
主体内容不一致:规则对应的小程序页面与H5页面内容不一致。请您自查H5页面和小程序页面的基础信息如标题、正文主体、页面版块是否基本一致,修改一致后重新提交规则。
页面内容低质:提交的适配规则对应小程序页面内容低质,请自查是否存在以下几方面错误,修复后重新提交。
低质范围包含:
• 页面低质:无实质内容、页面空白空短、无结果页等
• 性能差:页面访问不稳定,加载、响应超时
*提示:请自查是否存在以下几方面错误,修复后重新提交。
• 页面是否空白、空短;举例
• 页面访问是否稳定,页面是否加载、响应时间过长,导致页面无法获取完整内容,页面访问不稳定一直加载中;
规则异常:提交的适配规则存在异常,请您自查正则表达式拼写是否正确,是否存在空格、乱码、异常符号等情况,纠错后重新提交。
规则被占用:适配规则与已提交规则存在冲突:重复、互相匹配,请您自查是否有多条规则之间是否存在重复,互相匹配的问题,请修复后重新提交。
小程序path不规范:提交的小程序path不符合约定格式,在提交规则时需要注意符合以下规范:
• 小程序path不能带有#标记:“#”这个符号在通用url中标记锚文本,和不带#的url表示同一个页面。请不要在小程序path中夹带#标记,避免适配出错。
• 小程序path参数不能为路径:小程序path可以带参数,但需注意,参数不可以是一条路径,也不可以是一条H5 url。
以下这三类都是不符合规范的:
小程序路径 |
qk.example.cn/parameter_a=/path1/file |
qk.example.cn/parameter=http://example.cn/path1/1.htm |
qk.example.cn/parameter=example.com/path1/1.html |
还没有评论,来说两句吧...