Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Capture la actividad de los visitantes del sitio web con el rastreador de datos web

El rastreador de datos web captura la forma en que los visitantes interactúan con su sitio web: los artículos en los que hacen clic, las búsquedas realizadas y el envío de formularios. Asocia esa actividad con su perfil en los perfiles de los clientes. El rastreador forma parte del widget de comunicaciones y se controla a nivel de widget. Para obtener una descripción general de cómo funcionan conjuntamente el rastreador de datos web y las notificaciones web, consulteRastreador de datos web y notificación web.

Requisitos previos

Paso 1: Habilita la recopilación de datos en el widget de comunicaciones

Paso 2: incrusta el widget e inicializa el seguimiento

Inserta el fragmento del widget en el HTML de tu sitio web. Cuando se cargue el fragmento, inicialice el rastreador una vez que haya obtenido el consentimiento del 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();

Paso 3: (opcional) Realiza un seguimiento de los eventos específicos de la empresa

Para capturar eventos empresariales personalizados, como la finalización de compras, las acciones de añadir al carrito o las visualizaciones de productos, llama recordBusinessMetric desde tu sitio web JavaScript cuando se produzca el evento.

Firma del método

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

Esquemas de objetos

eventPayloadSoporta los siguientes objetos. Usa cualquier combinación de campos que se adapte a tu caso de uso.

* Campo obligatorio

Pasos de integración y ejemplos de uso

Después de llamaramazon_connect.Web.ClickStream.init(), añada recordBusinessMetric() llamadas en los controladores de eventos de su sitio web (por ejemplo, onclick).

Ejemplo: añadir al carrito

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'
    }
});

Ejemplo: ver artículos

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

Los siguientes tipos de eventos están reservados con esquemas predefinidos:

Custom Events

Además de los tipos de eventos reservados, puedes definir cualquier cadena de tipo de evento personalizada (por ejemplo, clear_cart owishlist_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 }
    ]
});

Asocie el flujo de clics con el perfil del cliente

Los datos del flujo de clics capturados por el rastreador de datos web se transmiten continuamente a los perfiles de los clientes. La forma en que se asocian los datos a un perfil depende de si se proporcionan las claves de perfil durante la inicialización del widget.

Vincula los eventos de análisis web con los perfiles existentes

Para asociar el seguimiento a un perfil conocido, configura tus profileKeys anuncios de JWT para buscar y asociar un perfil existente en el momento de la conexión, y el servicio utilizará estas claves para encontrar un perfil coincidente a través de la SearchProfiles API. Esto requiere que la seguridad esté habilitada en tu widget de comunicaciones. Para obtener información sobre la configuración, consultePaso 3: confirmar y copiar el código del widget de comunicaciones y las claves de seguridad.

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

Agrupar eventos por un identificador personalizado

Si no necesitas crear un enlace a un perfil existente, pero quieres agrupar la actividad del flujo de clics por tu cuenta, puedes proporcionar un identificador personalizado. Los eventos de Clickstream que comparten el mismo identificador se agrupan en una clave de _webAnalyticsUserId perfil común.

Hay dos maneras de proporcionarlo:

¿Qué se captura

Para ver la lista completa de las actividades que el rastreador captura de forma predeterminada, consulteQué captura el rastreador de datos web.

Privacidad y consentimiento

El rastreador de datos web es opcional por diseño. Si no habilitas la recopilación de datos en el widget de comunicaciones, no se capturará ningún dato del flujo de clics. Los valores de los campos del formulario, las contraseñas y la información de pago nunca se recopilan automáticamente, ni siquiera cuando se realiza un seguimiento de los eventos de envío del formulario.