提供的搜索表单代码可复制并粘贴到站点的HTML中(Design > Auto-Complete > Form Source)。
您还可以设置在搜索表单中或从脚本中列出的参数。 除了下面列出的参数之外,您还可以使用后端搜索参数来控制搜索。
请参阅后端搜索CGI参数。
搜索请求由基本URL组成。 基本URL指示客户正在搜索的帐户,以及一组CGI参数(键值对),这些参数指示如何为关联帐户返回所需的搜索结果。
基本URL与特定帐户和分阶段或实时环境关联。 您可以从帐户管理器请求基本URL的多个别名。 例如,名为Megacorp的公司可能有两个与其帐户关联的基本URL:https://search.megacorp.com
和https://stage.megacorp.com
。 前者URL搜索其活动索引,后者URL搜索其分阶段索引。
支持三种格式的CGI参数。 默认情况下,您的帐户配置为使用分号分隔CGI参数,如下例所示:
https://search.megacorp.com?q=shoes;page=2
如果您愿意,您可以让您的客户经理将您的帐户配置为使用&符号来分隔CGI参数,如下例所示:
https://search.megacorp.com?q=shoes&page=2
还支持第三种格式(称为SEO格式),其中使用正斜杠/
代替分隔符,并与以下示例中的等号相同:
https://search.megacorp.com/q/shoes/page/2
每当使用SEO格式发送请求时,所有输出链接都以相同的格式返回。
导向搜索参数 | 示例 | 描述 |
---|---|---|
q | q=string |
指定搜索的查询字符串。 此参数映射到sp_q 后端搜索参数。 请参阅后端搜索CGI参数。 |
q# | q#=string |
分面(在给定字段内搜索)是通过编号q和x参数完成的。 q参数定义要在facet中搜索的术语,由相应的编号x参数表示。 例如,如果您有两个彩块化,它们被命名为大小和颜色,则可以有类似q1=small;x1=size;q2=red;x2=color的内容。此参数映射到 sp_q_exact_# 后端搜索参数。 请参 阅后端搜索CGI参数。 |
x 不支持跨域跟踪# | q#=string |
分面(在给定字段内搜索)是通过编号q和x参数完成的。 q参数定义要在facet中搜索的术语,由相应的编号x参数表示。 例如,如果您有两个彩块化,它们被命名为大小和颜色,则可以有类似q1=small;x1=size;q2=red;x2=color的内容。此参数映射到 sp_x_# 后端搜索参数。 请参 阅后端搜索CGI参数。 |
collection(集合) | collection=string |
指定要用于搜索的集合。 此参数映射到sp_k 后端搜索参数。 请参阅后端搜索CGI参数。 |
count(计数) | count=number |
指定所显示结果的总计数。 默认值在Settings > Searching > Searches中定义。. 此参数映射到sp_c 后端搜索参数。 请参阅后端搜索CGI参数。 |
page | page=number |
指定返回的结果页。 |
排名 | rank=field |
指定用于静态排名的排名字段。 该字段必须是关联度大于0的“排名”类型字段。 此参数映射到sp_sr 后端参数。 请参阅后端搜索CGI参数。 |
排序 | sort=number |
指定排序顺序。 “0”是默认值,按相关性得分排序;“1”按日排序;“–1”不排序。用户可以为 sp_s 参数的值指定字段名。 例如,sp_s=title 会根据标题字段中包含的值对结果进行排序。 当使用字段名称作为sp_s 参数的值时,结果将按该字段排序,然后按相关性子排序。 要启用此功能,请单击Settings > Metadata > Definitions。 在“定义”页上,单击Add New Field或单击Edit获取特定字段名称。 在Sorting下拉列表中,选择Ascending或Descending。 此参数映射到sp_s 后端搜索参数。 请参 [阅后端搜索CGI参数]。(/docs/search-promote/using/appendices/c-cgiparameters.html?lang=zh-Hans#reference_582E85C3886740C98FE88CA9DF7918E8)。 |
客户通常与称为“向导式搜索”的表示层进行交互。 但是,理论上可以跳过引导式搜索层,并直接使用本页中描述的CGI参数与后端核心搜索交互。
您可以从下表中选择后端搜索CGI参数:
单一查询支持 |
多查询支持 |
示例 |
描述 |
|
---|---|---|---|---|
1 |
sp_a |
|
|
指定帐号字符串。 此参数是必需的,且必须是有效的帐号字符串。 您可以在“设置 > 帐户选项 > 帐户设置”下找到您的帐户号字符串。 |
2 |
sp_advanced |
|
|
如果 |
3 |
sp_c |
|
|
指定要显示的结果总数。 默认值为 10。 |
4 |
sp_context_field |
|
|
收集给定字段的上下文信息。 通过 |
5 |
sp_d |
|
|
指定要执行的日期范围搜索的类型。 可能的类型值是任意值,即不执行日期范围搜索,自定义值指示应使用 |
6 |
|
sp_d_# |
|
指定要对相应的 可以将 |
7 |
sp_date_range |
|
|
指定要应用于搜索的预定义日期范围。 大于或等于零的值指定今天之前要搜索的天数 — 例如,值“0”指定“今天”,值“1”指定“今天和昨天”,值“30”指定“最近30天内”,依此类推。 低于零的值指定自定义范围,如下所示: -1 = "无",与指定无日期范围相同。 -2 = "This week",从当周的星期日到星期六进行搜索。 -3 = "Last week",从当前周之前的星期日到星期六进行搜索。 -4 =“本月”,搜索日期在当月内。 -5 = "上个月",搜索当月前一个月内的日期。 -6 =“今年”,搜索日期在当年。 -7 =“去年”,其搜索日期在当前年度之前的年份。 |
8 |
|
sp_date_range_# |
|
指定要应用于相应 大于或等于零的值指定今天之前要搜索的天数。 例如,值0指定今天;值为1表示今天和昨天;值30指定在过去30天内,依此类推。 低于零的值指定自定义范围,如下所示: -1 = "无",与指定无日期范围相同。 -2 = "This week",从当周的星期日到星期六进行搜索。 -3 = "Last week",从当前周之前的星期日到星期六进行搜索。 -4 =“本月”,搜索日期在当月内。 -5 = "上个月",搜索当月前一个月内的日期。 -6 =“今年”,搜索日期在当年。 -7 =“去年”,其搜索日期在当前年度之前的年份。 |
9 |
sp_dedupe_field |
|
|
指定要对搜索结果进行重复数据消除的单个字段。 该字段上的所有重复结果都将从搜索结果中删除。 例如,对于 |
10 |
sp_e |
|
|
指定对查询字符串中的任意字进行自动通配符扩展,该字符数大于数字。 换句话说, |
11 |
|
sp_e_# |
|
指定对来自相应 |
12 |
sp_end_day、sp_end_month、sp_end_year |
|
|
值的这三个部分指定搜索的结束日期范围,并且必须作为集提供。 |
13 |
sp_f |
|
|
指定查询参数字符串的字符集(如 |
14 |
sp_field_table |
|
|
定义包含给定字段的逻辑数据表。 例如,由“color”、“size”和“price”字段组成的名为“items”的表将定义为: 逻辑表与选中了“允许列表”的字段(在设置 > 元数据 > 定义下)一起使用时最为有用。 所有以字段名称为值的CGI参数和模板标记都可以选择指定表名,后跟“”。 在字段名之前(例如 例如,要搜索包含大小为“large”(其中项目表示为并行的元数据行)的一个或多个“red”项目的文档,可以使用以下代码: |
15 |
sp_i |
|
|
|
| ||||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
|
| |||
| ||||
|
| |||
| ||||
|
| |||
| sp_w_control
| |||
|
| |||
|
|
以下链接查询开始使用“音乐”作为搜索查询的搜索,并使用所有默认参数。 请注意,URL被拆分为两行,以便于读取。 在您的HTML中,此链接应全部在一行上。
<a href="https://search.atomz.com/search/?sp_q=Music&sp_a=sp99999999">
Testing...</a>
同样的功能通常通过表单定义:
<form action="https://search.atomz.com/search/">
<input size=12 name="sp_q" value="Music"><br>
<input type=hidden name="sp_a" value="sp99999999">
<input type=submit value="Search"><br>
</form>
在启动搜索时,通常应使用默认参数。 这样,第一个页面就会显示,并按相关性排序,并允许客户选择其他页面和其他选项。 如果您网站上的搜索表单包含集合选项,请将集合名称作为参数传递。
以下表单查询显示25
结果,从结果10
开始。 不显示摘要,排序顺序按日期排列,并使用名为support
的集合。 仅返回日期在最近30天内的文档。
<form action="https://search.atomz.com/search/">
<input size=12 name="sp_q"><br>
<input type=hidden name="sp_a" value="sp99999999">
<input type=submit value="Search"><br>
<input type=hidden name=sp_n value=10>
<input type=hidden name=sp_c value=25>
<input type=hidden name=sp_m value=0>
<input type=hidden name=sp_s value=1>
<input type=hidden name=sp_k value="support">
<input type=hidden name=sp_date_range value=30>
</form>