View a markdown version of this page

Capture la actividad de los visitantes del sitio web con el rastreador de datos web - Amazon Connect Customer

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 elementos en los que han hecho clic, las búsquedas realizadas o 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 del widget. Para obtener una descripción general de cómo funcionan juntos el rastreador de datos web y las notificaciones web, consulteRastreador de datos web y notificación web.

Requisitos previos

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

  1. Inicie sesión en el sitio web Connect Customer de administración.

  2. En el menú de navegación, selecciona Canales y, a continuación, selecciona Widgets de comunicaciones.

  3. Crea un widget nuevo o edita uno existente. Para obtener más información, consulte Añada una interfaz de usuario de chat a su sitio web alojado por Connect Customer.

  4. Activa la recopilación de datos para activar el seguimiento del flujo de clics.

  5. (Opcional) La configuración de recopilación de datos incluye una opción para la recopilación avanzada de datos. Actívela para que el servicio recopile automáticamente las interacciones de los visitantes con el contenido HTML, lo que generará información predictiva más detallada y precisa.

  6. (Opcional) Habilite la notificación web si planea enviar notificaciones proactivas desde este widget. Para obtener más información, consulte Envía notificaciones web con las campañas salientes de Connect Customer.

  7. Agregue los dominios del sitio web en los que se insertará el widget a la lista de dominios permitidos.

  8. Guarde el widget y copie el código del fragmento del widget. Inserta este fragmento en tu sitio web en el siguiente paso.

Paso 2: incrusta el widget e inicializa el seguimiento

Inserta el fragmento del widget en el HTML de tu sitio web. Una vez que 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();
importante

Inicie el seguimiento solo después de obtener el consentimiento correspondiente del visitante, de conformidad con su política de privacidad y la normativa aplicable.

nota

En el caso de las aplicaciones de una sola página, inserte el fragmento una vez en la página de nivel superior. Para aplicaciones de varias páginas, incruste el fragmento en todas las páginas en las que desee capturar la actividad.

Paso 3: (opcional) Realice 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 visitas a productos, llama recordBusinessMetric desde tu sitio web JavaScript cuando se produzca el evento.

importante

Si planeas usar el rastreador de datos con recomendadores que requieren contextos de artículos como Find Similar Items yFrequently Paired Items, debes usar eventos específicos de la empresa e incluir el campo. item_id

Firma del método

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

Parámetro

Tipo

Descripción

eventType

cadena

El nombre del evento empresarial: un tipo reservado o cualquier cadena personalizada.

eventPayload

objeto

Los datos del evento se estructuraron mediante los siguientes esquemas de objetos.

Esquemas de objetos

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

Objeto

Campos clave

Descripción

elemento

item_id*, item_name*, quantity*, category, price, currency, impression_type, impression_id

Un solo producto o artículo

item_list

Lista <item>

Matriz de objetos de elementos (mínimo 1)

carrito

cart_id*, item_list*, total_value, currency

Carrito de compras

pedido

order_id*, item_list*, total_value, currency, payment_method, shipping_address, discount

Un pedido completado

search

search_query*, total_matching_results, results_per_page, filter_expression, sort_criteria

Una acción de búsqueda

formulario

form_id*, form_name, form_length, validation_errors, fields_completed

Una interacción de formulario

pergamino

depth_percentage, position_x, position_y

Posición de desplazamiento (se requiere al menos un campo)

valor_evento

número

Valor numérico que representa la importancia de un evento

* Campo obligatorio

Pasos de integración y ejemplos de uso

Después de llamaramazon_connect.Web.ClickStream.init(), añada recordBusinessMetric() las llamadas a 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:

Tipo de evento

Objeto obligatorio

Descripción

add_to_cart

elemento

Realiza un seguimiento de cuándo un visitante añade un artículo a su carrito

purchase

orden

Realiza un seguimiento de una compra completada

view_items

item_list

Realiza un seguimiento de cuándo un visitante ve uno o más elementos

Custom Events

Además de los tipos de eventos reservados, puede definir cualquier cadena de tipo de evento personalizada (por ejemplo, clear_cart owishlist_add). Para eventos personalizados:

  • El servicio no exige una validación estricta de la estructura del evento.

  • Puedes usar cualquier combinación de campos de los esquemas de objetos anteriores para adaptarla a tu caso de uso.

  • Use los nombres de los campos exactamente como se muestran (por ejemplocart_id, nocartId).

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 los usuarios autenticados

Los datos de flujo de clics capturados por el rastreador de datos web se transmiten continuamente a los perfiles de los clientes y se asocian al perfil del visitante. En la siguiente tabla se describe cómo se comporta esa asociación en el caso de los visitantes anónimos y autenticados.

Tipo de visitante

Comportamiento de asociación de perfiles

Visitante anónimo

Se rastrea únicamente mediante el identificador de sesión. Los datos de comportamiento se recopilan pero no se vinculan a la identidad de un cliente conocido. No se recopila información de identificación personal.

Visitante autenticado

Al pasar un seudónimo autenticado durante la inicialización del widget, el servicio vincula toda la actividad del flujo de clics al perfil conocido de ese usuario en los perfiles de cliente. Esto permite una personalización más completa y condiciones de activación más precisas.

Para asociar el seguimiento a un usuario autenticado, utilice uno de los siguientes enfoques:

  • (Recomendado) Utiliza la afirmación de CustomerId JWT: si has activado la seguridad en tu widget de comunicaciones, incluye el ID de usuario autenticado en el CustomerId campo de tus notificaciones sobre el JSON Web Token (JWT). Esto vincula la actividad del flujo de clics con el perfil del usuario sin exponer el ID en el código del lado del cliente. Para obtener más información sobre la configuración, consulte. Paso 3: confirmar y copiar el código del widget de comunicaciones y las claves de seguridad

  • Pase el ID de usuario durante la inicialización: si la seguridad no está habilitada en su widget, pase el ID de usuario autenticado como argumento al inicializar el rastreador:

    await window.amazon_connect.Web.ClickStream.init('<authenticated-user-id>');
importante

Si se transfiere un seudónimo autenticado, se vincula a los perfiles existentes mediante la clave de cuenta. Como los eventos del rastreador de datos se acumulan con el tiempo, establezca límites de objetos WebAnalytics-Clickstream y evite _webAnalytics que los nuevos eventos sobrescriban a otros tipos de objetos una vez alcanzado el límite de objetos del perfil. Para obtener instrucciones de configuración, consulte los límites de datos de los perfiles de clientes.

¿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 está diseñado de forma opcional. Si no habilita 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, incluso cuando se realiza un seguimiento de los eventos de envío del formulario.

importante

Usted es responsable de obtener el consentimiento adecuado de los visitantes antes de iniciar el seguimiento de datos, de conformidad con su política de privacidad y las normas aplicables, como el Reglamento General de Protección de Datos (GDPR) y la Ley de Privacidad del Consumidor de California (CCPA).