Verwenden Sie die Amazon Kendra JavaScript Bibliothek, um Feedback einzureichen - Amazon Kendra

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.

  1. Ö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.

  2. Stellen Sie sicher, dass auf der Registerkarte „Konsole“ keine Fehler im Zusammenhang mit der Amazon Kendra JavaScript Bibliothek vorliegen.

  3. 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.