百度小程序配置URL替换规则_百度小程序 链接标签

为什么要配置 URL 替换规则

配置 URL 替换规则，可以使百度搜索了解小程序页面与 H5 页面之间的对应关系，从而顺利将 H5 资源替换为相应的小程序资源，继承原有 H5 的流量，对小程序接入搜索至关重要。

配置 URL 替换规则的两种方式

开发者可以通过两种方式配置替换规则：自定义规则和自动生成规则。两者的区别如下，开发者可以根据实际情况选择：

1. 自定义替换规则，即通过配置正则表达式声明 H5 与小程序路径的对应关系，包括自主填写表达式、利用生成工具生成表达式两种方法。
   开发者最终提交的是正则表达式，因此该方式适用于有一定技术能力、H5 目录与小程序目录对应关系较明确的开发者，通过正则表达式即可实现又好又快替换。
2. 自动生成替换规则：直接填写 URL 对（H5 URL 及对应的 web 化 URL），单次最多可提交 50 组，每个小程序总共可提交 5000 组。
   开发者最终提交的是 URL 对，不涉及正则表达式，因此该方式适用于无技术能力、小程序页面数量较少、H5 目录与小程序目录缺少明确对应关系的开发者，建议优先提交高点击的 URL 对。

URL 替换规则配置详解

一、自定义替换规则

1. 正则表达式简介

通过正则表达式的方式声明 H5 链接与小程序路径间的对应关系。格式举例：

H5 地址：https://example.com/detail?id=1

小程序路径：/pages/detail/index?id=1
这组对应关系的规则描述：https://example.com/detail?id=([^&]+)=> pages/detail/index?id=${1}

如上例所示，“=>” 左侧部分为 H5 链接生成的正则表达式，标识了 H5 地址中与小程序参数有对应关系的部分；“=>” 右侧部分由小程序路径和参数对组成。参数对中如果某个参数值是左侧匹配到的部分，则其参数值由 ${左侧匹配项的序号} 代替。

1.1 更多示例

// 如果要完全匹配到 url 结尾，例如当 url 后没有 path 时，适配小程序首页 path，url 后要加结束符
https://example.com/$ => pages/home/index

https://example.com/book?id=([^&]+)&type=([^&]+) => pages/book/index?bookid=${1}&type=${2}
 
// 只要是符合正则规则的匹配方式都可以，例如下述规则也同样正确
https://example.com/book?id=([\w]+)&type=(.+)$ => pages/book/index?bookid=${1}&type=${2}

// 参数部分序号根据正则匹配的顺序决定
https://example.com/([^\/]+)/book?id=([^&]+) => pages/book/index?bookid=${2}&type=${1}

https://example.com/([^\_]+)_type/book?id=([^&]+) => pages/book/index?bookid=${2}&type=${1}

// 两个地址中没有对应项的参数保持不变
https://example.com/book/([^\.]+).html => pages/book/index?bookid=${1}&type=history

https://example.com/book/([^\d]+)2019.html?id=1 => pages/book?type=${1}

1.2 开发者平台配置方式
（1）方式一：直接配置正则表达式
第一步：在“智能小程序开发者平台 -> 获流 -> 自然结果 -> H5 资源替换”，点击“创建替换规则” ，选择“自定义‘替换规则’”。

 

第二步：选择“自定义输入”，填写具体 H5 URL表达式和对应的小程序 Path 表达式，并至少提供一对示例 URL 对，用于验证规则准确性。
完成验证并提交后，系统将自动对该规则覆盖的 H 5资源进行校验与替换（优先替换 H5 热门目录）。因此，开发者需要保证对应的小程序页面已完成“页面基础信息”设置。

（2）方式二：利用生成工具生成正则表达式
第一步：在“智能小程序开发者平台 -> 搜索接入 -> 自然搜索 -> H5 资源替换”，点击“创建替换规则” ，选择“自定义‘替换规则’”。
第二步：选择“使用’表达式生成工具’”。开发者只需要按照工具的引导，即可生成对应的URL替换规则表达式。

  

二、自动生成替换规则

第一步：在“智能小程序开发者平台 -> 搜索接入 -> 自然搜索 -> H5 资源替换”，点击“创建替换规则”按钮，选择“自动生成‘替换规则’”。

 

第二步：分别填写 H5 URL 和小程序 Path ，最多一次可提交 50 对，总共可提交 5000 对，完成之后点击“提交”。

URL 替换规则反馈状态详解

提交替换规则后，可查看规则状态：

以下为替换规则提交后的5种状态反馈，希望能帮助开发者更好地理解规则校验情况，及时修复问题。

1.校验成功

该状态表示，您所提交的规则已全部适配成功，无需任何操作。从规则显示“校验成功”到实际线上生效，可能存在 1 天的时间差。如果删除已校验成功的规则，可能导致已生效规则失效、百度 App 内的小程序结果回退 H5 ，请谨慎操作。

2.部分失败

该状态表示，您所提交的规则有部分链接校验成功，还有一部分链接校验失败，点击“查看详情”，可查看具体的适配失败原因。根据示例 url 自查并优化相关数据，然后重新提交替换规则即可，具体修改与优化方法

3.校验失败

该状态表示，您所提交的规则校验失败，点击“查看详情”，可查看具体的适配失败原因。根据示例 url 自查并优化相关数据，然后重新提交替换规则即可，

4.校验中

该状态表示，您所提交的规则仍在校验中。提交替换规则后，一般需要一周左右的时间进行适配校验，在此期间不能进行任何操作，请耐心等待。

5.不满足适配条件

该状态表示，您所提交的规则对应的 H5 链接未收录或近期在搜索中无点击，建议以 sitemap 形式提交对应小程序资源。若重新提交替换规则，建议优先覆盖所关联 H5 站点的有点击 url ，可通过“H5 热门目录”查看高点击目录。

URL 替换失败错误原因详解

如规则存在替换失败的情况，可点击右侧“详情”，查看具体替换失败的URL：

以下为 URL 替换失败的 11 种原因及相应处理方式，希望能够帮助开发者快速准确地定位并修复问题，提升适配成功率。

1.主体内容不一致

替换规则所覆盖的小程序页面与 H5 页面内容不一致，相似度较低。请自查页面基础信息如 title 字段、正文主体、页面版块等是否基本一致，修复一致后才能通过适配相似度校验。

2.H5 页面死链

替换规则所覆盖的 H5 资源为内容死链或协议死链，请自查并修复同类问题。

3.小程序页面死链

替换规则所覆盖的小程序资源存在内容死链或死链率较高，请自查并修复同类问题。

4.小程序页面存在第三方跳转

替换规则所覆盖的小程序资源存在跳转 H5 、嵌套 H5 等问题，请自查并修复同类问题。不建议提交 webview 模式小程序，建议开发原生小程序。

5.小程序页面低质

替换规则所覆盖的小程序页面内容低质，请自查是否存在以下几方面错误，修复此类问题。
（1）页面是否空白、空短。
①页面无内容示例请见下图一 ②页面空短示例请见下图二
（2）页面访问是否稳定，页面是否加载、响应时间过长，导致页面无法获取完整内容。页面访问不稳定一直加载中请见下图：

 

页面无内容示例

 

页面空短示例

 

页面不稳定一直加载示例

（3）请勿提交已下架、已过期资源。
电商类、招聘类小程序经常出现大量的产品下架、售罄、资源过期等情况，请勿重复提交此类资源。
（4）请勿采集、拼凑资源。
如果小程序存在大量从其他站点或公众号等内容生产方采集、搬运而来的内容，信息未经整合，排版混乱，文章可读性差，有明显采集痕迹，则对用户无任何价值，会被判为低质内容。

seo优化

6.资源无效

替换规则所覆盖的小程序资源中存在 web 化 url 路径无效、空白页等资源低质情况，导致无法被正常抓取，请及时修复，低质问题详见第 5 条说明“小程序页面低质”。

7.小程序 path 不规范

小程序 path 不符合约定格式，提交替换规则时需要注意以下规范：
（1）小程序 path 不能带有 # 标记

“#”这个符号在通用 url 中标记锚文本，和不带 # 的 url 表示同一个页面。请不要在小程序 path 中夹带 # 标记，避免适配出错。

（2）小程序 path 参数不能为路径
小程序 path 可以带参数，但需注意，参数不可以是一条路径，也不可以是一条 H5 url 。以下这三类都是不符合规范的：

• xxx.smartapp.cn/parameter_a=/path1/file
• xxx.smartapp.cn/parameter=http://xxx.baidu.com/path1/1.html
• xxx.smartapp.cn/parameter=xxx.baidu.com/path1/1.html

如需带相关参数，务必清晰表述参数名和参数定义，如 dir_name=news 。

8.规则异常

替换规则存在异常，请自查正则表达式拼写是否正确，是否存在空格、乱码、异常符号等情况，纠错后重新提交。

9.规则被占用

替换规则已被另一规则占用并优先生效，请自查规则之间是否存在重复。

10.与 H5 解除关联

该小程序与 H5 站点的关联关系已解除，适配无法生效。请及时通过确认关联主体信息。并尽快重新关联H5站点与主体、H5站点与小程序的关系，以免适配失效。

11.小程序下线

已下线的小程序，适配不予生效。请重新提包之后，等待替换规则校验生效。

• 请注意：小程序重新提包之后，搜索会尽快对已提交的规则进行校验，因此小程序重新上线之后无需进行任何操作，耐心等待规则重新校验即可。

需要提醒的是，为了保证适配准确性，替换规则会定期重新校验，因此如果替换规则本身没有变动，只是修复了存在问题的资源，无需重提规则；但如果规则变了，则需要删除旧规则、提交新规则。