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
-
Una instancia de Connect Customer con el widget de comunicaciones configurado. Para obtener más información, consulte Añada una interfaz de usuario de chat a su sitio web alojado por Connect Customer.
-
Perfiles de clientes habilitados en la instancia. Para obtener más información, consulte Habilite los perfiles de cliente para su instancia de Connect Customer.
Paso 1: Habilitar la recopilación de datos en el widget de comunicaciones
-
Inicie sesión en el sitio web Connect Customer de administración.
-
En el menú de navegación, selecciona Canales y, a continuación, selecciona Widgets de comunicaciones.
-
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.
-
Activa la recopilación de datos para activar el seguimiento del flujo de clics.
-
(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.
-
(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.
-
Agregue los dominios del sitio web en los que se insertará el widget a la lista de dominios permitidos.
-
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 |
|---|---|---|
|
cadena |
El nombre del evento empresarial: un tipo reservado o cualquier cadena personalizada. |
|
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 |
|
Un solo producto o artículo |
item_list |
Lista <item> |
Matriz de objetos de elementos (mínimo 1) |
carrito |
|
Carrito de compras |
pedido |
|
Un pedido completado |
search |
|
Una acción de búsqueda |
formulario |
|
Una interacción de formulario |
pergamino |
|
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 |
|---|---|---|
|
elemento |
Realiza un seguimiento de cuándo un visitante añade un artículo a su carrito |
|
orden |
Realiza un seguimiento de una compra completada |
|
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 ejemplo
cart_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
CustomerIdcampo 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).