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, consulteRastreador de dados da web e notificação na web.
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.
-
Perfis de clientes ativados na instância. Para obter mais informações, consulte Ative perfis de clientes para sua instância Connect Customer.
Etapa 1: Ativar a coleta de dados no widget de comunicações
-
Faça login no site do Connect Customer administrador.
-
No menu de navegação, escolha Canais e, em seguida, escolha Widgets de comunicação.
-
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.
-
Ative a coleta de dados para ativar o rastreamento do fluxo de cliques.
-
(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.
-
(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.
-
Adicione os domínios do site em que o widget será incorporado à lista de domínios permitidos.
-
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 eFrequently 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 |
|---|---|---|
|
string |
O nome do evento comercial — um tipo reservado ou qualquer sequência de caracteres personalizada. |
|
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 |
|
Um único produto ou item |
lista_de_itens |
Lista <item> |
Matriz de objetos de itens (mínimo 1) |
carrinho |
|
Carrinho de compras |
ordem |
|
Um pedido concluído |
pesquisa |
|
Uma ação de pesquisa |
formulário |
|
Uma interação de formulário |
pergaminho |
|
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 ligaramazon_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 |
|---|---|---|
|
item |
Rastreia quando um visitante adiciona um item ao carrinho |
|
ordem |
Rastreia uma compra concluída |
|
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 ouwishlist_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ãocartId).
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
CustomerIdcampo 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, consulteEtapa 3: confirmar e copiar o código e as chaves de segurança do widget de comunicação. -
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('<authenticated-user-id>');
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.
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
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).