Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Cattura l'attività dei visitatori del sito web con il web data tracker
Il web data tracker rileva il modo in cui i visitatori interagiscono con il tuo sito web: elementi cliccati, ricerche effettuate, invio di moduli. Associa tale attività al loro profilo nei profili dei clienti. Il tracker fa parte del widget Comunicazioni ed è controllato a livello di widget. Per una panoramica del funzionamento congiunto del web data tracker e della notifica web, consulta. [Monitoraggio dei dati Web e notifica Web](customer-profiles-web-tracker-and-notification.md)
## Prerequisiti
+ Un'istanza Connect Customer con il widget Communications configurato. Per ulteriori informazioni, consulta [Aggiungi un'interfaccia utente di chat al tuo sito web ospitato da Connect Customer](add-chat-to-website.md).
+ Profili cliente abilitati sull'istanza. Per ulteriori informazioni, consulta [Abilita i profili cliente per la tua istanza Connect Customer](enable-customer-profiles.md).
## Passaggio 1: abilitare la raccolta dei dati nel widget Comunicazioni
1. Accedi al sito web Connect Customer di amministrazione.
1. Nel menu di navigazione, scegli **Canali**, quindi scegli **Widget di comunicazione**.
1. Crea un nuovo widget o modificane uno esistente. Per ulteriori informazioni, consulta [Aggiungi un'interfaccia utente di chat al tuo sito web ospitato da Connect Customer](add-chat-to-website.md).
1. Abilita la **raccolta dei dati** per attivare il tracciamento dei clickstream.
1. (Facoltativo) Le impostazioni di **raccolta dati** includono un'opzione per la raccolta **avanzata dei dati**. Attivala in modo che il servizio raccolga automaticamente le interazioni dei visitatori con i contenuti HTML, il che produce informazioni predittive più ricche e accurate.
1. (Facoltativo) Abilita la **notifica Web** se prevedi di inviare notifiche proattive da questo widget. Per ulteriori informazioni, consulta [Invia notifiche web con le campagne in uscita di Connect Customer](outbound-campaigns-web-notification.md).
1. Aggiungi i domini del sito Web in cui verrà incorporato il widget all'elenco dei domini consentiti.
1. Salva il widget e copia il codice dello snippet del widget. Incorpora questo frammento nel tuo sito web nel passaggio successivo.
## Passaggio 2: incorpora il widget e inizializza il tracciamento
Incorpora lo snippet del widget nel codice HTML del tuo sito web. Dopo il caricamento dello snippet, inizializza il tracker dopo aver ottenuto il consenso del visitatore.
```
// 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**
Inizializza il tracciamento solo dopo aver ottenuto il consenso appropriato del visitatore in conformità con la tua politica sulla privacy e le normative applicabili.
**Nota**
Per le applicazioni a pagina singola, incorpora lo snippet una volta nella pagina di primo livello. Per le applicazioni multipagina, incorpora lo snippet in ogni pagina in cui desideri registrare l'attività.
## Fase 3: (Facoltativo) Tieni traccia degli eventi specifici dell'azienda
Per registrare eventi aziendali personalizzati, come il completamento degli acquisti, le azioni aggiunte al carrello o le visualizzazioni dei prodotti, chiama `recordBusinessMetric` dal tuo sito Web JavaScript quando si verifica l'evento.
**Importante**
Se prevedi di utilizzare il data tracker con consiglieri che richiedono contesti di articoli come `Find Similar Items` e`Frequently Paired Items`, ad esempio, devi utilizzare eventi specifici dell'azienda e includere il campo. `item_id`
### Firma del metodo
```
await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)
```
| **Parameter** | **Tipo** | **Descrizione** |
| --- | --- | --- |
| `eventType` | stringa | Il nome dell'evento aziendale: un tipo riservato o qualsiasi stringa personalizzata. |
| `eventPayload` | oggetto | I dati degli eventi sono strutturati utilizzando gli schemi a oggetti riportati di seguito. |
### Schemi di oggetti
`eventPayload`Supporta i seguenti oggetti. Usa qualsiasi combinazione di campi per adattarla al tuo caso d'uso.
| **Oggetto** | **Campi chiave** | **Descrizione** |
| --- | --- | --- |
| **elemento** | `item_id`\*, `item_name`\*, `quantity`\*, `category`, `price`, `currency`, `impression_type`, `impression_id` | Un singolo prodotto o articolo |
| **elenco\_articoli** | Elenco - | Matrice di oggetti oggetto (minimo 1) |
| **carrello** | `cart_id`\*, `item_list`\*, `total_value`, `currency` | Carrello della spesa |
| **ordine** | `order_id`\*, `item_list`\*, `total_value`, `currency`, `payment_method`, `shipping_address`, `discount` | Un ordine completato |
| **cerca** | `search_query`\*, `total_matching_results`, `results_per_page`, `filter_expression`, `sort_criteria` | Un'azione di ricerca |
| **modulo** | `form_id`\*, `form_name`, `form_length`, `validation_errors`, `fields_completed` | Un'interazione tra moduli |
| **pergamena** | `depth_percentage`, `position_x`, `position_y` | Posizione di scorrimento (almeno un campo richiesto) |
| **valore\_evento** | numero | Valore numerico che rappresenta l'importanza di un evento |
\* Campo obbligatorio
### Fasi di integrazione ed esempi di utilizzo
Dopo la chiamata`amazon_connect.Web.ClickStream.init()`, aggiungi `recordBusinessMetric()` le chiamate nei gestori di eventi del tuo sito web (ad esempio, onclick).
**Esempio: aggiungi al carrello**
```
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'
}
});
```
**Esempio: visualizza gli articoli**
```
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'
}
]
});
```
### Tipi di eventi riservati
I seguenti tipi di eventi sono riservati a schemi predefiniti:
| **Tipo di evento** | **Oggetto richiesto** | **Descrizione** |
| --- | --- | --- |
| `add_to_cart` | elemento | Tiene traccia di quando un visitatore aggiunge un articolo al carrello |
| `purchase` | order | Tiene traccia di un acquisto completato |
| `view_items` | item\_list | Tiene traccia della visualizzazione di uno o più elementi da parte di un visitatore |
### Eventi personalizzati
Oltre ai tipi di eventi riservati, è possibile definire qualsiasi stringa di tipo di evento personalizzata (ad esempio `clear_cart` o`wishlist_add`). Per eventi personalizzati:
+ Il servizio non impone una convalida rigorosa sulla struttura dell'evento.
+ Puoi utilizzare qualsiasi combinazione di campi degli schemi di oggetti sopra riportati per adattarla al tuo caso d'uso.
+ Usa i nomi dei campi esattamente come mostrato (ad esempio`cart_id`, no`cartId`).
```
await amazon_connect.Web.ClickStream.recordBusinessMetric('clear_cart', {
cart_id: 'cart-123',
item_list: [
{ item_id: 'p1', item_name: 'Widget', quantity: 1 }
]
});
```
## Associa clickstream a utenti autenticati
I dati clickstream acquisiti dal web data tracker vengono continuamente trasmessi ai profili dei clienti e associati al profilo del visitatore. La tabella seguente descrive come si comporta tale associazione per i visitatori anonimi e autenticati.
| **Tipo di visitatore** | **Comportamento dell'associazione dei profili** |
| --- | --- |
| Visitatore anonimo | Tracciato solo tramite identificatore di sessione. I dati comportamentali vengono acquisiti ma non collegati a un'identità nota del cliente. Non vengono raccolte informazioni di identificazione personale. |
| Visitatore autenticato | Quando trasmetti un ID utente autenticato durante l'inizializzazione del widget, il servizio collega tutte le attività clickstream al profilo noto dell'utente in Customer Profiles. Ciò consente una personalizzazione più ricca e condizioni di attivazione più accurate. |
Per associare il tracciamento a un utente autenticato, utilizza uno dei seguenti approcci:
+ **(Consigliato) Utilizza l'attestazione CustomerId JWT**: se hai abilitato la sicurezza sul widget Comunicazioni, includi l'ID utente autenticato nel `CustomerId` campo delle attestazioni JSON Web Token (JWT). Ciò collega l'attività clickstream al profilo dell'utente senza esporre l'ID nel codice lato client. Per i dettagli sulla configurazione, consulta. [Passaggio 3: confermare e copiare il codice del widget di comunicazione e le chiavi di sicurezza](add-chat-to-website.md#confirm-and-copy-chat-widget-script)
+ **Passa l'ID utente durante l'inizializzazione**: se la sicurezza non è abilitata sul widget, inserisci l'ID utente autenticato come argomento durante l'inizializzazione del tracker:
```
await window.amazon_connect.Web.ClickStream.init('');
```
**Importante**
Se viene passato un ID utente autenticato, si collega ai profili esistenti tramite la chiave dell'account. Poiché gli eventi del data tracker si accumulano nel tempo, impostate dei limiti per gli oggetti `WebAnalytics-Clickstream` e per `_webAnalytics` evitare che nuovi eventi sovrascrivano altri tipi di oggetti una volta raggiunto il limite di oggetti del profilo. Per indicazioni sulla configurazione, consulta i limiti [dei dati dei profili dei clienti](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-data-limits.html).
## Cosa viene catturato
Per l'elenco completo delle attività acquisite di default dal tracker, consulta. [Cosa acquisisce il web data tracker](customer-profiles-web-tracker-and-notification.md#web-tracker-what-is-captured)
## Privacy e consenso
Il web data tracker è abilitato fin dalla progettazione. Se non si abilita la **raccolta dati** nel widget Comunicazioni, non viene acquisito alcun dato clickstream. I valori dei campi del modulo, le password e le informazioni di pagamento non vengono mai raccolti automaticamente, anche quando gli eventi di invio del modulo vengono tracciati.
**Importante**
È tua responsabilità ottenere il consenso appropriato dei visitatori prima di inizializzare il tracciamento dei dati, in conformità con la tua politica sulla privacy e le normative applicabili come il Regolamento generale sulla protezione dei dati (GDPR) e il California Consumer Privacy Act (CCPA).