Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
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 Amazon Kendra di ricerca
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 library download URL
e feedback
endpoint
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/inviare |
us-east-2 | https://d2crv7fufeg244.cloudfront.net/ksf-v1.js | https://i6h76zwzf3.execute-api.us-east-2.amazonaws.com/prod/inviare |
us-west-2 | https://d2iezfpnpcoujy.cloudfront.net/ksf-v1.js | https://wg6nim909c.execute-api.us-west-2.amazonaws.com/prod/inviare |
ca-central-1 | https://d1zbkfomowykaq.cloudfront.net/ksf-v1.js | https://budi8txevj.execute-api.ca-central-1.amazonaws.com/prod/inviare |
eu-west-1 | https://d3gptlxtulu4us.cloudfront.net/ksf-v1.js | https://po2b11740b.execute-api.eu-west-1.amazonaws.com/prod/inviare |
ap-southeast-1 | https://d1vvuam7g4taoe.cloudfront.net/ksf-v1.js | https://9je5uw7t5l.execute-api.ap-southeast-1.amazonaws.com/prod/inviare |
ap-southeast-2 | https://dopqntoe6z0ce.cloudfront.net/ksf-v1.js | https://oovf4nvjj7.execute-api.ap-southeast-2.amazonaws.com/prod/inviare |
ap-south-1 | https://d1ts9ouelsmk3g.cloudfront.net/ksf-v1.js | https://k1abnmd43b.execute-api.ap-south-1.amazonaws.com/prod/inviare |
ap-northeast-1 | https://d3w0ybsa293kb4.cloudfront.net/ksf-v1.js | https://wg7rz0uzjh.execute-api.ap-northeast-1.amazonaws.com/prod/inviare |
eu-west-2 | https://d1tsrujswld1d1.cloudfront.net/ksf-v1.js | https://qi7mct3x7f.execute-api.eu-west-2.amazonaws.com/prod/inviare |
Ad esempio, se l'indice si trova negli Stati Uniti orientali (Virginia settentrionale), library
download URL
è https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js
ed feedback endpoint
è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 pertrue
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.
-
Apri gli strumenti per sviluppatori Web nel browser. Su Chrome, apri il menu Chrome nell'angolo superiore destro del browser, scegli Altri strumenti, quindi scegli Strumenti per sviluppatori.
-
Assicurati che non vi siano errori relativi alla Amazon Kendra JavaScript libreria nella scheda della console.
-
Effettua una ricerca e scegli qualsiasi risultato. 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.