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

Prerequisiti

Passaggio 1: abilitare la raccolta dei dati nel widget Comunicazioni

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();

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.

Firma del metodo

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

Schemi di oggetti

eventPayloadSupporta i seguenti oggetti. Usa qualsiasi combinazione di campi per adattarla al tuo caso d'uso.

* 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 con schemi predefiniti:

Eventi personalizzati

Oltre ai tipi di eventi riservati, puoi definire qualsiasi stringa di tipo di evento personalizzata (ad esempio, clear_cart owishlist_add). Per eventi personalizzati:

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.

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'SearchProfilesAPI. Ciò richiede che la sicurezza sia abilitata nel widget di comunicazione. Per i dettagli sulla configurazione, consultaPassaggio 3: confermare e copiare il codice del widget di comunicazione e le chiavi di sicurezza.

{
  "sub": "<widgetId>",
  "iat": 1234567890,
  "exp": 1234571490,
  "profileKeys": {
    "_email": "user@example.com",
    "_account": "ACCT-12345"
  },
  "profileKeysOperator": "OR"
}

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:

Cosa viene catturato

Per l'elenco completo delle attività acquisite dal tracker per impostazione predefinita, consulta. Cosa acquisisce il web data tracker

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.