Es wird der Suchformularcode bereitgestellt, mit dem Sie die HTML Ihrer Site kopieren und einfügen können ( Design > Auto-Complete > Form Source).
Siehe Kopieren des HTML-Codes des Suchformulars in die….
Sie können auch die Parameter festlegen, die entweder im Suchformular selbst oder über ein Skript aufgeführt werden. Zusätzlich zu den unten aufgeführten Parametern können Sie auch die Backend-Suchparameter verwenden, um die Suche zu steuern.
Siehe CGI-Parameter für die Backend-Suche.
Suchanforderungen bestehen aus einer Basis-URL. Die Basis-URL gibt an, nach welchem Konto der Kunde sucht, und eine Reihe von CGI-Parametern (Schlüssel-Wert-Paare), die angeben, wie die gewünschten Suchergebnisse für das zugehörige Konto zurückgegeben werden.
Die Basis-URL ist mit einem bestimmten Konto und einer gestaffelten oder Live-Umgebung verknüpft. Sie können mehrere Aliase für die Basis-URL von Ihrem Kundenbetreuer anfordern. Beispielsweise kann eine Firma namens Megacorp zwei Basis-URLs mit ihrem Konto verknüpft sein: https://search.megacorp.com
und https://stage.megacorp.com
. Die erste URL durchsucht ihren Liveindex und die zweite URL sucht ihren gestaffelten Index.
Es werden drei Formate von CGI-Parametern unterstützt. Standardmäßig ist Ihr Konto so konfiguriert, dass CGI-Parameter wie im folgenden Beispiel mit einem Semikolon getrennt werden:
https://search.megacorp.com?q=shoes;page=2
Wenn Sie es vorziehen, können Sie Ihren Kundenbetreuer dazu veranlassen, Ihr Konto so zu konfigurieren, dass zur Trennung der CGI-Parameter ein kaufmännisches kaufmännisches kaufmännisches Und verwendet wird, wie im folgenden Beispiel:
https://search.megacorp.com?q=shoes&page=2
Ein drittes Format, das so genannte SEO-Format, wird ebenfalls unterstützt, wenn anstelle des Trennzeichens und Gleichheitszeichens ein Schrägstrich /
verwendet wird, wie im folgenden Beispiel:
https://search.megacorp.com/q/shoes/page/2
Jedes Mal, wenn das SEO-Format zum Senden einer Anforderung verwendet wird, werden alle Ausgabelinks im gleichen Format zurückgegeben.
Parameter für die geführte Suche | Beispiel | Beschreibung |
---|---|---|
q | q=string |
Gibt die Abfrage-Zeichenfolge für die Suche an. Dieser Parameter wird dem Backend-Suchparameter sp_q zugeordnet. Siehe CGI-Parameter für die Backend-Suche. |
q# | q#=string |
Facting (Suche innerhalb eines bestimmten Felds) erfolgt über nummerierte q- und x-Parameter. Der Parameter q definiert den Begriff, nach dem Sie in der Facette suchen, wie er durch den entsprechenden Parameter "x"gekennzeichnet ist. Wenn Sie z. B. zwei Facetten haben, die Größe und Farbe heißen, können Sie z. B. q1=small;x1=size;q2=red;x2=color haben. Dieser Parameter wird den Backend-Suchparametern sp_q_exact_# zugeordnet. Siehe CGI-Parameter für die Backend-Suche. |
x nicht unterstützt# | q#=string |
Facting (Suche innerhalb eines bestimmten Felds) erfolgt über nummerierte q- und x-Parameter. Der Parameter q definiert den Begriff, nach dem Sie in der Facette suchen, wie er durch den entsprechenden Parameter "x"gekennzeichnet ist. Wenn Sie z. B. zwei Facetten haben, die Größe und Farbe heißen, können Sie z. B. q1=small;x1=size;q2=red;x2=color haben. Dieser Parameter wird den Backend-Suchparametern sp_x_# zugeordnet. Siehe CGI-Parameter für die Backend-Suche. |
Erfassung | collection=string |
Gibt die für die Suche zu verwendende Sammlung an. Dieser Parameter wird dem Backend-Suchparameter sp_k zugeordnet. Siehe CGI-Parameter für die Backend-Suche. |
count | count=number |
Gibt die Gesamtanzahl der angezeigten Ergebnisse an. Die Standardeinstellung ist in Settings > Searching > Searches definiert. . Dieser Parameter wird dem Backend-Suchparameter sp_c zugeordnet. Siehe CGI-Parameter für die Backend-Suche. |
Seite | page=number |
Gibt die Seite der zurückgegebenen Ergebnisse an. |
rank | rank=field |
Gibt das Rankenfeld an, das für das statische Rang verwendet werden soll. Das Feld muss ein Feld vom Typ Rang mit einer Relevanz größer als 0 sein. Dieser Parameter wird dem Backend-Parameter sp_sr zugeordnet. Siehe CGI-Parameter für die Backend-Suche. |
sortieren | sort=number |
Gibt die Sortierreihenfolge an. "0"ist der Standardwert und wird nach Relevanzwert sortiert; "1" sortiert nach Datum; "-1"wird nicht sortiert. Benutzer können einen Feldnamen für den Wert des Parameters sp_s angeben. Beispielsweise sortiert sp_s=title die Ergebnisse nach den Werten, die im Titelfeld enthalten sind. Wenn ein Feldname für den Wert eines Parameters sp_s verwendet wird, werden die Ergebnisse nach diesem Feld sortiert und dann nach Relevanz untergeordnet. Um diese Funktion zu aktivieren, klicken Sie auf Settings > Metadata > Definitions. Klicken Sie auf der Seite "Definitionen"auf Add New Field oder klicken Sie für einen bestimmten Feldnamen auf Edit. Wählen Sie in der Dropdown-Liste Sorting entweder Ascending oder Descending aus. Dieser Parameter wird dem Backend-Suchparameter sp_s zugeordnet. Siehe CGI-Parameter für die [Backend-Suche].(/docs/search-promote/using/appendices/c-cgiparameters.html?lang=de#reference_582E85C3886740C98FE88CA9DF7918E8). |
Kunden interagieren in der Regel mit einer Präsentationsebene, der so genannten "geführten Suche". Theoretisch ist es jedoch möglich, die Ebene der geführten Suche zu überspringen und mit der Backend-Core-Suche direkt mit den auf dieser Seite beschriebenen CGI-Parametern zu interagieren.
Sie können CGI-Parameter für die Backend-Suche in der folgenden Tabelle auswählen:
Unterstützung für einzelne Abfragen |
Unterstützung mehrerer Abfragen |
Beispiele |
Beschreibung |
|
---|---|---|---|---|
1 |
sp_a |
|
|
Gibt die Kontonummer-Zeichenfolge an. Dieser Parameter ist erforderlich und muss eine gültige Kontonummer-Zeichenfolge sein. Sie finden die Zeichenfolge Ihrer Kontonummer unter Einstellungen > Kontooptionen > Kontoeinstellungen . |
2 |
sp_advanced |
|
|
Wenn |
3 |
sp_c |
|
|
Gibt die Gesamtanzahl der anzuzeigenden Ergebnisse an. Die Standardeinstellung ist „10“. |
4 |
sp_context_field |
|
|
Erfasst Kontextinformationen für das angegebene Feld. Die erfassten Informationen werden in den Suchergebnissen mithilfe des Vorlagentags |
5 |
sp_d |
|
|
Gibt den Typ der zu durchsuchenden Datumsbereiche an. Mögliche Werte für den Typ sind beliebige, d. h. keine Suche nach Datumsbereichen, benutzerspezifisch. Dies bedeutet, dass der Wert von |
6 |
|
sp_d_# |
|
Gibt den Typ der Datumsbereichssuche für die entsprechende Sie können |
7 |
sp_date_range |
|
|
Gibt einen vordefinierten Datumsbereich an, der auf die Suche angewendet werden soll. Werte größer gleich null geben die Anzahl der Tage an, die vor dem heutigen Tag gesucht werden sollen — — Beispielsweise gibt der Wert "0"den Wert "today"an, der Wert "1"den Wert "today"und "gestern", der Wert "30"den Wert "within the last 30 days"usw. Werte unter null geben einen benutzerdefinierten Bereich wie folgt an: -1 = "Keine", genau wie bei Angabe eines Datumsbereichs. -2 = "Diese Woche", die von Sonntag bis Samstag der aktuellen Woche durchsucht. -3 = "Letzte Woche", die von Sonntag bis Samstag der Woche vor der aktuellen Woche durchsucht wird. -4 = "Dieser Monat", der Daten innerhalb des aktuellen Monats durchsucht. -5 = "Letzter Monat", der Daten innerhalb des Monats vor dem aktuellen Monat durchsucht. -6 = "Dieses Jahr", das Daten innerhalb des aktuellen Jahres durchsucht. -7 = "Letztes Jahr", das Daten innerhalb des Jahres vor dem aktuellen Jahr durchsucht. |
8 |
|
sp_date_range_# |
|
Gibt einen vordefinierten Datumsbereich an, der auf die entsprechende Werte größer als oder gleich null geben die Anzahl der Tage an, die vor dem heutigen Tag gesucht werden sollen. Beispielsweise gibt der Wert 0 heute an; Der Wert 1 gibt heute und gestern an. Der Wert 30 gibt innerhalb der letzten 30 Tage usw. an. Werte unter null geben einen benutzerdefinierten Bereich wie folgt an: -1 = "Keine", genau wie bei Angabe eines Datumsbereichs. -2 = "Diese Woche", die von Sonntag bis Samstag der aktuellen Woche durchsucht. -3 = "Letzte Woche", die von Sonntag bis Samstag der Woche vor der aktuellen Woche durchsucht wird. -4 = "Dieser Monat", der Daten innerhalb des aktuellen Monats durchsucht. -5 = "Letzter Monat", der Daten innerhalb des Monats vor dem aktuellen Monat durchsucht. -6 = "Dieses Jahr", das Daten innerhalb des aktuellen Jahres durchsucht. -7 = "Letztes Jahr", das Daten innerhalb des Jahres vor dem aktuellen Jahr durchsucht. |
9 |
sp_dedupe_field |
|
|
Gibt ein einzelnes Feld an, in dem die Suchergebnisse dedupliziert werden sollen. Alle Duplikat-Ergebnisse in diesem Feld werden aus den Suchergebnissen entfernt. Beispiel: Wenn für |
10 |
sp_e |
|
|
Gibt an, dass für alle Wörter aus der Abfrage-Zeichenfolge mit mehr als Zeichen eine automatische Platzhaltererweiterung erfolgen soll. Mit anderen Worten, |
11 |
|
sp_e_# |
|
Gibt an, dass die automatische Platzhaltererweiterung für alle Wörter aus der entsprechenden Abfrage-Zeichenfolge |
12 |
sp_end_day, sp_end_month, sp_end_year |
|
|
Dieses Wertetriplet gibt den Enddatumsbereich für die Suche an und muss als Satz angegeben werden. |
13 |
sp_f |
|
|
Gibt den Zeichensatz der Parameterzeichenfolgen der Abfrage an (z. B. |
14 |
sp_field_table |
|
|
Definiert eine logische Datentabelle, die aus den angegebenen Feldern besteht. Beispielsweise würde eine Tabelle mit dem Namen "items"aus den Feldern "color", "size"und "price"wie folgt definiert: Logische Tabellen sind besonders hilfreich in Verbindung mit Feldern, in denen "Zulassungslisten" markiert ist (unter Einstellungen > Metadaten > Definitionen ). Alle CGI-Parameter und Vorlagen-Tags, die einen Feldnamen als Wert annehmen, können optional einen Tabellennamen gefolgt von einem ""angeben. vor dem Feldnamen (z. B. Wenn Sie beispielsweise nach Dokumenten suchen möchten, die ein oder mehrere rote Elemente in der Größe "groß"enthalten (wobei Elemente als parallele Zeilen mit Metadaten dargestellt werden), können Sie Folgendes verwenden: |
15 |
sp_i |
|
|
|
| ||||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
|
| |||
| ||||
|
| |||
| ||||
|
| |||
| sp_w_control
| |||
|
| |||
|
|
Über den folgenden Link wird eine Suche mit "Music"als Abfrage der Suche Beginn und alle Standardparameter verwendet. Beachten Sie, dass die URL zur Lesbarkeit auf zwei Zeilen aufgeteilt ist. In Ihrem HTML-Code sollte sich dieser Link alle in einer Zeile befinden.
<a href="https://search.atomz.com/search/?sp_q=Music&sp_a=sp99999999">
Testing...</a>
Dieselben Funktionen werden typischerweise mit einem Formular definiert:
<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>
Normalerweise sollten Sie beim Starten einer Suche Standardparameter verwenden. Auf diese Weise wird die erste Seite angezeigt, sortiert nach Relevanz, und der Kunde kann andere Seiten und andere Optionen auswählen. Wenn das Suchformular auf Ihrer Site Optionen für Sammlungen enthält, geben Sie den Sammlungsnamen als Parameter an.
Die folgenden Formular-Abfragen zeigen 25
Ergebnisse an, die mit dem Ergebnis 10
beginnen. Zusammenfassungen werden nicht angezeigt, die Sortierreihenfolge ist nach Datum geordnet und die Sammlung mit dem Namen support
wird verwendet. Es werden nur Dokumente zurückgegeben, die innerhalb der letzten 30 Tage datiert wurden.
<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>