提供搜尋表單程式碼,您可將其複製並貼至網站的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 |
Faceting(在指定欄位內搜尋)是透過編號q和x參數來完成。 q參數會定義您在Facet中搜尋的詞語,如對應的編號x參數所示。 例如,如果您有兩個刻面,其名稱為size和color,則可以有q1=small;x1=size;q2=red;x2=color。此參數會映射至 sp_q_exact_# 後端搜尋參數。 請參 閱後端搜尋CGI參數。 |
x 中的頁面載入要求# | q#=string |
Faceting(在指定欄位內搜尋)是透過編號q和x參數來完成。 q參數會定義您在Facet中搜尋的詞語,如對應的編號x參數所示。 例如,如果您有兩個刻面,其名稱為size和color,則可以有q1=small;x1=size;q2=red;x2=color。此參數會映射至 sp_x_# 後端搜尋參數。 請參 閱後端搜尋CGI參數。 |
集合 | collection=string |
指定要用於搜尋的系列。 此參數會映射至sp_k 後端搜尋參數。 請參閱後端搜尋CGI參數。 |
計數 | count=number |
指定顯示的結果總計。 預設值定義於Settings > Searching > Searches。. 此參數會映射至sp_c 後端搜尋參數。 請參閱後端搜尋CGI參數。 |
頁面 | 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-Hant#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 = "本週",在當周的週日到週六搜尋。 -3 = "上週",在當周前一週的星期日到星期六進行搜尋。 -4 = "本月",搜尋當月日期。 -5 = "上個月",搜尋當月前一個月的日期。 -6 = 「今年」,其搜索日期在當年。 -7 = 「去年」,搜尋日期在當年前一年。 |
8 |
|
sp_date_range_# |
|
指定要套用至對應 大於或等於零的值指定今天之前要搜索的天數。 例如,0的值指定今天;值1表示今天和昨天;值30指定在最近30天內,依此類推。 低於零的值會指定自訂範圍,如下所示: -1 = "無",與指定無日期範圍相同。 -2 = "本週",在當周的週日到週六搜尋。 -3 = "上週",在當周前一週的星期日到星期六進行搜尋。 -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參數和模板標籤,可以選擇指定表名,後面跟有"。" 在欄位名稱之前(例如 例如,要搜索包含一個或多個「大」(其中項目表示為並行元資料行)大小為「大」的「紅色」項目的文檔,可以使用以下內容: |
15 |
sp_i |
|
|
|
| ||||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
|
| |||
| ||||
|
| |||
| ||||
|
| |||
| sp_w_control
| |||
|
| |||
|
|
下列連結查詢會以"Music"作為搜尋查詢,開始搜尋,並使用所有預設參數。 請注意,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>