View a markdown version of this page

Cattura l'attività dei visitatori del sito web con il web data tracker - Cliente Amazon Connect
PrerequisitiPassaggio 1: abilitare la raccolta dei dati nel widget ComunicazioniPassaggio 2: incorpora il widget e inizializza il tracciamentoFase 3: (Facoltativo) Tieni traccia degli eventi specifici dell'aziendaAssocia clickstream a utenti autenticatiCosa viene catturatoPrivacy e consenso

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

Prerequisiti

Passaggio 1: abilitare la raccolta dei dati nel widget Comunicazioni

  1. Accedi al sito web Connect Customer di amministrazione.

  2. Nel menu di navigazione, scegli Canali, quindi scegli Widget di comunicazione.

  3. 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.

  4. Abilita la raccolta dei dati per attivare il tracciamento dei clickstream.

  5. (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.

  6. (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.

  7. Aggiungi i domini del sito Web in cui verrà incorporato il widget all'elenco dei domini consentiti.

  8. 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 eFrequently 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

eventPayloadSupporta 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 <item>

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 chiamataamazon_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 owishlist_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 esempiocart_id, nocartId).

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

  • 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('<authenticated-user-id>');
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.

Cosa viene catturato

Per l'elenco completo delle attività acquisite di default dal tracker, consulta. Cosa acquisisce il web data tracker

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).