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á.
# Capture a atividade dos visitantes do site com o rastreador de dados da web
O rastreador de dados da web captura como os visitantes interagem com seu site — itens clicados, pesquisas feitas, envio de formulários. Ele associa essa atividade ao perfil deles nos Perfis de clientes. O rastreador faz parte do widget de Comunicação e é controlado no nível do widget. Para obter uma visão geral de como o rastreador de dados da web e a notificação da web funcionam juntos, consulte[Rastreador de dados da web e notificação na web](customer-profiles-web-tracker-and-notification.md).
## Pré-requisitos
+ Uma instância do Connect Customer com o widget Communications configurado. Para obter mais informações, consulte [Adicione uma interface de usuário de chat ao seu site hospedado pelo Connect Customer](add-chat-to-website.md).
+ Perfis de clientes ativados na instância. Para obter mais informações, consulte [Ative perfis de clientes para sua instância Connect Customer](enable-customer-profiles.md).
## Etapa 1: Ativar a coleta de dados no widget de comunicações
1. Faça login no site do Connect Customer administrador.
1. No menu de navegação, escolha **Canais** e, em seguida, escolha **Widgets de comunicação**.
1. Crie um novo widget ou edite um existente. Para obter mais informações, consulte [Adicione uma interface de usuário de chat ao seu site hospedado pelo Connect Customer](add-chat-to-website.md).
1. Ative a **coleta de dados** para ativar o rastreamento do fluxo de cliques.
1. (Opcional) As configurações de **coleta de dados** incluem uma opção para **coleta avançada de dados**. Ative isso para que o serviço reúna automaticamente as interações dos visitantes com o conteúdo HTML, o que produz insights preditivos mais ricos e precisos.
1. (Opcional) Ative a **notificação pela Web** se você planeja enviar notificações proativas desse widget. Para obter mais informações, consulte [Envie notificações na web com as campanhas externas do Connect Customer](outbound-campaigns-web-notification.md).
1. Adicione os domínios do site em que o widget será incorporado à lista de domínios permitidos.
1. Salve o widget e copie o código do trecho do widget. Incorpore esse trecho ao seu site na próxima etapa.
## Etapa 2: incorporar o widget e inicializar o rastreamento
Incorpore o trecho do widget no HTML do seu site. Depois que o trecho for carregado, inicialize o rastreador depois de obter o consentimento do visitante.
```
// Start tracking visitor behavior (after obtaining consent)
await window.amazon_connect.Web.ClickStream.init();
// (Optional) Enable web notifications for this visitor
await window.amazon_connect.Web.Notification.init();
```
**Importante**
Inicialize o rastreamento somente após obter o consentimento apropriado do visitante, de acordo com sua política de privacidade e os regulamentos aplicáveis.
**nota**
Para aplicativos de página única, incorpore o trecho uma vez na página de nível superior. Para aplicativos de várias páginas, incorpore o trecho em todas as páginas em que você deseja capturar a atividade.
## Etapa 3: (Opcional) Acompanhe eventos específicos da empresa
Para capturar eventos comerciais personalizados, como conclusões de compras, ações de adição ao carrinho ou visualizações de produtos, ligue `recordBusinessMetric` do seu site JavaScript quando o evento ocorrer.
**Importante**
Se você planeja usar o rastreador de dados com recomendadores que exigem contextos de itens, como `Find Similar Items` e`Frequently Paired Items`, você deve usar eventos específicos da empresa e incluir o campo. `item_id`
### Assinatura do método
```
await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)
```
| **Parâmetro** | **Tipo** | **Descrição** |
| --- | --- | --- |
| `eventType` | string | O nome do evento comercial — um tipo reservado ou qualquer sequência de caracteres personalizada. |
| `eventPayload` | objeto | Dados de eventos estruturados usando os esquemas de objetos abaixo. |
### Esquemas de objetos
O `eventPayload` suporta os seguintes objetos. Use qualquer combinação de campos para se adequar ao seu caso de uso.
| **Objeto** | **Campos-chave** | **Descrição** |
| --- | --- | --- |
| **item** | `item_id`\*, `item_name`\*, `quantity`\*, `category`, `price`, `currency`, `impression_type`, `impression_id` | Um único produto ou item |
| **lista\_de\_itens** | Lista - | Matriz de objetos de itens (mínimo 1) |
| **carrinho** | `cart_id`\*, `item_list`\*, `total_value`, `currency` | Carrinho de compras |
| **ordem** | `order_id`\*, `item_list`\*, `total_value`, `currency`, `payment_method`, `shipping_address`, `discount` | Um pedido concluído |
| **pesquisa** | `search_query`\*, `total_matching_results`, `results_per_page`, `filter_expression`, `sort_criteria` | Uma ação de pesquisa |
| **formulário** | `form_id`\*, `form_name`, `form_length`, `validation_errors`, `fields_completed` | Uma interação de formulário |
| **pergaminho** | `depth_percentage`, `position_x`, `position_y` | Posição de rolagem (pelo menos um campo obrigatório) |
| **valor\_evento** | número | Valor numérico que representa a importância de um evento |
\* Campo obrigatório
### Etapas de integração e exemplos de uso
Depois de ligar`amazon_connect.Web.ClickStream.init()`, adicione `recordBusinessMetric()` chamadas nos gerenciadores de eventos do seu site (por exemplo, onclick).
**Exemplo — Adicionar ao carrinho**
```
await amazon_connect.Web.ClickStream.recordBusinessMetric('add_to_cart', {
item: {
item_id: 'prod-123',
item_name: 'Wireless Headphones',
price: 49.99,
quantity: 1,
currency: 'USD'
}
});
```
**Exemplo — Exibir itens**
```
await amazon_connect.Web.ClickStream.recordBusinessMetric('view_items', {
item_list: [
{
item_id: 'item_10',
quantity: 1,
item_name: 'Premium Wireless Headphones',
category: 'Electronics',
price: 89.99,
currency: 'USD'
}
]
});
```
### Tipos de eventos reservados
Os seguintes tipos de eventos são reservados com esquemas predefinidos:
| **Tipo de evento** | **Objeto obrigatório** | **Descrição** |
| --- | --- | --- |
| `add_to_cart` | item | Rastreia quando um visitante adiciona um item ao carrinho |
| `purchase` | ordem | Rastreia uma compra concluída |
| `view_items` | lista\_de\_itens | Rastreia quando um visitante visualiza um ou mais itens |
### Eventos personalizados
Além dos tipos de eventos reservados, você pode definir qualquer string de tipo de evento personalizado (por exemplo, `clear_cart` ou`wishlist_add`). Para eventos personalizados:
+ O serviço não impõe uma validação estrita na estrutura do evento.
+ Você pode usar qualquer combinação de campos dos esquemas de objetos acima para se adequar ao seu caso de uso.
+ Use nomes de campo exatamente como mostrados (por exemplo`cart_id`, não`cartId`).
```
await amazon_connect.Web.ClickStream.recordBusinessMetric('clear_cart', {
cart_id: 'cart-123',
item_list: [
{ item_id: 'p1', item_name: 'Widget', quantity: 1 }
]
});
```
## Associe o clickstream a usuários autenticados
Os dados de fluxo de cliques capturados pelo rastreador de dados da web são transmitidos continuamente para os perfis do cliente e associados ao perfil do visitante. A tabela a seguir descreve como essa associação se comporta para visitantes anônimos e autenticados.
| **Tipo de visitante** | **Comportamento de associação de perfil** |
| --- | --- |
| Visitante anônimo | Rastreado somente pelo identificador da sessão. Os dados comportamentais são capturados, mas não vinculados a uma identidade conhecida do cliente. Nenhuma informação de identificação pessoal é coletada. |
| Visitante autenticado | Quando você passa uma ID de usuário autenticada durante a inicialização do widget, o serviço vincula toda a atividade de clickstream ao perfil conhecido desse usuário nos Perfis de clientes. Isso permite uma personalização mais rica e condições de acionamento mais precisas. |
Para associar o rastreamento a um usuário autenticado, use uma das seguintes abordagens:
+ **(Recomendado) Use a declaração CustomerId JWT** — Se você ativou a segurança em seu widget de comunicação, inclua o ID do usuário autenticado no `CustomerId` campo de suas declarações do JSON Web Token (JWT). Isso vincula a atividade do clickstream ao perfil do usuário sem expor o ID no código do lado do cliente. Para obter detalhes de configuração, consulte[Etapa 3: confirmar e copiar o código e as chaves de segurança do widget de comunicação](add-chat-to-website.md#confirm-and-copy-chat-widget-script).
+ **Passe o ID do usuário durante a inicialização** — Se a segurança não estiver ativada em seu widget, passe o ID do usuário autenticado como argumento ao inicializar o rastreador:
```
await window.amazon_connect.Web.ClickStream.init('');
```
**Importante**
Se uma ID de usuário autenticada for passada, ela será vinculada aos perfis existentes por meio da chave da conta. Como os eventos do rastreador de dados se acumulam com o tempo, `_webAnalytics` defina limites de objetos `WebAnalytics-Clickstream` e evite que novos eventos substituam outros tipos de objetos quando o limite de objetos do perfil for atingido. Para obter orientação de configuração, consulte [Limites de dados de perfis de clientes](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-data-limits.html).
## O que é capturado
Para ver a lista completa das atividades que o rastreador captura por padrão, consulte. [O que o rastreador de dados da web captura](customer-profiles-web-tracker-and-notification.md#web-tracker-what-is-captured)
## Privacidade e consentimento
O rastreador de dados da web é opcional por design. Se você não ativar a **coleta de dados** no widget de comunicações, nenhum dado de fluxo de cliques será capturado. Os valores dos campos do formulário, as senhas e as informações de pagamento nunca são coletados automaticamente, mesmo quando os eventos de envio do formulário são monitorados.
**Importante**
Você é responsável por obter o consentimento adequado do visitante antes de inicializar o rastreamento de dados, de acordo com sua política de privacidade e os regulamentos aplicáveis, como o Regulamento Geral de Proteção de Dados (GDPR) e a Lei de Privacidade do Consumidor da Califórnia (CCPA).