Parametri CGI

Cerca parametri CGI

Il codice del modulo di ricerca viene fornito per consentire la copia e l'incolla nell'HTML del sito ( Design > Auto-Complete > Form Source).

Vedere Copia del codice HTML del modulo di ricerca in corso….

È inoltre possibile impostare i parametri elencati nel modulo di ricerca stesso o da uno script. Oltre ai parametri elencati di seguito, potete anche usare i parametri di ricerca di back-end per controllare la ricerca.

Vedere Parametri CGI di ricerca back-end.

Le richieste di ricerca sono costituite da un URL di base. L'URL di base indica l'account che il cliente sta cercando 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 fase di esecuzione o in tempo reale. Potete richiedere più alias per l'URL di base al vostro account manager. Ad esempio, una società di nome Megacorp potrebbe avere due URL di base associati al suo account: https://search.megacorp.com e https://stage.megacorp.com. L’URL precedente esegue la ricerca nel relativo indice live e l’ultimo URL cerca il relativo indice in fase di esecuzione.

Sono supportati tre formati di parametri CGI. Per impostazione predefinita, il vostro 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 preferite, potete fare in modo che il vostro account manager configuri il vostro account in modo che utilizzi le 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`. Vedere Parametri CGI di ricerca back-end.
q#	`q#=string`	La ricerca all'interno di un dato campo viene eseguita mediante i parametri q e x numerati. Il parametro q definisce il termine ricercato nel facet come indicato dal parametro x numerato corrispondente. Ad esempio, se avete due facet denominati dimensione e colore, potete avere qualcosa come q1=piccolo;x1=dimensione;q2=rosso;x2=colore. Questo parametro viene mappato sui parametri di ricerca di back-end `sp_q_exact_#`. Consultate Parametri CGI di ricerca di back-end.
x#	`q#=string`	La ricerca all'interno di un dato campo viene eseguita mediante i parametri q e x numerati. Il parametro q definisce il termine ricercato nel facet come indicato dal parametro x numerato corrispondente. Ad esempio, se avete due facet denominati dimensione e colore, potete avere qualcosa come q1=piccolo;x1=dimensione;q2=rosso;x2=colore. Questo parametro viene mappato sui parametri di ricerca di back-end `sp_x_#`. Consultate Parametri CGI di ricerca di 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`. Vedere 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`. Vedere Parametri CGI di ricerca back-end.
page	`page=number`	Specifica la pagina dei risultati restituiti.
rank	`rank=field`	Specifica il campo di classificazione da utilizzare per la classificazione statica. Il campo deve essere un campo di tipo Classifica con rilevanza maggiore di 0. Questo parametro viene mappato sul parametro di backend `sp_sr`. Vedere Parametri CGI di ricerca back-end.
sort	`sort=number`	Specifica l'ordinamento. "0" è l'impostazione predefinita e ordina per punteggio di rilevanza; "1", per data; "-1" non esegue 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 title. 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, fare clic su Settings > Metadata > Definitions. Nella pagina Definizioni, fare clic su Add New Field o su Edit per un nome di campo specifico. Nell'elenco a discesa Sorting, selezionare Ascending o Descending. Questo parametro viene mappato sul parametro di ricerca di back-end `sp_s`. Consultate [Parametri] CGI di ricerca di back-end.(/docs/search-promote/using/appendices/c-cgiparameters.html?lang=it#reference_582E85C3886740C98FE88CA9DF7918E8).

Parametri CGI di ricerca back-end

In genere i clienti interagiscono con un livello di presentazione denominato Ricerca guidata. Tuttavia, è teoricamente possibile saltare il livello Guided Search e interagire con la ricerca di base del back-end direttamente utilizzando i parametri CGI descritti in questa pagina.

È possibile selezionare i parametri CGI di ricerca back-end dalla tabella seguente:

	Supporto per query singole	Supporto di più query	Esempi	Descrizione
1	sp_a		`sp_a= string`	Specifica la stringa del numero di account. Questo parametro è obbligatorio e deve essere una stringa numero di account valida. È possibile trovare la stringa del numero di account in Impostazioni > Opzioni account > Impostazioni account .
2	sp_advanced		`sp_advanced= 0 or 1`	Se `sp_advanced=1` viene inviato con una query, per il modulo di ricerca viene utilizzato tutto il codice compreso tra il tag `<search-if-advanced>` e il tag `</search-if-advanced>` nel modello di ricerca. Tutto il codice compreso tra il tag `<search-if-not-advanced>` e il tag `</search-if-not-advanced>` viene ignorato. Se viene inviato `sp_advanced=0` (o qualsiasi altro valore), il blocco di modelli <search-if-advanced> viene ignorato e viene utilizzato il blocco di modelli <search-if-not-advanced>.
3	sp_c		`sp_c= number`	Specifica il conteggio totale dei risultati da visualizzare. Il valore predefinito è 10.
4	sp_context_field		`sp_context_field= field`	Raccoglie informazioni contestuali per il campo specificato. Le informazioni raccolte vengono visualizzate nei risultati della ricerca tramite il tag del modello `<search-context>` . Il valore predefinito è `body` .
5	sp_d		`sp_d= type`	Specifica il tipo di intervallo di date da eseguire. I valori possibili per type sono any, ovvero non eseguono ricerche per intervalli di date, custom, che indica che il valore di `sp_date_range` deve essere utilizzato per determinare le date da cercare, e specific, che indica che i valori in `sp_start_day` , `sp_start_month` , `sp_start_year` , `sp_end_day` , `sp_end_month` e `sp_end_year` sono utilizzati per determinare l'intervallo di date da cercare. `sp_d` è richiesto solo se il modulo di ricerca contiene l'opzione per effettuare ricerche in base a un intervallo personalizzato (tramite `sp_date_range` ) o a un intervallo di date iniziale e finale specifico.
6		sp_d_#	`sp_d_#= type`	Specifica il tipo di ricerca dell'intervallo di date da eseguire per la query `sp_q_#` corrispondente. Il numero "#" viene sostituito con un numero compreso tra 1 e 16 (ad esempio, `sp_d_8` , si applica alla query numerata `sp_q_8` ). È possibile impostare `type` su qualsiasi, il che significa che non esegue ricerche per intervalli di date, personalizzato, che indica che il valore di `sp_date_range_#` è utilizzato per determinare le date da cercare, e specifico, che indica che i valori in `sp_q_min_day_#` , `sp_q_min_month_#` , `sp_q_min_year_#` , `sp_q_max_day_#` , `sp_q_max_month_#` e `sp_q_max_year_#` devono essere utilizzati per determinare l'intervallo di date. L'uso di `sp_d_#` è richiesto solo se il modulo di ricerca contiene l'opzione per effettuare ricerche in base a un intervallo personalizzato (in base a `sp_date_range_#` ) oppure in base a un intervallo di date iniziale e finale specifico.
7	sp_date_range		`sp_date_range= number`	Specifica un intervallo di date predefinito da applicare alla ricerca. 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" specifica "oggi e ieri", un valore pari a "30" specifica "entro gli ultimi 30 giorni" e così via. I valori inferiori a zero specificano un intervallo personalizzato come segue: -1 = "None" (Nessuno), come se non fosse specificato alcun intervallo di date. -2 = "Questa settimana", che esegue la ricerca da domenica a sabato della settimana corrente. -3 = "Ultima settimana", che esegue la ricerca da domenica a sabato della settimana precedente alla settimana corrente. -4 = "Questo mese", che esegue la ricerca delle date entro il mese corrente. -5 = "Last month", che esegue la ricerca delle date entro il mese precedente quello corrente. -6 = "Quest'anno", che esegue la ricerca delle date entro l'anno corrente. -7 = "Ultimo anno", che esegue la ricerca delle date entro l'anno precedente l'anno in corso.
8		sp_date_range_#	`sp_date_range_#= number`	Specifica un intervallo di date predefinito da applicare alla query `sp_q_#` corrispondente. Il numero "#" viene sostituito con un numero compreso tra 1 e 16 (ad esempio, `sp_date_range_8` , si applica alla query numerata `sp_q_8` ). Valori maggiori o uguali a zero specificano il numero di giorni in cui eseguire la ricerca prima della giornata odierna. Ad esempio, un valore pari a 0 specifica oggi; un valore pari a 1 indica oggi e ieri; un valore pari a 30 specifica gli ultimi 30 giorni e così via. I valori inferiori a zero specificano un intervallo personalizzato come segue: -1 = "None" (Nessuno), come se non fosse specificato alcun intervallo di date. -2 = "Questa settimana", che esegue la ricerca da domenica a sabato della settimana corrente. -3 = "Ultima settimana", che esegue la ricerca da domenica a sabato della settimana precedente alla settimana corrente. -4 = "Questo mese", che esegue la ricerca delle date entro il mese corrente. -5 = "Last month", che esegue la ricerca delle date entro il mese precedente quello corrente. -6 = "Quest'anno", che esegue la ricerca delle date entro l'anno corrente. -7 = "Ultimo anno", che esegue la ricerca delle date entro l'anno precedente l'anno in corso.
9	sp_dedupe_field		`sp_dedupe_field= fieldname`	Specifica un singolo campo su cui ridurre i risultati della ricerca. Tutti i risultati duplicati in quel campo vengono rimossi dai risultati della ricerca. Ad esempio, se per `sp_dedupe_field=title` , nei risultati di ricerca viene visualizzato solo il risultato superiore per un determinato titolo (nessun risultato avrà contenuto identico per il campo titolo). Per i campi di tipo con più valori ( elenco consentiti), per il confronto viene utilizzato l’intero contenuto del campo. È possibile specificare un solo campo. Un "qualificatore tabella" non è consentito nel nome del campo.
10	sp_e		`sp_e= number`	Specifica che deve essere eseguita l'espansione automatica del carattere jolly per qualsiasi parola proveniente dalla stringa di query con più caratteri numerici. In altre parole, `sp_e=5` specifica che le parole con 5 o più caratteri, come "query" o "numero", devono essere espanse con il carattere jolly '', rendendo la ricerca equivalente a una ricerca per "query" o "numero*". Le parole con un numero inferiore di caratteri non vengono espanse, pertanto la ricerca di "parola" non comporterebbe l’espansione automatica dei caratteri jolly.
11		sp_e_#	`sp_e_#= number`	Specifica che viene eseguita l'espansione automatica del carattere jolly per qualsiasi parola proveniente dalla stringa di query `sp_q_#` corrispondente con più caratteri numerici. In altre parole, `sp_e_2=5` specifica che le parole con cinque o più caratteri nella stringa di query `sp_q_2` , come "query" o "numero", devono essere espanse con il carattere jolly ' `` ', rendendo la ricerca equivalente a una ricerca per "query" o "numero*". Le parole con un numero di caratteri inferiore non vengono espanse, pertanto la ricerca di "parola" in `sp_q_2` non comporterebbe l'espansione automatica dei caratteri jolly.
12	sp_end_day, sp_end_month, sp_end_year		`sp_end_day= number,sp_end_month= number, sp_end_year= number`	Questo triplo di valori specifica l’intervallo di date di fine della ricerca e deve essere fornito come set.
13	sp_f		`sp_f= string`	Specifica il set di caratteri delle stringhe del parametro di query (ad esempio `sp_q` ). Questa stringa deve sempre corrispondere al set di caratteri della pagina che contiene il modulo di ricerca.
14	sp_field_table		`sp_field_ table=table: field,field...`	Definisce una tabella di dati logica costituita dai campi specificati. Ad esempio, una tabella denominata "items" composta dai campi "color", "size" e "price" verrebbe definita come segue: `sp_field_table=items:color,size,price` Le tabelle logiche sono particolarmente utili in combinazione con i campi che presentano "Elenchi consentiti " selezionati (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, `sp_x_1=tablename.fieldname` ). Ad esempio, per eseguire una ricerca di documenti che contengono uno o più elementi "rossi" di dimensioni "grandi" (dove gli elementi sono rappresentati come righe parallele di metadati), potete utilizzare quanto segue: `sp_q_exact_1=red&sp_x_1=items.color& sp_q_exact_2=large&sp_x_2=items.size&sp_field_table=items:color,size,price`
15	sp_i			`sp_i=1` `sp_i=2`
			`sp_k= string`
			`sp_l= string`	`sp_q` `string`
			`sp_literal= 0 or 1`	`sp_literal=1` `sp_literal=0`
			`sp_m= number`
			`sp_n= number`
			`sp_not_found_page= url`
			`sp_p= any/all/phrase`	`any` `all` `phrase` `phrase` `all` `sp_p` `sp_p`
			`sp_p_#= any/all/phrase`	`sp_q_#` `sp_p_8` `sp_q_8` `any` `all` `phrase` `all` `phrase` `sp_p_#` `any`
			`sp_pt= exact/equivalent/compatible`	`exact` `equivalent` `compatible` `sp_p` `exact` `sp_p` `all` `phrase` `equivalent` `sp_pt` `compatible`
			`sp_pt_#= exact/equivalent/compatible`	`sp_q_#` `sp_p_8` `sp_q_8` `exact` `equivalent` `exact` `compatible` `sp_p_#` `exact` `sp_p_#` `equivalent` `sp_pt_#` `compatible`
			`sp_q= string`
			`sp_q_#= text`	`sp_q_#` `sp_q_1` `sp_q_16` `Search for: <input type="text" name="sp_q" value="great"> Search for: <input type="text" name="sp_q_1" value="books">`
			`sp_q_day= integer value` `sp_q_month= integer value` `sp_q_year= integer value` `sp_q_day_#= integer value` `sp_q_month_#= integer value` `sp_q_year_#= integer value`	`sp_q_day` `sp_q_month` `sp_q_year` `sp_q` `#` `sp_q_day_6` `sp_q_6` `PublishDate` `<input type="hidden" name="sp_x_1" value="PublishDate"> Search for: <input type="text" name="sp_q" value="orange">On : <input type="text" name="sp_q_day_1" size="2" value="1"> Day<input type="text" name="sp_q_month_1" size="2" value="1"> Month <input type="text" name="sp_q_year_1" size="4" value="2000"> Year`
			`sp_q_location=latitude/longitude OR areacode OR zipcode` `sp_q_location_#= latitude/longitude OR areacode OR zipcode`	`sp_q_location` `sp_q_location_#` `#`
			`sp_q_max_relevant_distance= value` `sp_q_max_relevant_distance_#= value`	`sp_q_max_relevant_distance` `sp_q_max_relevant_distance_#` `#` `sp_q_max_relevant_distance` `sp_q_max_relevant_distance_#`
			`sp_q_min_day=integer value` `sp_q_min_month=integer value` `sp_q_min_year=integer value` `sp_q_max_day=integer value` `sp_q_max_month=integer value` `sp_q_max_year=integer value` `sp_q_min_day_#=integer value` `sp_q_min_month_#=integer value` `sp_q_min_year_#=integer value` `sp_q_max_day_#=integer value` `sp_q_max_month_#=integer value` `sp_q_max_year_#=integer value`	`sp_q_min_day` `sp_q_min_month` `sp_q_min_year` `sp_q_max_day` `sp_q_max_month` `sp_q` `#` `sp_q_min_day_6` `sp_q_6` `PublishDate` <input type="hidden" name="sp_x_1" value="PublishDate">Search for: <input type="text" name="sp_q" value="orange">Between: <input type="text" name="sp_q_min_day_1" size="2" value="1"> Start Day<input type="text" name="sp_q_min_month_1" size="2" value="1"> Start Month <input type="text" name="sp_q_min_year_1" size="4" value="2000"> Start Year And: <input type="text" name="sp_q_max_day_1" size="2" value="31"> End Day <input type="text" name="sp_q_max_month_1" size="2" value="12"> End Month <input type="text" name="sp_q_max_year_1" size="4" value="2000"> End Year
			`sp_q_min= value` `sp_q_max= value` `sp_q_min_#= value` `sp_q_max_#= value` `sp_q_exact_#=value`	`sp_q_min` `sp_q_max` `sp_q_exact` `sp_q` `#` `sp_q_min_8` `sp_q_8` `sp_q_exact_#` `sp_q_min_#` `sp_q_max_#` `sp_q_exact_#` `sp_q_min_#` `sp_q_max_#` `sp_q_min_#` `sp_q_max_#` `sp_q_exact_#` `...&sp_q_exact_1=green\|red&sp_x_1=color`
			`sp_q_nocp= 1 or 0` `sp_q_nocp_#= 1 or 0`	`0` `1` `sp_q_nocp` `sp_q` `#` `sp_q_nocp_8` `sp_q_8`
			`sp_q_required= 1 or 0 or -1` `sp_q_required_#= 1 or 0 or -1`	`sp_q_required` `sp_q` `#` `sp_q_required_8` `sp_q_8` `<input type="hidden" name="sp_x_1" value="platform"> Search for: <input type="text" name="sp_q" value="calc"> Exclude: <input type="text" name="sp_q_1" value="mac win all"> <input type="hidden" name="sp_q_required_1" value="-1">`
			`sp_redirect_ if_one_result= 0 or 1`
			`sp_referrer= url`
				`ro` `sp_ro=body:10` `sp_ro=body:9\|title:9` `sp_ro=title:10` `title` `sp_ro` `sp_ro`
			`sp_s= number`	`sp_s` `sp_s=title` `sp_s` `sp_s` `<input type="hidden" name="sp_s" value="artist"> <input type="hidden" name="sp_s" value="album"> <input type="hidden" name="sp_s" value="track"> Search for: <input type="text" name="sp_q" value="Music Search">` `sp_field_table`
			`sp_sr= field`	`sp_sr` `sp_sr` `<input type="hidden" name="sp_sr" value="">`
			`sp_sfvl_field= string`	`search-field-value-list` `sp_sfvl_field`
				`search-field-value-list` `dynamic-facet-field-count` `dynamic-facet-field-count` `sp_sfvl_df_count` `dynamic-facet-field-count` `sp_sfvl_df_count` `sp_sfvl_df_count`

				`sp_sfvl_df_count` `sp_sfvl_df_include` `sp_sfvl_df_include` `sp_sfvl_df_count`
			`sp_staged= 0 or 1`	`sp_staged=1`
			`sp_start_day= number` `sp_start_month= number` `sp_start_year= number`
			`sp_suggest_q= number`	`sp_suggest_q` `sp_q[_#]` `sp_suggest_q` `sp_q` `sp_suggest_q=1` `sp_q_1`
			`sp_t= string`
			`sp_trace= 0 or 1`	`sp_stage=1`
			`sp_w= sound-alike-enable` `sp_w_control=sound-alike-control`	`sp_w_control` `sp_w_control=0` `sp_w` `<input type=hidden name="sp_w_control" value="0"><input type=checkbox name="sp_w" value="exact">No Sound-Alike matching` `sp_w_control=1` `sp_w` `<input type=hidden name="sp_w_control" value="1"><input type=checkbox name="sp_w" value="alike">Sound-Alike matching` `sp_w_control` `sp_w`
			`sp_x= field`	`sp_q` `sp_x` `sp_x` `sp_x=any` `sp_x` `sp_x` `<input type="hidden" name="sp_x" value="title"><input type="hidden" name="sp_x" value="author">Search for: <input type="text" name="sp_q" value="Great Books">`
			`sp_x_#= field-name`	`sp_q_#` `#` `sp_x_8` `sp_x_#` `Search for: <input type="text" name="sp_q" value="great"><input type="hidden" name="sp_x_1" value="author">Search only documents written by: <input type="text" name="sp_q_1" value="Fitzgerald">` `sp_x` `sp_x_#` `<input type="hidden" name="sp_x_1" value="body"><input type="hidden" name="sp_x_1" value="keys">Search for: <input type="text" name="sp_q_1" value="flower">`

Esempio tipico di utilizzo dei parametri CGI di ricerca back-end

Le seguenti query di collegamento avviano una ricerca utilizzando "Music" come query di ricerca e utilizzano tutti i parametri predefiniti. L’URL è suddiviso su due righe per garantire la leggibilità. Nel codice HTML, il collegamento deve essere su una sola 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 per rilevanza, e consente al cliente di scegliere altre pagine e altre opzioni. Se il modulo di ricerca sul sito include opzioni per le raccolte, passate il nome della raccolta come parametro.

Un esempio dettagliato sull'utilizzo dei parametri CGI di ricerca back-end

Nelle seguenti query del modulo vengono visualizzati 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>

Risorse su adobe.com

Ab Multivariate Testing Email Creation Audio Analytics Voice Analytics Customer Journey Analytics Demand Side Platform

In questa pagina

Visualizza successivo:

Privacy (AGGIORNATO)

Condizioni d’uso