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ções 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: habilitar a coleta de dados no widget de comunicações

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();

Etapa 3: (opcional) Acompanhe eventos específicos da empresa

Para capturar eventos comerciais personalizados, como conclusão de compras, ações de adição ao carrinho ou visualizações de produtos, ligue recordBusinessMetric do seu site JavaScript quando o evento ocorrer.

Assinatura do método

await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)

Esquemas de objetos

O eventPayload suporta os seguintes objetos. Use qualquer combinação de campos para se adequar ao seu caso de uso.

* Campo obrigatório

Etapas de integração e exemplos de uso

Depois de ligaramazon_connect.Web.ClickStream.init(), adicione recordBusinessMetric() chamadas nos manipuladores 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:

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:

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 ao perfil do cliente

Os dados de sequência de cliques capturados pelo rastreador de dados da web são transmitidos continuamente para os perfis dos clientes. A forma como os dados são associados a um perfil depende de as chaves de perfil serem fornecidas durante a inicialização do widget.

Vincule eventos de análise da web a perfis existentes

Para associar o rastreamento a um perfil conhecido, defina profileKeys em suas reivindicações do JWT para pesquisar e associar a um perfil existente no momento da conexão, e o serviço usa essas chaves para encontrar um perfil correspondente por meio da SearchProfiles API. Isso exige que a segurança esteja ativada em seu widget de comunicações. 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.

{
  "sub": "<widgetId>",
  "iat": 1234567890,
  "exp": 1234571490,
  "profileKeys": {
    "_email": "user@example.com",
    "_account": "ACCT-12345"
  },
  "profileKeysOperator": "OR"
}

Agrupando eventos por um identificador personalizado

Se você não precisar se vincular a um perfil existente, mas quiser agrupar a atividade de sequência de cliques por conta própria, forneça um identificador personalizado. Os eventos de sequência de cliques que compartilham o mesmo identificador são agrupados em uma chave de perfil comum_webAnalyticsUserId.

Há duas maneiras de fornecê-lo:

O que é capturado

Para ver a lista completa de 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 sequência de cliques será capturado. Valores de campos de formulários, senhas e informações de pagamento nunca são coletados automaticamente, mesmo quando os eventos de envio de formulários são monitorados.