Traccia gli utenti autenticati con Oracle Infinity sul Web

Introduzione

Questa esercitazione illustrerà come tenere traccia degli utenti autenticati sul sito Web utilizzando Oracle Infinity con il tag Oracle CX aggiungendo parametri di tracciamento a livello di utente alle chiamate di tracciamento. Ad esempio, la dichiarazione di un ID cliente per un utente consente di assegnare i ricavi per utente per un sito Web di e-commerce o di attivare Azioni per i visitatori autenticati.

Obiettivi

Gli obiettivi dell'esercitazione sono i seguenti:

Prerequisiti

Di seguito sono riportati i prerequisiti per questa esercitazione.

Crea una tag (per la tag Oracle CX)

È necessario aver creato e configurato un tag per il sito Web:

Hai già un tag Oracle CX sul tuo sito Web?

Se si è già creato un tag in uso sul sito Web, non è necessario crearne uno specifico per questo caso d'uso. È necessario assicurarsi che (a) la tag esistente sia già stata implementata nelle pagine richieste oppure (b) sia necessario creare una nuova tag e eseguire l'implementazione nelle pagine richieste.

Passo 1: Implementare il tag Oracle CX nella pagina o nelle pagine

Se non è già stata implementata la tag CX nelle pagine desiderate, sarà necessario aggiungerla alle pagine per caricare la libreria di tag CX in modo da poter avviare le richieste di registrazione a Oracle Infinity.

  1. Dovresti avere un URL tag in base ai prerequisiti che utilizzeranno il seguente formato:

    //c.oracleinfinity.io/acs/account/{YOUR_ACCOUNT_GUID}/js/{YOUR_TAG_ID}/odc.js?_ora.config={_ora.config}

    GUID account, ID tag e configurazione

    {Account GUID} identifica l'account. Tutti i tag utilizzeranno lo stesso GUID account in modo che tutti i dati raccolti per l'account vengano memorizzati insieme.

    {Tag ID} consente di assegnare i diritti di accesso alle tag Oracle Infinity e di inserirli in formato gerarchico.

    {_ora.config} indica l'ambiente a cui la tag punta (ad esempio, analytics:test consente di puntare verso configurazioni di tag diverse per Ambiente, ad esempio Test e Produzione). Per maggiori dettagli, vedere Ambienti.

  2. Implementare il seguente blocco di codice nel file <head>* di tutte le pagine che verranno tracciate (sostituzione di {Account GUID}, {Tag ID} e {_ora.config} in base all'URL tag). Ad esempio:

    Implementazione sincrona

    <head>
...
<!-- CX Tag - Library Load -->
<script type="text/JavaScript" src="//c.oracleinfinity.io/acs/account/{Account GUID}/js/{Tag ID}/odc.js?_ora.config={_ora.config}"></script>
...
</head>

    Implementazione asincrona

    	<head>
	...
	<script type="text/JavaScript">
	(function() {

	    var accountGUID = "{Account GUID}";
	    var tagID = "{Tag ID}";
	    var config = "{_ora.config}";

	    // DO NOT EDIT BELOW THIS LINE
	    for(var odc_requested=!1,scripts=document.getElementsByTagName("SCRIPT"),s=0;s<scripts.length;s++)scripts[s].src&&/oracleinfinity.*odc\.\js/.test(scripts[s].src)&&(odc_requested=!0);if(!odc_requested){var sc_scripts=document.getElementsByTagName("script")[0],sc=document.createElement("script");if(sc.async=!0,void 0===config)var config="";config&&(config="?_ora.config="+config),sc.src="//c.oracleinfinity.io/acs/account/"+accountGUID+"/js/"+tagID+"/odc.js"+config,sc_scripts.parentNode.insertBefore(sc,sc_scripts)}
	}());
	</script>
	...
	</head>

    *Sincrono o asincrono

    Se si intende utilizzare Oracle Maxymiser, è necessario implementarlo in <head> sincrono in base a quanto indicato in precedenza per assicurarsi che il contenuto della pagina possa essere manipolato prima di essere visibile all'utente. Tuttavia, se non si utilizza Oracle Maxymiser, ciò può essere asincrono e non necessariamente in <head>.

    Se ciò non è possibile, vedere Oracle Maxymiser CX Tag Guidelines o contattare Oracle Consulting Services in merito a un impegno per supportare i requisiti di applicazione di tag per un'implementazione asincrona.

Passo 2: Dichiarazione dei parametri a livello di utente nelle chiamate di tracciamento

Quando un utente ha eseguito l'autenticazione, è possibile aggiungere dettagli relativi alle chiamate di tracciamento nuove o esistenti (ad esempio, è possibile visualizzare l'ID cliente per ogni visitatore autenticato).

Parametri disponibili

È necessario decidere quali parametri si desidera inviare a Oracle Infinity per le aggiunte del carrello.

Di seguito è riportata una tabella dei parametri consigliati che è possibile inviare per gli utenti autenticati.

Parametri a livello utente suggeriti

Parametro Nome parametro Valore di esempio Note
wt.dcsvid ID visitatore esterno CUST123 Vedere di seguito*
wt.customer_id ID cliente CUST123 ID del cliente
wt.email Indirizzo di posta elettronica stevie.nicks@oracle.com Indirizzo e-mail raw
wt.e_id_s Indirizzo e-mail (SHA-256 hash) 9A0FF5B8ADEC41340B433CB2E343DA2DF0DFCBB7447301D97755B6568E41BB8B Indirizzo e-mail con hash SHA-256
wt.e_id_m Indirizzo e-mail (con hash MD5) 0FED850BA5BC6D3A126270F5DFA43C15 Indirizzo e-mail con hash MD5
wt.mobile_phone Numero telefono cellulare +447809839594 Numero di telefono non formattato
wt.riid ID destinatario Responsys (RIID) 564228225 ID destinatario Responsys
wt.customer_type Tipo di cliente Premio Tipo di cliente

*ID visitatore esterno

Questo parametro sostituirà l'ID visitatore predefinito generato da Oracle Infinity per visitatore. Vedere ID visitatore esterno per ulteriori dettagli.

Dichiarazione dei parametri

Dopo aver scelto i parametri, è possibile dichiararli in chiamate nuove o esistenti. Ad esempio:

Chiamata vista di esempio per l'utente autenticato in una home page

(function(){
 
    // Declare Your Parameters
    var cxDataObject = {};
    cxDataObject["wt.page_name"] = "homepage"; // Custom parameter denoting page name
    cxDataObject["wt.customer_id"] = "EXAMPLECUSTOMERID123"; // Customer ID
    cxDataObject["wt.e_id_s"] = "9A0FF5B8ADEC41340B433CB2E343DA2DF0DFCBB7447301D97755B6568E41BB8B"; // SHA-256 hashed email address
    cxDataObject["wt.customer_type"] = "VIP Customer"; // Custom parameter denoting type of customer
     
    // DO NOT EDIT BELOW THIS LINE - ORA.click()
    window.ORA = window.ORA || {productReady: []};
    ORA.productReady.push(['analytics', function(cxDataObject) {return function() {return ORA.click({"data": cxDataObject})}}(cxDataObject)]);
})();

Passo 3: eseguire il test dei parametri dichiarati

Dopo aver dichiarato i parametri a livello utente, è possibile convalidare la richiesta aprendo il Debugger di rete cromatico DevTools:

  1. Aprire il debugger di rete Chrome DevTools.
  2. Assicurarsi di essere autenticati sul sito (o di soddisfare i criteri per la dichiarazione dei nuovi parametri).
  3. Aggiornare la pagina.
  4. Filtro da dcs nel debugger.
  5. Selezionare la richiesta dcs.gif (la chiamata di raccolta dati di Oracle Infinity).
  6. Visualizzare i parametri da inviare.

Visualizzazione della chiamata di raccolta dati di Oracle Infinity

Visualizzazione della chiamata di raccolta dati di Oracle Infinity

Passo 4: controllare che Oracle Infinity riceva i dati

È ora possibile controllare i dati disponibili in Oracle Infinity per i dati di acquisto in base ai parametri definiti nei fare clic su Chiamata in alto (ad esempio, data.wt.customer_id).

Altre risorse di apprendimento

Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti di apprendimento gratuito sul canale Oracle Learning YouTube. Inoltre, visitare education.oracle.com/learning-explorer per diventare Oracle Learning Explorer.

Per la documentazione del prodotto, visitare il sito Oracle Help Center.