As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usando a Amazon Kendra JavaScript biblioteca para enviar feedback
<a name="feedback-javascript"></a>

Amazon Kendra fornece uma JavaScript biblioteca que você pode usar para adicionar feedback de cliques à sua página de resultados de pesquisa. Para usar a biblioteca, você insere uma tag de script no código do cliente que exibe o resultado da pesquisa e, em seguida, adiciona informações a cada um dos links do documento na sua lista de resultados. Quando um usuário escolhe um link para visualizar um documento, as informações de clique são enviadas para o Amazon Kendra.

A biblioteca funciona com navegadores que suportam a JavaScript versão ES6/ES2015.

## Etapa 1: inserir uma tag de script em seu aplicativo Amazon Kendra de pesquisa
<a name="javascript-step-1"></a>

No código do cliente que renderiza os resultados da Amazon Kendra pesquisa, insira uma <script>tag e adicione uma referência à JavaScript biblioteca:

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

O script baixa assincronamente a JavaScript biblioteca de uma CDN Amazon Kendra hospedada e inicializa uma variável global chamada `kendraFeedback` que permite definir parâmetros opcionais.

Substitua *library download URL* e *feedback endpoint* por um identificador da tabela a seguir com base na região que hospeda seu Amazon Kendra índice.


| Região | Faça download do URL | Endpoint de feedback | 
| --- | --- | --- | 
| us-east-1 | https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js | https://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/enviar | 
| us-east-2 |  https://d2crv7fufeg244.cloudfront.net/ksf-v1.js | https://i6h76zwzf3.execute-api.us-east-2.amazonaws.com/prod/enviar | 
| us-west-2 | https://d2iezfpnpcoujy.cloudfront.net/ksf-v1.js | https://wg6nim909c.execute-api.us-west-2.amazonaws.com/prod/enviar | 
| ca-central-1 | https://d1zbkfomowykaq.cloudfront.net/ksf-v1.js | https://budi8txevj.execute-api.ca-central-1.amazonaws.com/prod/enviar | 
| eu-west-1 | https://d3gptlxtulu4us.cloudfront.net/ksf-v1.js | https://po2b11740b.execute-api.eu-west-1.amazonaws.com/prod/enviar | 
| ap-southeast-1 | https://d1vvuam7g4taoe.cloudfront.net/ksf-v1.js | https://9je5uw7t5l.execute-api.ap-southeast-1.amazonaws.com/prod/enviar | 
| ap-southeast-2 | https://dopqntoe6z0ce.cloudfront.net/ksf-v1.js | https://oovf4nvjj7.execute-api.ap-southeast-2.amazonaws.com/prod/enviar | 
| ap-south-1 | https://d1ts9ouelsmk3g.cloudfront.net/ksf-v1.js | https://k1abnmd43b.execute-api.ap-south-1.amazonaws.com/prod/enviar | 
| ap-northeast-1 | https://d3w0ybsa293kb4.cloudfront.net/ksf-v1.js | https://wg7rz0uzjh.execute-api.ap-northeast-1.amazonaws.com/prod/enviar | 
| eu-west-2 | https://d1tsrujswld1d1.cloudfront.net/ksf-v1.js | https://qi7mct3x7f.execute-api.eu-west-2.amazonaws.com/prod/enviar | 

Por exemplo, se seu índice estiver no Leste dos EUA (Norte da Virgínia), *library download URL* é `https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js` e *feedback endpoint* é`https://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/submit`.

Há duas configurações opcionais que você pode fazer para a Amazon Kendra JavaScript biblioteca:
+ `disableCookies`— Por padrão, Amazon Kendra define um cookie que identifica exclusivamente o usuário. Defina isso como `true` para desativar o cookie.

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

  `searchDivClassName` – Por padrão, o Amazon Kendra monitora todos os links na página de resultados de pesquisa em busca de cliques. Defina isso como um nome de classe `<div>` para monitorar somente os links na classe especificada.

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

## Etapa 2: adicionar o token de comentários aos resultados da pesquisa
<a name="javascript-step-2"></a>

Na sua página de resultados, adicione um atributo do HTML chamado `data-kendra-token` à tag âncora ou à tag div primária imediata que contém um link para o documento a partir da resposta da consulta. Por exemplo:

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

Uma resposta de consulta contém um token no campo de `feedbackToken`. O token identifica a resposta de forma exclusiva se o usuário a escolher. Atribua o valor do token ao atributo de `data-kendra-token`. A Amazon Kendra JavaScript biblioteca procura esse token quando o usuário escolhe o resultado e o envia para um Amazon Kendra endpoint como feedback.

A Amazon Kendra JavaScript biblioteca envia apenas o token de feedback e outros metadados, como a hora em que o resultado foi escolhido e um ID de visitante exclusivo.

## Etapa 3: testar o script de comentários
<a name="javascript-step-3"></a>

Para garantir que a JavaScript biblioteca esteja configurada corretamente e enviando feedback para o endpoint correto, faça o seguinte. Este exemplo usa o navegador do Chrome.

1. Abra as ferramentas para desenvolvedores da Web no navegador. No Chrome, abra o **menu do Chrome** no canto superior direito do navegador, escolha **Mais ferramentas** e escolha **Ferramentas para desenvolvedores**.

1. Verifique se não há erros relacionados à Amazon Kendra JavaScript biblioteca na guia do console.

1. Faça uma pesquisa e escolha qualquer resultado. Na guia **Rede** das ferramentas do desenvolvedor. Visualize uma solicitação enviada ao endpoint de comentários, o token do resultado e um status de 200 OK.