Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Verwenden Sie die Amazon Kendra JavaScript Bibliothek, um Feedback einzureichen
Amazon Kendra bietet eine JavaScript Bibliothek, mit der Sie Klick-Feedback zu Ihrer Suchergebnisseite hinzufügen können. Um die Bibliothek zu verwenden, fügen Sie ein Skript-Tag in Ihren Client-Code ein, das das Suchergebnis anzeigt, und fügen dann Informationen zu den einzelnen Dokumentlinks in Ihrer Ergebnisliste hinzu. Wenn ein Benutzer einen Link zum Anzeigen eines Dokuments auswählt, werden Klickinformationen an gesendet Amazon Kendra.
Die Bibliothek funktioniert mit Browsern, die JavaScript Version ES6 ES2 /015 unterstützen.
Schritt 1: Fügen Sie ein Script-Tag in Ihre Amazon Kendra Suchanwendung ein
Fügen Sie in Ihrem Client-Code, der die Amazon Kendra Suchergebnisse rendert, ein <script>Tag ein und fügen Sie einen Verweis auf die JavaScript Bibliothek hinzu:
<script> (function(w, d, s, c, g, n) { if(!w[n]) { w[n] = w[n] || function () { (w[n].q = w[n].q || []).push(arguments); } w[n].st = new Date().getTime(); w[n].ep = g; var e = document.createElement(s), j = document.getElementsByTagName(s)[0]; e.async = 1; e.src = c; e.type = 'module'; j.parentNode.insertBefore(e, j); } })(window, document, 'script', '
library download URL
', 'feedback endpoint
', 'kendraFeedback'); </script>
Das Skript lädt die JavaScript Bibliothek asynchron von einem Amazon Kendra gehosteten Server herunter CDN und initialisiert eine globale Variable namenskendraFeedback
, mit der Sie optionale Parameter festlegen können.
Ersetzen library download URL
and feedback
endpoint
mit einer Kennung aus der folgenden Tabelle, die auf der Region basiert, in der Ihr Index gehostet wird. Amazon Kendra
Region | Laden Sie herunter URL | Feedback-Endpunkt |
---|---|---|
us-east-1 | https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js | https://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/einreichen |
us-east-2 | https://d2crv7fufeg244.cloudfront.net/ksf-v1.js | https://i6h76zwzf3.execute-api.us-east-2.amazonaws.com/prod/einreichen |
us-west-2 | https://d2iezfpnpcoujy.cloudfront.net/ksf-v1.js | https://wg6nim909c.execute-api.us-west-2.amazonaws.com/prod/einreichen |
ca-central-1 | https://d1zbkfomowykaq.cloudfront.net/ksf-v1.js | https://budi8txevj.execute-api.ca-central-1.amazonaws.com/prod/einreichen |
eu-west-1 | https://d3gptlxtulu4us.cloudfront.net/ksf-v1.js | https://po2b11740b.execute-api.eu-west-1.amazonaws.com/prod/einreichen |
ap-southeast-1 | https://d1vvuam7g4taoe.cloudfront.net/ksf-v1 | https://9je5uw7t5l.execute-api.ap-southeast-1.amazonaws.com/prod/einreichen |
ap-southeast-2 | https://dopqntoe6z0ce.cloudfront.net/ksf-v1.js | https://oovf4nvjj7.execute-api.ap-southeast-2.amazonaws.com/prod/einreichen |
ap-south-1 | https://d1ts9ouelsmk3g.cloudfront.net/ksf-v1.js | https://k1abnmd43b.execute-api.ap-south-1.amazonaws.com/prod/einreichen |
ap-northeast-1 | https://d3w0ybsa293kb4.cloudfront.net/ksf-v1.js | https://wg7rz0uzjh.execute-api.ap-northeast-1.amazonaws.com/prod/einreichen |
eu-west-2 | https://d1tsrujswld1d1.cloudfront.net/ksf-v1.js | https://qi7mct3x7f.execute-api.eu-west-2.amazonaws.com/prod/einreichen |
Wenn sich Ihr Index beispielsweise in USA Ost (Nord-Virginia) befindet, library
download URL
ist https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js
und feedback endpoint
isthttps://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/submit
.
Es gibt zwei optionale Einstellungen, die Sie für die Amazon Kendra JavaScript Bibliothek vornehmen können:
-
disableCookies
— Amazon Kendra Setzt standardmäßig ein Cookie, das den Benutzer eindeutig identifiziert. Stellen Sie dies auf eintrue
, um das Cookie zu deaktivieren.kendraFeedback('disableCookie', '
true
|false
');searchDivClassName
— Überprüft standardmäßig alle Links auf Ihrer Suchergebnisseite auf Klicks. Amazon Kendra Stellen Sie dies auf einen<div>
Klassennamen ein, um nur Links in der angegebenen Klasse zu überwachen.kendraFeedback('searchDivClassName', '
class name
');
Schritt 2: Fügen Sie das Feedback-Token zu den Suchergebnissen hinzu
Fügen Sie auf Ihrer Ergebnisseite ein HTML Attribut hinzu, das dem Anchor-Tag oder dem unmittelbar übergeordneten Div-Tag zugeordnet ist und einen Link zu dem Dokument aus der Abfrageantwort enthält. data-kendra-token
Beispielsweise:
<a href="
document location
" data-kendra-token="feedback token value
"></a> OR <div data-url="document location
" data-kendra-token="feedback token value
"></div>
Eine Abfrageantwort enthält ein Token im feedbackToken
Feld. Das Token identifiziert die Antwort eindeutig, wenn der Benutzer sie auswählt. Weisen Sie dem data-kendra-token
Attribut den Wert des Tokens zu. Die Amazon Kendra
JavaScript Bibliothek sucht nach diesem Token, wenn der Benutzer das Ergebnis auswählt, und sendet es als Feedback an einen Amazon Kendra Endpunkt.
Die Amazon Kendra JavaScript Bibliothek übermittelt nur das Feedback-Token und andere Metadaten wie den Zeitpunkt, zu dem das Ergebnis ausgewählt wurde, und eine eindeutige Besucher-ID.
Schritt 3: Testen Sie das Feedback-Skript
Gehen Sie wie folgt vor, um sicherzustellen, dass die JavaScript Bibliothek korrekt konfiguriert ist und Feedback an den richtigen Endpunkt gesendet wird. In diesem Beispiel wird der Chrome-Browser verwendet.
-
Öffnen Sie die Tools für Webentwickler im Browser. Öffnen Sie in Chrome das Chrome-Menü in der oberen rechten Ecke des Browsers, wählen Sie Weitere Tools und dann Entwicklertools.
-
Stellen Sie sicher, dass auf der Registerkarte „Konsole“ keine Fehler im Zusammenhang mit der Amazon Kendra JavaScript Bibliothek vorliegen.
-
Führen Sie eine Suche durch und wählen Sie ein beliebiges Ergebnis aus. Auf der Registerkarte Netzwerk der Entwicklertools. Sie sollten eine an den Feedback-Endpunkt gesendete Anfrage, das Token für das Ergebnis und den Status 200 OK sehen.