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à.
# Registra 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 modo in cui il web data tracker e la notifica web funzionano insieme, 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 ** dati ** per attivare il tracciamento dei clickstream.
1. (Facoltativo) Le ** impostazioni di raccolta ** dati includono un'opzione per la raccolta ** avanzata dei dati. ** Attiva questa opzione in modo che il servizio raccolga automaticamente le interazioni dei visitatori con i contenuti HTML, producendo informazioni predittive più ricche e accurate.
1. (Facoltativo) Attiva 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 il widget verrà incorporato 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 con più pagine, incorpora lo snippet in ogni pagina in cui desideri catturare l'attività.
## Fase 3: (Facoltativo) Tieni traccia degli eventi specifici dell'azienda
Per registrare eventi aziendali personalizzati, ad esempio completamenti di acquisti, azioni di aggiunta al carrello o visualizzazioni di prodotti, chiama `recordBusinessMetric` dal tuo sito Web JavaScript quando si verifica l'evento.
**Importante**
Se prevedi di utilizzare il data tracker con consigli che richiedono i contesti degli articoli, ad esempio `Find Similar Items` e`Frequently Paired Items`, 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 una stringa personalizzata. |
| `eventPayload` | oggetto | Dati degli eventi strutturati utilizzando gli schemi degli 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 |
| **item\_list ** | 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 forme |
| **scorri ** | `depth_percentage`, `position_x`, `position_y` | Posizione di scorrimento (almeno un campo obbligatorio) |
| **event\_value ** | 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 con schemi predefiniti:
| **Tipo di evento** | **Oggetto obbligatorio ** | **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 di quando un visitatore visualizza uno o più elementi |
### Eventi personalizzati
Oltre ai tipi di eventi riservati, puoi 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 al profilo del cliente
I dati clickstream acquisiti dal web data tracker vengono trasmessi continuamente ai profili dei clienti. Il modo in cui i dati vengono associati a un profilo dipende dal fatto che le chiavi del profilo vengano fornite durante l'inizializzazione del widget.
| **Tipo di visitatore ** | **Comportamento dell'associazione del profilo ** |
| --- | --- |
| Visitatore senza chiavi di profilo (anonimo) | Tracciato da un identificatore anonimo memorizzato in un cookie del browser che scade dopo 7 giorni. Durante questo periodo, i dati clickstream dello stesso visitatore sono collegati a un unico profilo anonimo. Dopo la scadenza del cookie, viene generato un nuovo identificatore anonimo e l'attività successiva viene tracciata in un nuovo profilo. Non vengono raccolte informazioni di identificazione personale.
Se le chiavi del profilo vengono fornite durante l'inizializzazione del widget, i dati clickstream vengono collegati al profilo noto corrispondente anziché al profilo anonimo. |
| Visitatore con chiavi del profilo | Quando si passano le chiavi del profilo durante l'inizializzazione del widget, il servizio collega tutte le attività di clickstream al profilo noto di quell'utente nei profili dei clienti. Ciò consente una personalizzazione più completa e condizioni di attivazione più accurate. |
### Collega gli eventi di analisi web ai profili esistenti
Per associare il tracciamento a un profilo noto, impostate `profileKeys` nelle vostre dichiarazioni JWT la ricerca e l'associazione a un profilo esistente al momento della connessione. Il servizio utilizza queste chiavi per trovare un profilo corrispondente tramite l'`SearchProfiles`API. Ciò richiede che la sicurezza sia abilitata nel widget di comunicazione. 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).
```
{
"sub": "",
"iat": 1234567890,
"exp": 1234571490,
"profileKeys": {
"_email": "user@example.com",
"_account": "ACCT-12345"
},
"profileKeysOperator": "OR"
}
```
+ `profileKeys`— Un oggetto chiave-valore in cui ogni chiave è un identificatore di Customer Profiles ricercabile (ad esempio, `_email``_phone`,`_account`) e il valore è il valore di ricerca.
+ `profileKeysOperator`(opzionale) — `"AND"` o `"OR"` (impostazione predefinita:). `"OR"` Determina se il profilo deve corrispondere a tutte le chiavi o a qualsiasi chiave.
+ Se viene trovato esattamente un profilo, questo viene associato alla sessione.
+ Se non viene trovato alcun profilo, la sessione procede in modo anonimo (è possibile creare un nuovo profilo in un secondo momento).
+ Se vengono trovati più profili, `window.amazon_connect.Web.ClickStream.init()` restituisce un errore. Modifica la selezione delle chiavi per garantire l'unicità.
**Imposta dei limiti al numero di oggetti per evitare problemi di sfratto**
In caso di collegamento a un profilo esistente, consigliamo di impostare i tipi di `MaxProfileObjectCount` oggetto `WebAnalytics-Clickstream` e`_webAnalytics`. Questi oggetti evento di data tracker si accumulano nel tempo. Senza questa impostazione, il servizio non li considera idonei all'eliminazione quando un profilo raggiunge il limite di oggetti. Per ulteriori informazioni sui limiti dei dati, consulta Limiti di dati [ dei profili dei clienti. ](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-data-limits.html)
### Raggruppamento degli eventi in base a un identificatore personalizzato
Se non hai bisogno di collegarti a un profilo esistente ma desideri raggruppare le attività clickstream per conto tuo, puoi fornire un identificatore personalizzato. Gli eventi clickstream che condividono lo stesso identificatore sono raggruppati sotto una chiave di profilo comune. `_webAnalyticsUserId`
Esistono due modi per fornirlo:
+ **Tramite JWT claims**: imposta il `customerId` campo nei claim JWT (richiede la sicurezza abilitata).
+ **Tramite inizializzazione**: passate l'identificatore come argomento durante l'inizializzazione del tracker:
```
// Pass the custom user id as a positional string argument.
await window.amazon_connect.Web.ClickStream.init('');
```
**Nota**
Se `profileKeys` vengono forniti anche questi dati e si risolvono in un profilo esistente, la risoluzione del profilo utilizza tale risultato e salta questo identificatore personalizzato.
## Cosa viene catturato
Per l'elenco completo delle attività acquisite dal tracker per impostazione predefinita, 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 è predisposto per impostazione predefinita. Se non abiliti la raccolta ** ** dei 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 vengono tracciati gli eventi di invio del modulo.
**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 General Data Protection Regulation (GDPR) e il California Consumer Privacy Act (CCPA).