Utilizzo della Amazon Kendra JavaScript libreria per inviare feedback

Amazon Kendra fornisce una JavaScript libreria che puoi utilizzare per aggiungere feedback sui clic alla pagina dei risultati di ricerca. Per utilizzare la libreria, inserite un tag script nel codice client che visualizza i risultati della ricerca, quindi aggiungete informazioni a ciascuno dei link ai documenti nell'elenco dei risultati. Quando un utente sceglie un link per visualizzare un documento, le informazioni sui clic vengono inviate a Amazon Kendra.

La libreria funziona con i browser che supportano la JavaScript versione ES6/ES2015.

Passaggio 1: inserisci un tag script nell'applicazione di ricerca Amazon Kendra

Nel codice client che visualizza i risultati della Amazon Kendra ricerca, inserisci un <script>tag e aggiungi un riferimento alla JavaScript libreria:

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

Lo script scarica in modo asincrono la JavaScript libreria da un CDN Amazon Kendra ospitato e inizializza una variabile globale chiamata kendraFeedback che consente di impostare parametri opzionali.

Sostituisci l'URL di download della libreria e l'endpoint di feedback con un identificatore della tabella seguente in base alla regione che ospita l'indice. Amazon Kendra

Regione	Scarica il URL	Endpoint di feedback
us-east-1	https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js	https://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/submit
us-east-2	https://d2crv7fufeg244.cloudfront.net/ksf-v1.js	https://i6h76zwzf3.execute-api.us-east-2.amazonaws.com/prod/submit
us-west-2	https://d2iezfpnpcoujy.cloudfront.net/ksf-v1.js	https://wg6nim909c.execute-api.us-west-2.amazonaws.com/prod/submit
ca-central-1	https://d1zbkfomowykaq.cloudfront.net/ksf-v1.js	https://budi8txevj.execute-api.ca-central-1.amazonaws.com/prod/submit
eu-west-1	https://d3gptlxtulu4us.cloudfront.net/ksf-v1.js	https://po2b11740b.execute-api.eu-west-1.amazonaws.com/prod/submit
ap-southeast-1	https://d1vvuam7g4taoe.cloudfront.net/ksf-v1	https://9je5uw7t5l.execute-api.ap-southeast-1.amazonaws.com/prod/submit
ap-southeast-2	https://dopqntoe6z0ce.cloudfront.net/ksf-v1.js	https://oovf4nvjj7.execute-api.ap-southeast-2.amazonaws.com/prod/submit
ap-south-1	https://d1ts9ouelsmk3g.cloudfront.net/ksf-v1.js	https://k1abnmd43b.execute-api.ap-south-1.amazonaws.com/prod/submit
ap-northeast-1	https://d3w0ybsa293kb4.cloudfront.net/ksf-v1.js	https://wg7rz0uzjh.execute-api.ap-northeast-1.amazonaws.com/prod/submit
eu-west-2	https://d1tsrujswld1d1.cloudfront.net/ksf-v1.js	https://qi7mct3x7f.execute-api.eu-west-2.amazonaws.com/prod/submit

Ad esempio, se l'indice si trova negli Stati Uniti orientali (Virginia settentrionale), l'URL di download della libreria è https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js e l'endpoint di feedback è. https://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/submit

È possibile configurare due impostazioni opzionali per la Amazon Kendra JavaScript libreria:

• disableCookies— Per impostazione predefinita, Amazon Kendra imposta un cookie che identifica in modo univoco l'utente. Impostalo per true disabilitare il cookie.

  kendraFeedback('disableCookie', 'true | false');

  searchDivClassName— Per impostazione predefinita, Amazon Kendra monitora i clic su tutti i link nella pagina dei risultati di ricerca. Impostalo su un nome <div> di classe per monitorare solo i link nella classe specificata.

  kendraFeedback('searchDivClassName', 'class name');

Passaggio 2: aggiungi il token di feedback ai risultati della ricerca

Nella pagina dei risultati, aggiungi un attributo HTML chiamato data-kendra-token al tag anchor o al tag div principale immediato che contiene un link al documento dalla risposta alla query. Per esempio:

<a href="document location" data-kendra-token="feedback token value"></a>
OR
<div data-url="document location" data-kendra-token="feedback token value"></div>

Una risposta alla query contiene un token nel feedbackToken campo. Il token identifica in modo univoco la risposta se l'utente la sceglie. Assegna il valore del token all'attributo. data-kendra-token La Amazon Kendra JavaScript libreria cerca questo token quando l'utente sceglie il risultato e lo invia a un Amazon Kendra endpoint come feedback.

La Amazon Kendra JavaScript libreria invia solo il token di feedback e altri metadati, come l'ora in cui è stato scelto il risultato e un ID visitatore univoco.

Fase 3: Prova lo script di feedback

Per assicurarti che la JavaScript libreria sia configurata correttamente e che invii il feedback all'endpoint corretto, procedi come segue. Questo esempio utilizza il browser Chrome.

1. Apri gli strumenti per sviluppatori Web nel browser. Su Chrome, apri il menu Chrome nell'angolo in alto a destra del browser, scegli Altri strumenti, quindi scegli Strumenti per sviluppatori.

2. Assicurati che non vi siano errori relativi alla Amazon Kendra JavaScript libreria nella scheda della console.

3. Effettua una ricerca e scegli un risultato qualsiasi. Nella scheda Rete degli strumenti per sviluppatori. Dovresti vedere una richiesta inviata all'endpoint di feedback, il token del risultato e lo stato 200 OK.