Haftungsausschluss: Dieser Artikel wurde durch maschinelle Übersetzung erstellt.

URL-Mapping

Aktualisiert
  • Aktualisiert am Feb 4, 2026
  • 9 Gelesene Minute(n)
Prev Next

Die URL-Mapping-Funktion im Knowledge Base-Widget ermöglicht es Ihnen, die Anzeige bestimmter Artikel und Kategorien basierend auf den Seiten anzupassen, die Ihre Endnutzer besuchen. Diese Funktionalität verbessert nicht nur das Nutzererlebnis, indem sie sie zu relevanten Inhalten leitet, sondern ermöglicht es auch, das Knowledge Base-Widget auf bestimmten URLs auszublenden oder eine Suchleiste mit benutzerdefinierten Platzhaltern bereitzustellen, die die Nutzer anleiten, was sie suchen sollen.

Verwendung von URL-Mapping

Um URL-Mapping zu konfigurieren, führen Sie bestimmte Aktionen im Knowledge Base-Widget für zugewiesene URLs aus.

Aktionen

Es gibt vier Aktionen, die du mit URL-Mapping ausführen kannst:

  1. Artikel anzeigen: Zeigt einen einzelnen Artikel auf der angegebenen URL an.

  2. Liste der Artikel anzeigen: Listet ausgewählte Artikel unter dem Abschnitt Empfohlen im Knowledge Base-Widget auf der angegebenen URL auf.

  3. Suchergebnisse anzeigen: Ermöglicht es Ihnen, einen bestimmten Suchbegriff einzustellen, um Ihre Wissensdatenbank abzufragen und relevante Suchergebnisse auf der angegebenen URL anzuzeigen.

  4. Widget ausblenden: Verhindert, dass das Knowledge Base-Widget-Symbol auf der angegebenen URL erscheint.

Diese Aktionen findest du unter dem Reiter URL Mapping oder beim Bearbeiten einer bestehenden Mapping.

HINWEIS

Damit URL-Mapping funktioniert, muss das Knowledge Base-Widget auf deiner Website oder in deiner App installiert sein. Weitere Informationen finden Sie im Artikel über die Installation des Knowledge Base-Widgets.

URL-Parameter

Bei der Konfiguration der URL des Knowledge Base-Widgets können Sie drei Arten von Parametern angeben:

  1. Pfad einbeziehen: /thisis/a/path

  2. Anfrage einfügen: ?animal=bear

  3. Hash einbauen: #inbox

Du kannst auch den Is Regex-Schalter aktivieren, um reguläre Ausdrücke in deine URL-Konfigurationen einzubauen.

URL-Mapping zu deinem Widget hinzufügen

Um das gewünschte Widget in Ihre Wissensdatenbank zu integrieren, folgen Sie diesen Schritten:

  1. Navigieren Sie zu Connections () > Knowledge Base-Widget in der linken Navigationsleiste Ihres Knowledge base portal.

  2. Gehe zum gewünschten Widget und klicke auf den Tab URL Mapping .

  3. Sie können entweder Ask Eddy AI wählen, um Anfragen zu stellen, oder einen Artikel durchsuchen oder neue URL-Zuordnung wählen.

  4. Klicken Sie auf Neue URL-Zuordnung und geben Sie Folgendes an:

    • Name – Der URL-Mapping-Name wird nur im URL-Mapping-Datensatz innerhalb von Document360 angezeigt

    • URL-Struktur  – Wählen Sie den gewünschten URL-Parametertyp (Pfad einschließen/Abfrage einschließen/Hash einschließen). Du musst mindestens einen URL-Parameter aktivieren

    • Gib die URL ein, auf der der Artikel/die Kategorie angezeigt werden soll oder die Aktion ausgeführt werden soll.

      HINWEIS

      Ihr Domainname ist nicht im URL-Pfad enthalten. Zum Beispiel https://document360.com/ebook/rapid-guide-to-launch-your-knowledge-base/wäre dein URL-Pfad /ebook/rapid-guide-to-launch-your-knowledge-base/

    • Aktion – Wählen Sie die gewünschte Aktion aus.

    • Arbeitsbereich auswählen – Wähle die gewünschte Version (wenn du mehrere Versionen hast).

    • Sprache zu – Wähle die gewünschte Sprache (wenn du mehrere Sprachen hast).

    • Artikel anzuzeigen – Wählen Sie in der Suchleiste die Artikel/Kategorien aus, die Sie aus Ihrer Wissensdatenbank anzeigen möchten.

    HINWEIS

    Ordnerkategorien sind nicht zur Auswahl verfügbar. Nur Seiten - und Indexkategorien können ausgewählt werden.

  5. Klicken Sie auf Erstellen.

Sobald ein Endnutzer auf den angegebenen URL-Pfad zugreift und das Knowledge Base-Widget öffnet, sieht er den zugeordneten Artikel/die Kategorie. Diese Informationen bleiben konsistent, während sie zwischen den Knowledge Base-Widget-Tabs innerhalb derselben Version und Sprache navigieren.

Konfiguration der kontextuellen KI-Unterstützung

Die Option Kontextuelle KI-Unterstützung ermöglicht es Ihnen, KI-gestützte Prompts im Knowledge Base-Widget anzuzeigen. Je nach Ihrer Konfiguration können diese Eingabeaufforderungen entweder erscheinen, wenn Nutzer auf einen Button klicken, oder automatisch, wenn sie eine bestimmte Seite zusammen mit der Antwort auf die Eingaben öffnen.

Widget configuration interface showing URL mapping and contextual AI assistance options.

HINWEIS

Um die kontextuelle KI-Unterstützung zu konfigurieren, stellen Sie sicher, dass die KI-Assistenzsuche für das Widget aktiviert ist.

Verständnis von Prompting-Typen

Man kann die Kontextuelle KI-Unterstützung auf zwei Arten konfigurieren.

  1. Button-basierte Eingabeaufforderung

  2. Seitenebene-Prompting

Button-basierte Eingabeaufforderung

Nutzen Sie diese Option, um kontextbewusste Hilfe anzuzeigen, wenn Leser bestimmte Buttons auf Ihrer Website oder App klicken.

  • Jede Eingabeaufforderung, die du hinzufügst, erzeugt einen einzigartigen Trigger-Schlüssel.

  • Der Prompt wird automatisch überprüft, wenn man Enter drückt, um zu bestätigen, ob eine Antwort in den verbundenen Quellen gefunden wird.

  • Du kannst entweder einen bestehenden Button aktualisieren, indem du das benutzerdefinierte Attribut d360AIHelp mit der Trigger-Taste als Wert hinzufügst, oder einen neuen Button erstellen, indem du den Installationscode-Ausschnitt kopierst und in dein HTML einfügst.

  • Wenn der Button angeklickt wird, öffnet sich das Widget automatisch und zeigt die konfigurierte KI-Eingabe mit der entsprechenden Antwort an.

  • Du kannst bis zu 5 Button-Prompt-Mappings pro URL konfigurieren.

  • Wenn mehrere Buttons auf derselben Seite konfiguriert sind:

    • Die Eingabeaufforderung für den angeklickten Button wird zuerst angezeigt.

    • Prompts von anderen Buttons erscheinen im Widget als verwandte oder vorgeschlagene Anfragen.

Seitenebene-Prompting

Nutzen Sie diese Option, um KI-gesteuerte Hilfe automatisch bereitzustellen, wenn Nutzer eine bestimmte Seite öffnen, ohne dass eine Tasteninteraktion erforderlich ist.

  • Um diese Option auszuwählen, wählen Sie während der Konfiguration der Kontextuellen KI-Unterstützung die Seitenebene aktivieren .

  • Füge eine oder mehrere Prompts hinzu, die ausgelöst werden, wenn Nutzer auf die konfigurierte URL zugreifen. Der Prompt wird automatisch überprüft, wenn man Enter drückt, um zu bestätigen, ob eine Antwort in den verbundenen Quellen gefunden wird.

  • Du kannst bis zu 5 Prompts pro Seite hinzufügen.

    • Der erste Prompt wird als Hauptfrage angezeigt.

    • Die übrigen Prompts erscheinen als vorgeschlagene Anfragen.

Eingabeaufforderungen hinzufügen, validieren und entfernen

Für button-basierte Eingabeaufforderungen

  1. Im Abschnitt Kontextuelle KI-Unterstützung konfigurieren lassen Sie die Eingabe "Seitenebene aktivieren " nicht aktiviert.

Configuration options for a contextual AI assistance widget with various actions listed.

  1. Gib als Nächstes deine Suchaufforderung ein.

  2. Drücken Sie Enter, um die Eingabeaufforderung zu validieren.

    • Wenn das System eine Antwort findet, wird die Antwort neben der Aufforderung als grünes Etikett angezeigt.

    • Wenn kein übereinstimmendes Ergebnis gefunden wird, zeigt das System "Antwort nicht gefunden" als rotes Label an.

  3. Wenn du einen bestehenden Button aktualisierst, kopiere die Trigger-Taste und füge sie mit dem d360AIHelp Attribut zum Code des bestehenden Buttons hinzu.

    Zum Beispiel

    <button d360AIHelp="no6gNpyDqtyBhCVFMhYDXhugZ">Need help?</button>

Instructions for adding URL mapping and contextual AI assistance in a widget interface.

  1. Wenn Sie einen neuen Button erstellen, klicken Sie neben Installationscode auf Code kopieren , um den neuen Button zu erstellen, und fügen Sie den Ausschnitt dann in das HTML Ihrer Seite ein.

Instructions for configuring contextual AI assistance with a widget installation code.

  1. Um einen weiteren buttonbasierten Prompt hinzuzufügen, klicken Sie auf Mehr hinzufügen und wiederholen Sie den Vorgang.

  2. Um einen Prompt zu entfernen, klicken Sie neben dem jeweiligen Eintrag auf Entfernen .

Für Seitenebene-Prompting

Configuration options for a widget including URL mapping and contextual AI assistance settings.

  1. Wählen Sie das Kästchen Seitenebene aktivieren aus.

  2. Im Suchfeld geben Sie Ihre Anfrage ein.

  3. Drücken Sie Enter, um die Eingabeaufforderung zu validieren.

    • Wenn das System eine Antwort findet, wird die Antwort neben der Aufforderung als grünes Etikett angezeigt.

    • Wenn kein übereinstimmendes Ergebnis gefunden wird, zeigt das System "Antwort nicht gefunden" als rotes Label an.

  4. Um einen weiteren Prompt hinzuzufügen, klicken Sie auf Mehr hinzufügen und geben Sie eine neue Abfrage ein. Wiederhole das, bis du bis zu vier Prompts für diese URL hinzugefügt hast.

  5. Um einen Prompt zu löschen, klicken Sie neben dem Promptfeld auf Entfernen .

Sobald Sie entweder button-basierte oder Seitenebene-Prompts konfiguriert haben, klicken Sie auf Erstellen.

Sie können Standard-URL-Mapping-Aktionen (wie Artikel anzeigen) mit kontextueller KI-Unterstützung über verschiedene URLs hinweg kombinieren, um ein maßgeschneidertes, intelligentes Nutzererlebnis zu bieten.

URL-Mapping bearbeiten

Um eine bestehende URL-Zuordnung zu ändern:

  1. Fahren Sie mit der Maus über das gewünschte Knowledge Base-Widget und klicken Sie auf das Bearbeiten ()-Symbol.

    Im Reiter URL-Mapping finden Sie die Liste der verfügbaren URL-Mapping.

  2. Fahren Sie mit der Maus über die gewünschte URL-Zuordnung und klicken Sie auf das Bearbeiten ()-Symbol.

    Das Panel "URL aktualisieren " erscheint.

  3. Aktualisieren Sie die gewünschten Informationen und klicken Sie auf Aktualisieren.

URL-Mapping löschen

Du kannst ein festgelegtes URL-Mapping löschen.

  1. Fahren Sie mit der Maus über das gewünschte Knowledge Base-Widget und klicken Sie auf das Bearbeiten ()-Symbol.

  2. Im Reiter URL-Mapping finden Sie die Liste der verfügbaren URL-Mapping.

  3. Fahre mit der Maus über die gewünschte URL-Zuordnung und klicke auf das Löschen ()-Symbol.

  4. Klicke im Bestätigungsprompt "Löschen" auf Ja.

URL-Mapping-Einstellungen

Du kannst das Verhalten des Knowledge Base-Widgets für URLs definieren, die keine konfigurierte Zuordnung haben. Die Definition dieses Verhaltens kann das Nutzererlebnis und die Zugänglichkeit zur Dokumentation verbessern.

Settings for configuring a knowledge base widget, highlighting URL mapping options.

  1. Gehe zu deinem gewünschten Widget und klicke auf Bearbeiten.

  2. Klicke auf den Reiter Konfigurieren & Verbinden .

  3. Unter dem Abschnitt Einstellungen für Einstellungen setzen erweitern Sie den Bereich URL-Mapping-Einstellungen .

  4. Wählen Sie die gewünschte Option aus:

    • Navigieren Sie zur Seitenhilfe/Wissensdatenbank: Wählen Sie diese Option, um den Artikel/die Kategorie im Reiter Seitenhilfe oder Wissensdatenbank im Widget anzuzeigen.

    • Nehmen Sie keine Änderungen an der bestehenden Einrichtung vor: Wählen Sie diese Option, um den zuletzt geöffneten Artikel/die zuletzt geöffnete Kategorie im Widget anzuzeigen.

  5. Klicken Sie auf Speichern.

Grundlegende URL-Übereinstimmung

Das Verständnis des URL-Matching ist entscheidend für effektives URL-Mapping. Ein universelles Regex zum Abgleichen typischer URLs sieht so aus:

^https?://?[a-zA-Z0-9.-]+/[a-zA-Z0-9/._-]*??[a-zA-Z0-9=&._-]*?#[a-zA-Z0-9_-]*?$

Erklärung der Komponenten

  • ^https?://?: Entspricht dem Protokoll (z. B. http:// oder https://). Das ? macht das Protokoll optional.

    HINWEIS

    Stelle sicher, dass du vor jedem Vorwärtsschrägstrich (/) einen Rückwärtsschrägstrich (\) hinzufügst, während du deine URL auf https://regex101.com testest.

  • [a-zA-Z0-9.-]+: Entspricht dem Domainnamen, einschließlich Buchstaben, Zahlen, Punkten (.) und Bindestrichen (-).

  • /[a-zA-Z0-9/._-]*?: Entspricht dem Pfad nach der Domäne und erlaubt Schrägstriche, alphanumerische Zeichen, Punkte, Unterstriche und Bindestriche.

  • ?[a-zA-Z0-9=&._-]*?: Entspricht optionalen Abfrageparametern (z. B. ?key=value), wodurch dieser Teil optional ist.

  • #[a-zA-Z0-9_-]*?: Entspricht dem Fragment (z. B. #section), was ebenfalls optional ist.

Beispiele für URL-Mapping mit Regex

Abbildung spezifischer URL-Strukturen

Die folgende Tabelle zeigt, wie man URL-Mappings für bestimmte URL-Muster konfiguriert. Diese Konfigurationen helfen dabei, eine genaue Abgleichung basierend auf dem URL-Pfad oder der Abfragestruktur sicherzustellen.

URL-Struktur

URL-Mapping-Konfiguration

/buckets

/buckets$
(Konfigurieren, wenn die URL mit bucketsendet)

/buckets?isCreatingBucket

/buckets\?[a-z]*
(Konfigurieren, wenn die URL nach dem Abfrageparameter zufällige Texte enthält)

Beispielmatches

  • /buckets

  • /buckets?isCreatingBucket

  • /buckets?isCreatingBucket=true

Um ein URL-Muster wie /users/{id}abzubilden, verwenden Sie:

^/users/[0-9]+$

Dies erfasst eine Benutzer-ID dynamisch.

Beispielmatches

  • /users/123

  • /users/456

Zuordnung von URLs mit Abfrageparametern

Für URLs wie /search?q={query}, wäre das Regex wie folgt:

^/search?q=[a-zA-Z0-9]+$

Beispielmatches

  • /search?q=apple

  • /search?q=123abc

Zuordnung von URLs mit optionalen Parametern

Für ein URL-Muster wie /products/{category}/{id}, wobei die Kategorie optional ist:

^/products/[a-zA-Z]+?/[0-9]+$

Beispielmatches

  • /products/123

  • /products/electronics/123

URLs mit einer Wildcard oder mehreren Pfaden zuordnen

Für /blog/*:

^/blog/.*?$

Beispielmatches

  • /blog

  • /blog/how-to-code

  • /blog/2021/10

URLs mit Subdomains zuordnen
Für Subdomain-URLs:

^https?://?[a-zA-Z0-9-]+.example.com$

Beispielmatches

  • http://blog.example.com

  • https://shop.example.com

Kombination mehrerer Komponenten

Um komplexere URL-Zuordnungen zu bewältigen, können Sie die verschiedenen Komponenten nach Bedarf kombinieren. Das umfassende Regex, das eine URL mit einem optionalen Protokoll, einer Domäne, einem Pfad, den Abfrageparametern und einem Fragment abstimmt, sieht so aus:

^https?://?[a-zA-Z0-9.-]+/[a-zA-Z0-9/._-]*??[a-zA-Z0-9=&._-]*?#[a-zA-Z0-9_-]*?$

Häufig gestellte Fragen

Wie kann ich die Seitenhilfe und die Suchleiste aus dem Widget entfernen, wenn die URL-Zuordnung für einen einzelnen Artikel konfiguriert ist?

Um die Seitenhilfe und die Suchleiste aus dem Widget zu entfernen, wenn die URL-Zuordnung für einen einzelnen Artikel konfiguriert ist:

  1. Navigiere zum Widget () im Knowledge Base-Portal.

  2. Fahre mit der Maus über das gewünschte Widget und klicke auf das Edit ()-Symbol.

  3. Fügen Sie den bereitgestellten Code im Tab Custom CSS ein:

    li#page-help-tab {
    display: none;
}

.article-header .article-back-icon {
    display: none;
}

.search-container {
    display: none !Important;
}

  4. Füge den bereitgestellten Code im Tab Benutzerdefiniertes JavaScript ein:

    setTimeout(function() { $('.search-container').hide();}, 2000);
setTimeout(function() { $("#knowledge-base-tab").click();}, 2000);

  5. Klicken Sie auf Speichern.

Dadurch werden der Seitenhilfetab und die Suchleiste im Widget der Wissensdatenbank versteckt, wenn URL-Mapping für einen einzelnen Artikel konfiguriert ist.

Wie kann ich die Updates sofort im KB-Widget sehen, nachdem ich eine URL-Karte hinzugefügt oder aktualisiert habe?

Die Updates werden aus Leistungsgründen auf dem Server zwischengespeichert und werden automatisch alle 15 Minuten aktualisiert. Wenn Sie jedoch die Änderungen sofort sehen möchten, können Sie den Anwendungscache löschen.

Warum scheint eine konfigurierte URL-Zuordnung defekt zu sein?

Die URL-Zuordnung wäre aufgrund von Änderungen in der Konfiguration 'Widget filtern' im Tab 'Installation & Setup' defekt. Überprüfe die URL-Zuordnung und aktualisiere die Konfiguration.

Was ist URL-Mapping?

Mit URL-Mapping können bestimmte Artikel und Kategorien im Knowledge Base-Widget erscheinen, je nachdem, auf welcher Seite sich der Endnutzer befindet. Sie können auch URL-Mapping verwenden, um das Knowledge Base-Widget auf einer bestimmten URL auszublenden oder eine Suchleiste mit einem benutzerdefinierten Platzhalter bereitzustellen, um Endnutzern in die richtige Richtung zu weisen, was sie suchen sollen.

Kann ich reguläre Ausdrücke (regex) im URL-Mapping hinzufügen?

Sie können reguläre Ausdrücke in Ihre URL einfügen, indem Sie den Is Regex-Schalter aktivieren.

Was ist Regex?

Regex, kurz für "regulärer Ausdruck", ist eine Zeichenfolge, die ein Suchmuster definiert, das verwendet wird, um Textzeichenketten abzugleichen und zu bearbeiten.

Zum Beispiel kannst du regex verwenden, um eine einzelne URL-Zuordnung für mehrere Artikel mit ähnlichen URLs zu konfigurieren. Betrachten Sie ein Szenario, in dem Sie URL-Mapping für die folgenden Artikel mit der Basis-URL konfigurieren möchten 'https://example.com/docs/drive':

  • https://example.com/drive-General

  • https://example.com/drive-settings

  • https://example.com/drive-functionA

  • https://example.com/drive-functionB

  • https://example.com/drive-functionC

  • https://example.com/drive-functionD

  • https://example.com/drive-functionE

Ohne Regex müsstest du für jede URL individuelle URL-Zuordnungen hinzufügen. Mit der Aktivierung von regex können Sie jedoch mit einer einzigen URL-Mappe hinzufügen: Wählen Sie die Option "Pfad einbeziehen" und fügen Sie das URL-Feld hinzudocs/drive. Du kannst Regex nutzen, um einen effizienteren und schlankeren Kartierungsprozess zu ermöglichen.

Kann ich URL-Mapping für Kategorien hinzufügen?

Ja, du kannst URL-Mapping für Kategorien hinzufügen. Sie gilt nur für Seiten- und Indexkategorien.

Verwandte Artikel