Il codice del modulo di ricerca viene fornito per copiare e incollare nell’HTML del sito ( Design > Auto-Complete > Form Source).
Vedere Copia del codice HTML del modulo di ricerca in….
È inoltre possibile impostare i parametri elencati nel modulo di ricerca stesso o da uno script. Oltre ai parametri elencati di seguito è possibile utilizzare i parametri di ricerca di back-end per controllare la ricerca.
Consulta Parametri CGI di ricerca back-end.
Le richieste di ricerca sono costituite da un URL di base. L’URL di base indica l’account ricercato dal cliente e un set di parametri CGI (coppie chiave-valore) che indicano come restituire i risultati di ricerca desiderati per l’account associato.
L’URL di base è associato a un account specifico e a un ambiente in staging o live. Puoi richiedere più alias per l'URL di base dal tuo account manager. Ad esempio, una società chiamata Megacorp può avere due URL di base associati al suo account: https://search.megacorp.com
e https://stage.megacorp.com
. L’URL precedente cerca il loro indice live e l’URL successivo cerca il loro indice di staging.
Sono supportati tre formati di parametri CGI. Per impostazione predefinita, il tuo account è configurato per separare i parametri CGI con un punto e virgola come nell’esempio seguente:
https://search.megacorp.com?q=shoes;page=2
Se lo desideri, puoi chiedere al tuo account manager di configurare il tuo account in modo che utilizzi il e commerciale per separare i parametri CGI come nell'esempio seguente:
https://search.megacorp.com?q=shoes&page=2
È inoltre supportato un terzo formato, denominato formato SEO, in cui viene utilizzata una barra /
al posto del separatore e un segno di uguale come nell’esempio seguente:
https://search.megacorp.com/q/shoes/page/2
Ogni volta che il formato SEO viene utilizzato per inviare una richiesta, tutti i collegamenti di output vengono restituiti nello stesso formato.
Parametro di ricerca guidato | Esempio | Descrizione |
---|---|---|
q | q=string |
Specifica la stringa di query per la ricerca. Questo parametro viene mappato sul parametro di ricerca di back-end sp_q . Consulta Parametri CGI di ricerca back-end. |
q# | q#=string |
L’impostazione della faccia (ricerca all’interno di un dato campo) viene eseguita tramite i parametri q e x numerati. Il parametro q definisce il termine che stai cercando nel facet come indicato dal parametro x corrispondente. Ad esempio, se hai due facet denominati dimensione e colore, puoi avere qualcosa come q1=small;x1=size;q2=red;x2=color. Questo parametro viene mappato sui parametri di ricerca di back-end sp_q_exact_# . Consulta Parametri CGI di ricerca back-end. |
x# | q#=string |
L’impostazione della faccia (ricerca all’interno di un dato campo) viene eseguita tramite i parametri q e x numerati. Il parametro q definisce il termine che stai cercando nel facet come indicato dal parametro x corrispondente. Ad esempio, se hai due facet denominati dimensione e colore, puoi avere qualcosa come q1=small;x1=size;q2=red;x2=color. Questo parametro viene mappato sui parametri di ricerca di back-end sp_x_# . Consulta Parametri CGI di ricerca back-end. |
raccolta | collection=string |
Specifica la raccolta da utilizzare per la ricerca. Questo parametro viene mappato sul parametro di ricerca di back-end sp_k . Consulta Parametri CGI di ricerca back-end. |
count | count=number |
Specifica il conteggio totale dei risultati visualizzati. Il valore predefinito è definito in Settings > Searching > Searches. . Questo parametro viene mappato sul parametro di ricerca di back-end sp_c . Consulta Parametri CGI di ricerca back-end. |
page | page=number |
Specifica la pagina dei risultati restituiti. |
rango | rank=field |
Specifica il campo di classificazione da utilizzare per la classificazione statica. Il campo deve essere un campo di tipo Rank con rilevanza superiore a 0. Questo parametro viene mappato sul parametro di backend sp_sr . Consulta Parametri CGI di ricerca back-end. |
sort | sort=number |
Specifica l'ordinamento. "0" è l’impostazione predefinita e ordinata in base al punteggio di pertinenza; "1" ordinamenti per data; "-1" non effettua l'ordinamento. Gli utenti possono specificare un nome di campo per il valore del parametro sp_s . Ad esempio, sp_s=title ordina i risultati in base ai valori contenuti nel campo titolo. Quando un nome di campo viene utilizzato per il valore di un parametro sp_s , i risultati vengono ordinati in base a tale campo e quindi suddivisi per rilevanza. Per abilitare questa funzione, fai clic su Settings > Metadata > Definitions. Nella pagina Definizioni fare clic su Add New Field o fare clic su Edit per un nome di campo specifico. Nell’elenco a discesa Sorting , seleziona Ascending o Descending. Questo parametro viene mappato sul parametro di ricerca di back-end sp_s . Consulta [Parametri CGI di ricerca back-end].(/docs/search-promote/using/appendices/c-cgiparameters.html?lang=it#reference_582E85C3886740C98FE88CA9DF7918E8). |
In genere i clienti interagiscono con un livello di presentazione denominato Ricerca guidata. Tuttavia, è teoricamente possibile saltare il livello di ricerca guidata e interagire con la ricerca di base di back-end direttamente utilizzando i parametri CGI descritti in questa pagina.
Puoi selezionare i parametri CGI di ricerca back-end nella tabella seguente:
Supporto di singole query |
Supporto di più query |
Esempi |
Descrizione |
|
---|---|---|---|---|
1 |
sp_a |
|
|
Specifica la stringa del numero di account. Questo parametro è obbligatorio e deve essere una stringa di numero di account valida. Puoi trovare la stringa del numero di account in Impostazioni > Opzioni account > Impostazioni account . |
2 |
sp_advanced |
|
|
Se |
3 |
sp_c |
|
|
Specifica il conteggio totale dei risultati da visualizzare. Il valore predefinito è 10. |
4 |
sp_context_field |
|
|
Raccoglie informazioni contestuali per il campo specificato. Le informazioni raccolte vengono inviate nei risultati della ricerca tramite il tag modello |
5 |
sp_d |
|
|
Specifica il tipo di intervallo di date da eseguire. I valori possibili per il tipo sono any, il che significa che non esegue ricerche nell’intervallo di date, custom, che indica che il valore di |
6 |
|
sp_d_# |
|
Specifica il tipo di intervallo di date da eseguire per la query È possibile impostare |
7 |
sp_date_range |
|
|
Specifica un intervallo di date predefinito da applicare alla ricerca. Valori maggiori o uguali a zero specificano il numero di giorni da cercare prima della data odierna — ad esempio, un valore di "0" specifica "oggi", un valore di "1" specifica "oggi e ieri", un valore di "30" specifica "entro gli ultimi 30 giorni" e così via. I valori inferiori a zero specificano un intervallo personalizzato come segue: -1 = "None", come se non si specificasse alcun intervallo di date. -2 = "Questa settimana", che cerca da domenica a sabato della settimana corrente. -3 = "Ultima settimana", che cerca da domenica a sabato della settimana precedente alla settimana corrente. -4 = "Questo mese", che cerca le date entro il mese corrente. -5 = "Ultimo mese", che esegue una ricerca nelle date entro il mese precedente il mese corrente. -6 = "Quest'anno", che cerca le date entro l'anno corrente. -7 = "Ultimo anno", che cerca le date entro l'anno precedente l'anno corrente. |
8 |
|
sp_date_range_# |
|
Specifica un intervallo di date predefinito da applicare alla query Valori maggiori o uguali a zero specificano il numero di giorni in cui eseguire la ricerca prima della data odierna. Ad esempio, un valore pari a 0 specifica oggi; un valore pari a 1 indica oggi e ieri; un valore di 30 specifica negli ultimi 30 giorni e così via. I valori inferiori a zero specificano un intervallo personalizzato come segue: -1 = "None", come se non si specificasse alcun intervallo di date. -2 = "Questa settimana", che cerca da domenica a sabato della settimana corrente. -3 = "Ultima settimana", che cerca da domenica a sabato della settimana precedente alla settimana corrente. -4 = "Questo mese", che cerca le date entro il mese corrente. -5 = "Ultimo mese", che esegue una ricerca nelle date entro il mese precedente il mese corrente. -6 = "Quest'anno", che cerca le date entro l'anno corrente. -7 = "Ultimo anno", che cerca le date entro l'anno precedente l'anno corrente. |
9 |
sp_dedupe_field |
|
|
Specifica un singolo campo su cui duplicare i risultati della ricerca. Tutti i risultati duplicati in quel campo vengono rimossi dai risultati della ricerca. Ad esempio, se per |
10 |
sp_e |
|
|
Specifica che l'espansione automatica dei caratteri jolly deve essere eseguita per qualsiasi parola della stringa query con più di caratteri numerici. In altre parole, |
11 |
|
sp_e_# |
|
Specifica che l'espansione automatica dei caratteri jolly ha luogo per qualsiasi parola della stringa di query |
12 |
sp_end_day, sp_end_month, sp_end_year |
|
|
Questo triplo di valori specifica l’intervallo di date di fine della ricerca e deve essere fornito come set. |
13 |
sp_f |
|
|
Specifica il set di caratteri delle stringhe del parametro di query (ad esempio |
14 |
sp_field_table |
|
|
Definisce una tabella di dati logica costituita dai campi specificati. Ad esempio, una tabella denominata "elementi" costituita dai campi "colore", "dimensione" e "prezzo" verrebbe definita come segue: Le tabelle logiche sono più utili in combinazione con i campi che hanno selezionato "Elenchi consentiti" (in Impostazioni > Metadati > Definizioni ). Tutti i parametri CGI e i tag modello che utilizzano un nome di campo come valore possono facoltativamente specificare un nome di tabella seguito da un "". prima del nome del campo (ad esempio, Ad esempio, per eseguire una ricerca per i documenti che contengono uno o più elementi "rossi" di dimensioni "grandi" (dove gli elementi sono rappresentati come righe parallele di metadati), è possibile utilizzare quanto segue: |
15 |
sp_i |
|
|
|
| ||||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
|
| |||
| ||||
|
| |||
| ||||
|
| |||
| sp_w_control
| |||
|
| |||
|
|
Le seguenti query di collegamento avviano una ricerca utilizzando "Musica" come query di ricerca e utilizzano tutti i parametri predefiniti. Per garantire la leggibilità, l’URL è suddiviso in due righe. Nel tuo HTML, questo collegamento dovrebbe essere tutti su una riga.
<a href="https://search.atomz.com/search/?sp_q=Music&sp_a=sp99999999">
Testing...</a>
La stessa funzionalità è definita più in genere con un modulo:
<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>
In genere, quando si avvia una ricerca è consigliabile utilizzare i parametri predefiniti. In questo modo, viene visualizzata la prima pagina, ordinata in base alla pertinenza, e consente al cliente di scegliere altre pagine e altre opzioni. Se il modulo di ricerca sul sito include opzioni per le raccolte, passa il nome della raccolta come parametro.
Le seguenti query del modulo visualizzano i risultati 25
a partire dal risultato 10
. I riepiloghi non vengono visualizzati, l’ordinamento è in base alla data e viene utilizzata la raccolta denominata support
. Vengono restituiti solo i documenti datati negli ultimi 30 giorni.
<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>