View a markdown version of this page

Capture a atividade dos visitantes do site com o rastreador de dados da web - Amazon Connect Customer

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

Etapa 1: Ativar a coleta de dados no widget de comunicações

  1. Faça login no site do Connect Customer administrador.

  2. No menu de navegação, escolha Canais e, em seguida, escolha Widgets de comunicação.

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

  4. Ative a coleta de dados para ativar o rastreamento do fluxo de cliques.

  5. (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.

  6. (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.

  7. Adicione os domínios do site em que o widget será incorporado à lista de domínios permitidos.

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

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

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

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 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 exemplocart_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 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, 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).