URL-Mapping

Mit URL-Mapping können Sie konfigurieren, was das Knowledge Base-Widget seitenweise anzeigt. Für jede URL auf Ihrer Website oder Anwendung können Sie einen bestimmten Artikel, eine Kategorienliste, eine Suchleiste mit einem benutzerdefinierten Platzhalter anzeigen oder das Widget komplett ausblenden. Das macht das Widget kontextbewusst – Nutzer sehen die relevantesten Hilfeinhalte basierend darauf, wo sie sich in Ihrem Produkt befinden.

Wann sollte man URL-Mapping verwenden

• Stellen Sie einen bestimmten Artikel direkt im Widget auf einer Seite auf, auf der Nutzer ihn häufig benötigen.
• Zeigen Sie eine kuratierte Liste von Artikeln aus einer Kategorie, wenn sich ein Nutzer in einem bestimmten Produktmodul befindet.
• Verstecke das Widget auf Seiten, auf denen es nicht erscheinen sollte (z. B. auf Login-Seiten, Checkout-Flows).
• Zeigen Sie einen benutzerdefinierten Suchplatzhalter, der den Nutzern zeigt, wonach sie in einem bestimmten Kontext suchen sollen.
• Nutzen Sie KI-gestützte kontextuelle Unterstützung (Seitenebenen-Prompting) für spezifische URLs.

Bevor du anfängst

Die Inhalte, die du zuordnen möchtest (Artikel oder Kategorien), müssen in den konfigurierten Inhaltszugriffsbereich des Widgets fallen.

Aktionen

Es gibt fünf Aktionen, die Sie mit URL-Mapping ausführen können:

URL-Parameter

Bei der Konfiguration der Widget-URL können Sie drei Arten von Parametern angeben:

• Pfad einbeziehen: /thisis/a/path
• Anfrage einfügen: ?animal=bear
• Hash einbauen: #inbox

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

Wie man eine URL-Abbildung fügt

1. In der linken Navigationsleiste navigieren Sie zu Verbindungen () > Knowledge Base-Widget.

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

3. Klicken Sie auf den URL-Mapping-Tab .

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 aus (Pfad einschließen / Abfrage einschließen / Hash einschließen). Du musst mindestens einen URL-Parameter aktivieren. Gib die URL ein, auf der der Artikel oder die Aktion erscheinen soll.

     HINWEIS

     Ihr Domainname ist nicht im URL-Pfad enthalten. Zum Beispiel wäre /ebook/rapid-guide/für https://document360.com/ebook/rapid-guide/, der URL-Pfad .

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

   • Arbeitsbereich auswählen — Wählen Sie die gewünschte Version (wenn Sie mehrere Versionen haben).

   • Sprache zu — Wählen Sie die gewünschte Sprache aus (wenn Sie mehrere Sprachen haben).

   • Artikel anzuzeigen — Wählen Sie in der Suchleiste die Artikel oder Kategorien aus, die Sie anzeigen möchten.

     HINWEIS

     Ordnerkategorien sind nicht zur Auswahl verfügbar. Es sind nur Seiten - und Indexkategorien verfügbar.

5. Klicken Sie auf Erstellen.

Sobald ein Endnutzer auf die angegebene URL zugreift und das Widget öffnet, sieht er den zugeordneten Artikel oder die Kategorie. Dieser Inhalt bleibt erhalten, während sie zwischen den Widget-Tabs derselben Version und Sprache navigieren.

Bearbeiten von URL-Zuordnungen

1. Navigiere zu Verbindungen () > Knowledge Base-Widget.
2. Fahre mit der Maus über das gewünschte Widget und klicke auf Bearbeiten ().
3. Im Tab URL-Mapping finden Sie die Liste der verfügbaren Mappings.
4. Fahre mit der Maus über die gewünschte Zuordnung und klicke auf Bearbeiten ().
5. Das Panel "URL aktualisieren " erscheint.
6. Aktualisieren Sie die gewünschten Informationen und klicken Sie auf Aktualisieren.

Löschen von URL-Zuordnungen

1. Navigiere zu Verbindungen () > Knowledge Base-Widget.
2. Fahre mit der Maus über das gewünschte Widget und klicke auf Bearbeiten ().
3. Im Tab URL-Mapping finden Sie die Liste der verfügbaren Mappings.
4. Fahren Sie mit der Maus über die gewünschte Abbildung und klicken Sie auf Löschen ().
5. Klicke im Bestätigungsprompt "Löschen" auf Ja.

URL-Mapping-Einstellungen (Standardverhalten)

Du kannst das Verhalten des Widgets für URLs definieren, die keine konfigurierte Zuordnung haben.

1. Navigiere zu Verbindungen () > Knowledge Base-Widget.
2. Fahre mit der Maus über das gewünschte Widget und klicke auf Bearbeiten ().
3. Klicke auf den Reiter Konfigurieren & Verbinden .
4. Unter Einstellungen setzen erweitern Sie den Abschnitt URL-Mapping-Einstellungen .
5. Wählen Sie die gewünschte Option aus:
   • Navigieren Sie zur Seite Hilfe/Wissensdatenbank — Zeigen Sie den Artikel oder die Kategorie im Reiter Seite Hilfe oder Wissensdatenbank im Widget an.
   • Nehmen Sie keine Änderungen an der bestehenden Einrichtung vor — Zeigen Sie den zuletzt geöffneten Artikel oder die Kategorie im Widget an.
6. Klicken Sie auf Speichern.

Konfiguration kontextueller KI-Unterstützung

Die Aktion Contextual AI Assistance ermöglicht es Ihnen, KI-gestützte Prompts im Widget basierend auf Seitenkontext anzuzeigen. Prompts können erscheinen, wenn Nutzer auf einen Button klicken, oder automatisch, wenn sie eine bestimmte Seite öffnen.

Sie können die kontextuelle KI-Unterstützung auf zwei Arten konfigurieren:

• Button-basierte Eingabeaufforderung — Zeigt kontextbewusste Hilfe an, wenn Leser bestimmte Buttons auf Ihrer Website oder App anklicken.
• Seitenebene-Prompting — Bietet automatisch KI-gesteuerte Hilfe, wenn Nutzer eine bestimmte Seite öffnen, ohne dass Button-Interaktion erforderlich ist.

Button-basierte Eingabeaufforderung

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 bis zu 5 Button-Prompt-Mappings pro URL konfigurieren.

1. Im Abschnitt "Kontextuelle KI-Unterstützung konfigurieren " lassen Sie das Kästchen Seitenebene aktivieren offen aktiviert.
2. Geben Sie Ihre Suchaufforderung ein.
3. Drücken Sie Enter zum Validieren.
   • Wenn eine Antwort gefunden wird, erscheint ein grünes Etikett "Antwort gefunden ".
   • Wenn keine Antwort gefunden wird, erscheint ein rotes Etikett "Antwort nicht gefunden ".
4. Wenn Sie einen bestehenden Button aktualisieren, kopieren Sie die Trigger-Taste und fügen Sie sie mit dem Attribut d360AIHelp in den Code des Buttons ein:

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

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

6. Um einen weiteren Prompt hinzuzufügen, klicken Sie auf Mehr hinzufügen und wiederholen Sie. Um eine Aufforderung zu entfernen, klicken Sie auf Entfernen.

Seitenebene-Prompting

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.
   • Grüne Antwort gefunden = Antwort verfügbar.
   • Rote Antwort nicht gefunden = kein Treffer.
4. Um einen weiteren Prompt hinzuzufügen, klicken Sie auf Mehr hinzufügen. Du kannst bis zu 5 Prompts pro URL hinzufügen.
   • Der erste Prompt erscheint als Hauptfrage.
   • Die übrigen Prompts erscheinen als vorgeschlagene Anfragen.
5. Um einen Prompt zu löschen, klicke neben ihn auf Entfernen .

Sobald es konfiguriert ist, 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.

Verwendung von Regex in URL-Mapping

Das Verständnis des URL-Matching ist wichtig für ein effektives URL-Mapping. Aktivieren Sie den Schalter 'Is Regex' , wenn Sie eine Abbildung hinzufügen oder bearbeiten, um reguläre Ausdrücke zu verwenden.

Gängige Regex-Muster

Kartiere ein URL-Muster wie /users/{id}:

^/users/[0-9]+$

Karte /blog/* (Wildcard):

^/blog/.*?$

Karte /search?q={query}:

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

Mapping-Subdomain-URLs:

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

Grenzen und Einschränkungen

• URL-Zuordnungen müssen Inhalte im Inhaltszugriffsbereich des Widgets verwenden. Wenn sich der Umfang ändert, können bestehende Zuordnungen ungültig gemacht werden.
• Konfigurationsänderungen werden bis zu 15 Minuten zwischengespeichert. Lösche den Anwendungscache, um sofort Änderungen zu sehen.

Best Practices

• Kartieren Sie zuerst Ihre meistbesuchten Support-Seiten – die Analysen zeigen Ihnen, wo Nutzer am häufigsten nach Hilfe suchen.
• Nutze die Aktion Verstecken auf Seiten mit hoher Reibung (Login, Zahlung, Erstinstallation), wo das Widget eher ablenkt als hilft.
• Verwenden Sie Is Regex für patternbasierte Mappings, die mehrere ähnliche URLs abdecken müssen.

FAQ

li#page-help-tab { display: none; }
.article-header .article-back-icon { display: none; }

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

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